谷歌广告分析器克劳德代码
克劳德代码技能+MCP服务器设置，用于专家级谷歌广告活动分析。包括GAQL查询模板、质量分数诊断、智能竞价评估、Performance Max深度挖掘和12个参考文档。
它的作用
安装后，Claude Code可以：
阅读并分析：
- 使用GAQL（Google Ads查询语言）直接查询您的Google Ads帐户
- 分析活动、广告组、关键字和搜索词的表现
- 诊断组件级别的质量分数问题（预期点击率、广告相关性、登录页面）
- 评估印象份额，以确定预算与排名机会
- 评估智能投标绩效和学习状态
- 深度挖掘Performance Max活动（资产组、广告强度、蚕食）
- 审查搜索词报告，找出负面关键字差距
- 生成具有优先建议的结构化分析报告
编写和管理：
- 在广告系列中添加负面关键字（广泛、短语或完全匹配）
- 暂停或启用活动、广告组和单个广告
- 更新每日预算
- 更改竞价策略（目标CPA、目标ROAS、最大化转化率、最大化转换价值）
组件
| 组件 | 它的作用 |
|---|---|
技能 (skill/) | Claude作为上下文加载的包含12个参考文档的分析框架 |
| MCP服务器 | 叉子 google-ads-mcp 有6个写作工具-将Claude Code连接到Google Ads API，用于阅读和管理活动 |
脚本 (scripts/) | OAuth设置帮助程序 |
先决条件
安装
第一步：安装技能
复制 skill/ 将文件夹放入您的Claude Code项目中：
# From your Claude Code project root
mkdir -p .claude/skills/google-ads-analyzer
cp -r skill/* .claude/skills/google-ads-analyzer/该技能现在处于活动状态。当你询问谷歌广告分析时，克劳德会自动使用它。
第二步：建立谷歌云项目
- 首选 谷歌云控制台
- 创建新项目（或使用现有项目）
- 启用 谷歌广告API:
- 转到API和服务→ 图书馆 - 搜索“Google Ads API” - 单击启用
- 创建一个 OAuth 2.0客户端ID:
- 转到API和服务→ 凭证 - 点击“创建凭据”→ OAuth客户端ID - 应用程序类型： 桌面应用 - 下载JSON文件
步骤3：获取开发者代币
这是访问Google Ads API所必需的。它与OAuth凭据是分开的。
- 登录您的Google广告 经理账户 （MCC）
- 转到“工具和设置”→ 设置→ API中心
- 您的开发者令牌显示在那里
- 如果您没有，请申请访问权限（测试帐户立即获得批准）
令牌访问级别：
- 测试帐户： 即时批准，仅适用于测试广告帐户
- 基本访问权限： 需要申请审核，适用于真实账户
- 标准访问： 更高的费率限制，需要额外审查
对于大多数用例，基本访问就足够了。审查过程需要几个工作日。
步骤4：运行安装脚本
cd scripts/
# Place your downloaded OAuth client JSON in this folder
# (or point to it when prompted)
python3 setup.py脚本将：
- 询问您的OAuth客户端JSON路径
- 请求您的开发者令牌
- 询问您的登录客户ID（MCC ID，可选）
- 打开浏览器进行Google OAuth授权
- 生成
credentials.json和.env.google-ads - 配置
.mcp.json克劳德代码 - 测试连接
步骤5：验证
重新启动Claude Code，然后问：
“列出我的Google Ads帐户”
Claude应该连接到您的帐户并显示可用帐户。
用法示例
安装后，您可以向Claude询问以下问题：
分析：
- “分析我过去30天的谷歌广告活动”
- “我的质量分数在关键字中的分布是什么？”
- “给我看看印象份额细分——我是在预算还是排名上输了？”
- “查看我的搜索词并建议负面关键字”
- “我的智能竞价策略是否在目标范围内？”
- “深入了解我的Performance Max活动”
- “比较所有活动的本月与上月”
- “哪些竞选活动的浪费支出最高？”
管理层：
- “暂停活动X”
- “将这些负面关键字添加到我的搜索活动中：\[list\]”
- “将活动Y的每日预算增加到100美元”
- “将活动Z切换为目标ROAS为4倍”
您还可以从Google Ads UI共享屏幕截图或导出数据——该技能适用于任何数据格式。
参考文件中有什么
| 文档 | 封面 |
|---|---|
core_concepts.md | 广告排名、质量评分、智能竞价、PMax、GAQL概述 |
gaql_queries.md | 为每个分析步骤准备好使用GAQL查询 |
quality_score.md | 3个组件，按组件诊断，优先级 |
impression_share.md | 因预算与排名、拍卖见解而丢失 |
smart_bidding.md | tCPA、tROAS、学习期、何时干预 |
performance_max.md | 资产组、信号、饲料质量、蚕食 |
conversion_tracking.md | 类型、数字检测器阵列、转换滞后、主要与次要 |
account_structure.md | MCC层次结构、命名、品牌与非品牌 |
search_terms_negatives.md | 搜索词报告、匹配类型、否定关键字 |
ad_copy_rsa.md | RSA标题、描述、广告强度、资产标签 |
segmentation.md | GAQL细分：设备、地理、每周一天、受众 |
performance_fluctuations.md | 正常与相关变化，转换滞后陷阱 |
故障排除
| 错误 | 原因 | 修复 |
|---|---|---|
UNAUTHENTICATED | 刷新令牌已撤销或过期 | 运行 python3 scripts/setup.py 再一次 |
PERMISSION_DENIED | 开发者代币未审批或账号错误 | 在API中心查看代币状态；验证登录客户ID |
DEVELOPER_TOKEN_NOT_APPROVED | 令牌仍处于测试模式 | 在API中心申请基本访问 |
INVALID_CUSTOMER_ID | 客户ID格式错误 | 使用不带破折号的10位ID |
| MCP未连接 | 配置或凭据问题 | 验证 .mcp.json 路径正确；重新启动克劳德代码 |
| 未返回数据 | 日期范围错误或没有活动活动 | 检查 campaign.status = 'ENABLED'；调整日期范围 |
许可证
麻省理工学院