Google Ads Analyzer

谷歌广告分析器克劳德代码

克劳德代码技能+MCP服务器设置，用于专家级谷歌广告活动分析。包括GAQL查询模板、质量分数诊断、智能竞价评估、Performance Max深度挖掘和12个参考文档。

它的作用

安装后，Claude Code可以：

阅读并分析：

• 使用GAQL（Google Ads查询语言）直接查询您的Google Ads帐户
• 分析活动、广告组、关键字和搜索词的表现
• 诊断组件级别的质量分数问题（预期点击率、广告相关性、登录页面）
• 评估印象份额，以确定预算与排名机会
• 评估智能投标绩效和学习状态
• 深度挖掘Performance Max活动（资产组、广告强度、蚕食）
• 审查搜索词报告，找出负面关键字差距
• 生成具有优先建议的结构化分析报告

编写和管理：

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

组件

先决条件

• 克劳德代码 安装
• python 3.8+
• 紫外线 （Python包管理器——MCP服务器通过 uvx)
• Google Ads帐户（带有开发者令牌）
• 启用了Google Ads API的Google云项目

安装

第一步：安装技能

复制 skill/ 将文件夹放入您的Claude Code项目中：

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

该技能现在处于活动状态。当你询问谷歌广告分析时，克劳德会自动使用它。

第二步：建立谷歌云项目

1. 首选 谷歌云控制台
2. 创建新项目（或使用现有项目）
3. 启用 谷歌广告API:

- 转到API和服务→ 图书馆 - 搜索“Google Ads API” - 单击启用

1. 创建一个 OAuth 2.0客户端ID:

- 转到API和服务→ 凭证 - 点击“创建凭据”→ OAuth客户端ID - 应用程序类型： 桌面应用 - 下载JSON文件

步骤3：获取开发者代币

这是访问Google Ads API所必需的。它与OAuth凭据是分开的。

1. 登录您的Google广告 经理账户 （MCC）
2. 转到“工具和设置”→ 设置→ API中心
3. 您的开发者令牌显示在那里
4. 如果您没有，请申请访问权限（测试帐户立即获得批准）

令牌访问级别：

• 测试帐户： 即时批准，仅适用于测试广告帐户
• 基本访问权限： 需要申请审核，适用于真实账户
• 标准访问： 更高的费率限制，需要额外审查

对于大多数用例，基本访问就足够了。审查过程需要几个工作日。

步骤4：运行安装脚本

cd scripts/

# Place your downloaded OAuth client JSON in this folder
# (or point to it when prompted)

python3 setup.py

脚本将：

1. 询问您的OAuth客户端JSON路径
2. 请求您的开发者令牌
3. 询问您的登录客户ID（MCC ID，可选）
4. 打开浏览器进行Google OAuth授权
5. 生成 credentials.json 和 .env.google-ads
6. 配置 .mcp.json 克劳德代码
7. 测试连接

步骤5：验证

重新启动Claude Code，然后问：

“列出我的Google Ads帐户”

Claude应该连接到您的帐户并显示可用帐户。

用法示例

安装后，您可以向Claude询问以下问题：

分析：

• “分析我过去30天的谷歌广告活动”
• “我的质量分数在关键字中的分布是什么？”
• “给我看看印象份额细分——我是在预算还是排名上输了？”
• “查看我的搜索词并建议负面关键字”
• “我的智能竞价策略是否在目标范围内？”
• “深入了解我的Performance Max活动”
• “比较所有活动的本月与上月”
• “哪些竞选活动的浪费支出最高？”

管理层：

• “暂停活动X”
• “将这些负面关键字添加到我的搜索活动中：\[list\]”
• “将活动Y的每日预算增加到100美元”
• “将活动Z切换为目标ROAS为4倍”

您还可以从Google Ads UI共享屏幕截图或导出数据——该技能适用于任何数据格式。

参考文件中有什么

故障排除

许可证

麻省理工学院