/ 目录 / 演练场 / mcp-google-ads
● 官方 cohnen ⚡ 即开即用

mcp-google-ads

作者 cohnen · cohnen/mcp-google-ads

通过聊天在 Google Ads 账户上运行 GAQL——账户列表、campaign + 广告表现、自定义查询——支持 OAuth 或服务账户认证。

mcp-google-ads 是一个 Python MCP,可以与 Google Ads API 交互。五个核心能力:列出可访问账户、运行任意 GAQL、读取 campaign 表现、读取广告表现、运行自定义查询。需要 Google Ads Developer Token(1-3 个工作日批准)和 OAuth 或服务账户认证。

为什么要用

核心特性

实时演示

实际使用效果

google-ads.replay ▶ 就绪
0/0

安装

选择你的客户端

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "google-ads": {
      "command": "uvx",
      "args": [
        "mcp-google-ads"
      ],
      "_inferred": true
    }
  }
}

打开 Claude Desktop → Settings → Developer → Edit Config。保存后重启应用。

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "google-ads": {
      "command": "uvx",
      "args": [
        "mcp-google-ads"
      ],
      "_inferred": true
    }
  }
}

Cursor 使用与 Claude Desktop 相同的 mcpServers 格式。项目级配置优先于全局。

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "google-ads": {
      "command": "uvx",
      "args": [
        "mcp-google-ads"
      ],
      "_inferred": true
    }
  }
}

点击 Cline 侧栏中的 MCP Servers 图标,然后选 "Edit Configuration"。

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "google-ads": {
      "command": "uvx",
      "args": [
        "mcp-google-ads"
      ],
      "_inferred": true
    }
  }
}

格式与 Claude Desktop 相同。重启 Windsurf 生效。

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "google-ads",
      "command": "uvx",
      "args": [
        "mcp-google-ads"
      ]
    }
  ]
}

Continue 使用服务器对象数组,而非映射。

~/.config/zed/settings.json
{
  "context_servers": {
    "google-ads": {
      "command": {
        "path": "uvx",
        "args": [
          "mcp-google-ads"
        ]
      }
    }
  }
}

加入 context_servers。Zed 保存后热重载。

claude mcp add google-ads -- uvx mcp-google-ads

一行命令搞定。用 claude mcp list 验证,claude mcp remove 卸载。

使用场景

实战用法: mcp-google-ads

跨账户的每周 campaign 健康检查

👤 付费营销经理、代理商 ⏱ ~20 min intermediate

何时使用: 每周检查——哪些 campaign 因 CTR 低、CPA 高而烧钱?

前置条件
  • Google Ads Developer Token(已批准) — ads.google.com > Tools > API Center——1-3 个工作日
  • OAuth 客户端或有 Ads 访问权限的服务账户 — Google Cloud Console
步骤
  1. 列出账户
    列出我可以访问的所有 Google Ads 账户。✓ 已复制
    → MCC + 子账户
  2. 拉取表现数据
    对每个账户,拉取过去 7 天的数据:campaign 名称、成本、点击、转化、CPA。标记 CPA > $100 的 campaign。✓ 已复制
    → 排序的热点列表
  3. 提出行动方案
    对表现最差的 3 个 campaign,根据数据建议:暂停、降低出价或深入调查。✓ 已复制
    → 行动计划

结果: 几分钟内完成每周热点评审。

注意事项
  • 归因窗口因转化动作而异 — 包含 segments.conversion_action_name 并分别检查每个
搭配使用: notion

挖掘搜索词以识别否定关键词

👤 效果营销人员 ⏱ ~15 min intermediate

何时使用: 定期账户卫生——在浪费性查询累积之前抓住它们。

步骤
  1. 拉取搜索词
    GAQL:过去 30 天的 search_term_view,列:[search_term, campaign, cost, conversions]。Cost > $10 且 conversions = 0。✓ 已复制
    → 浪费性查询列表
  2. 分组和推荐
    按重复短语分组。建议在账户或 campaign 级别添加的否定关键词。✓ 已复制
    → 带有级别的否定列表

结果: 整洁的否定关键词列表可供应用。

注意事项
  • 宽泛匹配否定词可能会阻止合法流量 — 先使用精确或短语否定词;只有非常确定时才使用宽泛

审计 campaign 内广告文案表现

👤 文案撰写者、PPC 负责人 ⏱ ~15 min intermediate

何时使用: 你发布了 3 个响应式广告,想知道哪些组合表现最好。

步骤
  1. 拉取广告统计数据
    对于 campaign X,列出所有广告 + 它们的 30 天 CTR + 转化率。按转化率降序排序。✓ 已复制
    → 广告表现排名
  2. 提出建议
    哪些模式区分表现最好的广告文案?我应该迭代什么?✓ 已复制
    → 文案洞察

结果: 数据驱动的创意迭代。

注意事项
  • 低流量广告因方差而看起来比实际情况更差 — 在比较费率前需要至少 100 次展示

组合

与其他 MCP 搭配,撬动十倍杠杆

google-ads + notion

每周营销摘要

拉取上周的 Google Ads 表现 + 最大的赢利/损失;在 'Marketing Weekly' 中创建 Notion 页面。✓ 已复制
google-ads + postgres

将 Google Ads 数据与你的数据库连接以获得完整漏斗视图

从 Google Ads 获取 campaign X 的转化计数。查询数据库以获取来自该 campaign 的实际已成交交易。✓ 已复制

工具

此 MCP 暴露的能力

工具输入参数何时调用成本
list_accessible_accounts 发现账户图 1 API call
run_gaql customer_id, query: str 任何自定义报告 1 API call
campaign_performance customer_id, date_range 快速 campaign 摘要 1 API call
ad_performance customer_id, campaign_id?, date_range 创意审计 1 API call

成本与限制

运行它的成本

API 配额
Google Ads API:慷慨的每日配额;每 QPS 受速率限制
每次调用 Token 数
结果严重依赖日期范围和分段——限制行数
费用
API 是免费的;你单独为广告付费
提示
始终在 GAQL 中包含日期范围。不带 LIMIT 运行可能返回 100k 行。

安全

权限、密钥、影响范围

最小权限: 在可能的情况下对 Ads 账户仅读
凭据存储: 服务账户 JSON 或 OAuth 刷新令牌——环境变量或密钥管理器
数据出站: 表现数据发送到你的 LLM 提供商
切勿授予: 不要向做超过读操作的代理授予 Ads 账户的 Admin 权限

故障排查

常见错误与修复

AUTHENTICATION_ERROR 或 PERMISSION_DENIED

服务账户电子邮件未添加到 MCC 访问权限,或 developer_token 不正确。检查 ads.google.com > Access & Security。

分段指标过多

GAQL 对哪些指标可以与哪些分段组合有限制。查询更简单的子集。

验证: Read the GAQL compatibility table
测试令牌配额已超过

申请生产令牌;在此之前,在低查询频率的小账户上测试。

替代方案

mcp-google-ads 对比其他方案

替代方案何时用它替代权衡
Google Ads UI / Editor你只是偶尔拉取报告手动;无 LLM 洞察
Meta Ads MCP你也运行 Meta 广告不同的平台;自有认证

更多

资源

📖 阅读 GitHub 上的官方 README

🐙 查看未解决的 issue

🔍 浏览全部 400+ MCP 服务器和 Skills