SkillsScout
INTEGRATION-WORKFLOW ／ 集成与工作流自动化

google-ads-api-mcp-setup-google-skills

收录日期 2026-09-03·来源仓库 ↗
受欢迎程度
7
可用程度与相关性
8
安全性
8
7.7SCOUT SCORE

1. 基本信息

项目 内容
名称 google-ads-api-mcp-setup-google-skills
作者/维护者 Google（google-ads-api-team，google/skills 官方合集仓库）
来源链接 https://github.com/google/skills/tree/main/skills/ads/google-ads-api-mcp-setup
许可证 Apache-2.0（数据来自 GitHub API，为 google/skills 仓库整体许可）
GitHub Stars/Forks 所属合集仓库 google/skills 整体 19,340 / 1,553（数据来自 GitHub API）；该数字属整个合集，不代表本技能自身热度
最新版本 SKILL.md 元数据标注 version 1.0
安装方式 复制 SKILL.md 到 agent 的 skills 目录即可使用；配套的 Google Ads MCP Server 需另行通过 pipx 安装

2. 功能介绍与亮点

本技能是一份面向 AI 编程助手的完整操作手册，指导用户从零开始安装、配置并接通官方开源的 Google Ads MCP Server，最终让 Claude Code、Cursor、Antigravity 等工具能用自然语言直接查询、诊断用户自己的 Google Ads 广告账户数据，而不需要手写 API 调用代码。

内容覆盖完整链路六个阶段：① 校验 5 项 OAuth2 凭据（开发者令牌、客户端 ID/密钥、刷新令牌、账户 ID）；② 检测并安装 Python 3.12+ 与 pipx；③ 通过 pipx 安装 MCP Server 本体；④ 配置凭据环境变量，并明确提醒不要把凭据硬编码进源码；⑤ 分别给出 Claude Desktop/Claude Code、Cursor、Antigravity 三种工具的具体接入步骤；⑥ 可选的 Google Cloud Run 云端部署方案，以及验证测试与常见故障排查（PATH 问题、鉴权失败等）。

亮点：官方 Google 出品；配套的 MCP Server 本体是独立的 Google 官方仓库 googleads/google-ads-mcp，被收录进 Google 官方开发者文档站，仓库 issue 区亦有真实使用反馈（详见第 9 节），说明已被实际使用。

3. 适用场景

所属分类：集成与工作流自动化

适用于需要把 Google Ads 广告数据接入 AI 工作流的场景：广告运营或增长团队希望直接用自然语言让 AI 编程助手查询战役表现、关键词报告等数据；开发者希望在自己的 agent 工作流中集成 Google Ads 账户操作能力，而无需自行封装 API 调用逻辑。受益人群为使用 Claude Code / Cursor / Antigravity 等工具的 Google Ads 广告主与营销技术开发者。

4. 跨 Agent 兼容性

Agent 结论 依据
Claude Code 原生支持 SKILL.md 显式给出 Claude Desktop / Claude Code CLI 的配置文件路径（macOS/Windows/Linux）与完整 JSON 配置示例
Codex 需适配 该技能依赖本地安装的 MCP Server 进程及出站网络（连接 Google Ads API 与 PyPI），Codex CLI 默认沙箱不开放网络访问，需手动放开权限后才能完成安装与鉴权
OpenClaw 需适配 OpenClaw 原生支持在配置文件（如 openclaw.json 的 mcp.servers）中添加自定义 stdio 类 MCP 服务器，但 SKILL.md 未给出 OpenClaw 专属示例，需用户参照通用 MCP 配置格式自行改写
Hermes Agent 未验证 未找到该运行时对接自定义 MCP 服务器的公开资料

5. 推荐理由

这是当前索引中少见的“把一个官方 MCP Server 完整接入多个主流 AI 编程工具”的范例：内容详实、官方背书、且配套服务器本体有真实活跃的开源社区支撑。对需要用自然语言查询、管理 Google Ads 账户的开发者与营销技术团队而言，能显著降低从零对接 API 的门槛。

6. 评分

维度 分数 说明
受欢迎程度 7 官方出品：Google 发布，服务于 Google 自家的 Google Ads 产品；所属母仓库 19,340 星属于整个合集，不代表本技能自身热度，子技能自身暂无独立第三方星数/讨论数据
可用性 8 462 行内容详尽（凭据校验、依赖安装、多工具集成、可选云部署、故障排查全覆盖），但需用户具备 Google Ads API 开发者权限并完成四项 OAuth2 凭据配置，非一键即用；母仓库 2026-09-02 仍有推送，维护活跃
安全性 8 见下方检查清单

安全检查清单：① shell 命令执行——有，范围限定在包管理器安装（pipx/python）与可选的 Docker/gcloud 部署命令，均附用途说明；② 联网外发——有，目标透明（Google Ads API 官方端点、PyPI/GitHub 官方源）；③ 凭据存储——需 5 项 OAuth2 凭据，提供两种存储方式（MCP 客户端独立配置文件或环境变量），并明确提示不要硬编码进源码；④ 可疑指令——未发现 prompt injection 或夹带私货迹象；⑤ 作者信誉——Google 官方团队；⑥ License——Apache-2.0，明确；⑦ 维护时间——配套 MCP Server 仓库 2026-08-26 仍有提交，母仓库 2026-09-02 有推送。扣分原因：存在真实 shell 执行与凭据配置环节，非纯提示词/模板类技能。

7. 跟同类 Skills 相比的优势

技能 定位 与本技能的差异
google-ads-api-quickstart（同合集） 指导通过 Python/Java/PHP/Node.js 等官方客户端库直接调用 Google Ads API 需要用户自己写代码调用 API；本技能则是让 AI 助手通过 MCP 协议直接对话式操作账户，无需自行编码
第三方 Google Ads MCP 实现（如 gomarble-ai/google-ads-mcp-server 等社区版本） 同样提供 Google Ads 的 MCP 服务器 非 Google 官方维护，缺少配套的多工具（Claude/Cursor/Antigravity）接入指南与故障排查文档，可信度与文档完整度不及本技能

8. 用户评价

该技能目前在第三方平台尚无具名用户评价。

9. 其他补充

配套的 Google Ads MCP Server 本体（googleads/google-ads-mcp）是独立的 Google 官方开源仓库，Apache-2.0 许可，目前 911 stars / 267 forks，GitHub issue 区有 31 条讨论记录真实使用中遇到的问题（如参数校验、云端鉴权场景），且该服务器已被收录进 Google 官方开发者文档站。当前该 MCP Server 提供 10 个核心工具，官方路线图计划扩展到 161 个，覆盖面仍在持续增长。

10. 安装使用方式

  1. 将 SKILL.md 复制到 Claude Code / Claude Desktop 的 skills 目录
  2. 安装 Google Ads MCP Server 本体：pipx install google-ads-mcp（PyPI 官方发布），或从源码安装最新开发版：pipx install git+https://github.com/googleads/google-ads-mcp.git
  3. 在 Google Ads API 后台与 Google Cloud Console 获取 5 项凭据：开发者令牌、OAuth 客户端 ID/密钥、刷新令牌、客户账户 ID
  4. 按工具类型选择配置方式：Claude Desktop/Code 编辑 claude_desktop_config.json；Cursor 在设置的 MCP 面板中新建服务器；Antigravity 在终端/IDE 环境中导出对应环境变量
  5. 可选：部署到 Google Cloud Run 作为远程 MCP 服务

安装后注意事项：完成配置后需重启或重新加载对应 AI 工具以加载新的 MCP Server；后续在对话中用自然语言询问广告账户或报表数据，工具会自动调用已配置的 MCP 工具完成查询。

11. 注意事项