一个Claude Code技能+MCP服务器搭建，用于专家级的谷歌广告广告活动分析。包含GAQL查询模板、质量评分诊断、智能竞价评估、性能极限深度分析和12份参考文档。

它的作用

安装后，Claude Code 可以：

阅读并分析：

• 直接使用GAQL（谷歌广告查询语言）查询您的谷歌广告账户
• 分析广告活动、广告组、关键词和搜索词的表现
• 在组件层面诊断质量评分问题（预期点击率、广告相关性、着陆页）
• 评估展示份额以识别预算与排名机会
• 评估智能竞价的表现和学习状态
• 深入分析绩效最大化活动（资产组、广告强度、蚕食）
• 审查搜索词报告并识别负面关键词空白
• 生成带有优先级建议的结构化分析报告

写作与管理：

• 在广告活动中添加负面关键词（广泛、短语或完全匹配）
• 暂停或启用活动、广告组和单个广告
• 更新每日预算
• 调整竞价策略（目标CPA、目标ROAS、最大化转化、最大化转化价值）

组成部分

Google Ads Analyzer for Claude Code

A Claude Code skill + MCP server setup for expert-level Google Ads campaign analysis. Includes GAQL query templates, Quality Score diagnostics, Smart Bidding evaluation, Performance Max deep dives, and 12 reference documents.

What It Does

When installed, Claude Code can:

Read & Analyze:

• Query your Google Ads accounts directly using GAQL (Google Ads Query Language)
• Analyze campaign, ad group, keyword, and search term performance
• Diagnose Quality Score issues at the component level (expected CTR, ad relevance, landing page)
• Evaluate Impression Share to identify budget vs rank opportunities
• Assess Smart Bidding performance and learning status
• Deep dive Performance Max campaigns (asset groups, ad strength, cannibalization)
• Review search term reports and identify negative keyword gaps
• Generate structured analysis reports with prioritized recommendations

Write & Manage:

• Add negative keywords to campaigns (Broad, Phrase, or Exact match)
• Pause or enable campaigns, ad groups, and individual ads
• Update daily budgets
• Change bidding strategies (Target CPA, Target ROAS, Maximize Conversions, Maximize Conversion Value)

Components

Prerequisites

• Claude Code installed
• Python 3.8+
• uv (Python package manager — the MCP server runs via uvx)
• A Google Ads account (with a Developer Token)
• A Google Cloud project with the Google Ads API enabled

Installation

Step 1: Install the Skill

Copy the skill/ folder into your Claude Code project:

# From your Claude Code project root
mkdir -p .claude/skills/google-ads-analyzer
cp -r skill/* .claude/skills/google-ads-analyzer/

The skill is now active. Claude will automatically use it when you ask about Google Ads analysis.

Step 2: Set Up a Google Cloud Project

1. Go to Google Cloud Console
2. Create a new project (or use an existing one)
3. Enable the Google Ads API:
   • Go to APIs & Services → Library
   • Search for “Google Ads API”
   • Click Enable
4. Create an OAuth 2.0 Client ID:
   • Go to APIs & Services → Credentials
   • Click “Create Credentials” → OAuth Client ID
   • Application type: Desktop app
   • Download the JSON file

Step 3: Get a Developer Token

This is required to access the Google Ads API. It’s separate from OAuth credentials.

1. Sign in to your Google Ads manager account (MCC)
2. Go to Tools & Settings → Setup → API Center