营销#数据分析

Google Ads MCP:让智能体查广告账户和投放数据

Google Ads 官方 MCP:智能体通过 API 查账户、广告系列和效果数据,自带字段说明;只读不改,适合把投放复盘的拉数交给智能体。

项目与安装文档

查看项目

https://github.com/googleads/google-ads-mcp

投放复盘最花时间的是拉数:哪个广告系列花得多、转化差,哪个关键词该停,往往要在 Google Ads 后台导好几份报表再拼起来。Google Ads MCP 是 Google Ads API 团队(googleads 组织)维护的官方服务器,智能体直接用 API 查询账户数据,把拉数这一步交给它。截至 2026-10-06 约 1000 star。

能做什么

  • 查询账户数据:search 按 Google Ads 的查询语言取广告系列、广告组、关键词和效果指标。
  • 先读结构再查:get_resource_metadata 返回某类资源(比如 campaign)有哪些字段可查;资源 metrics、segments 列出可用的指标和细分维度,模型不用凭记忆猜字段名。
  • 多账户:list_accessible_customers 列出当前身份能访问的客户 ID;经理账户(MCC)下的子账户可通过 login_customer_id 访问。
  • 按需裁剪工具:用 tools_config.yaml 开关某类工具、改工具名前缀。

适合谁

  • 管几个 Google Ads 账户的投放优化师,想让智能体每周自动拉数、标出异常的广告系列。
  • 代理商的数据分析师,想用自然语言跨客户账户查效果。
  • 做营销工具的开发者,想让智能体对照真实的 API 结构写查询。

接入方式

需要 pipx、一个启用了 Google Ads API 的 Google Cloud 项目,以及带 adwords 范围的应用默认凭据;查询正式账户的开发者令牌至少要有 Explorer 访问级别。客户端配置:

{
  "mcpServers": {
    "google-ads-mcp": {
      "command": "pipx",
      "args": [
        "run",
        "--spec",
        "git+https://github.com/googleads/google-ads-mcp.git",
        "google-ads-mcp"
      ],
      "env": {
        "GOOGLE_APPLICATION_CREDENTIALS": "PATH_TO_CREDENTIALS_JSON",
        "GOOGLE_PROJECT_ID": "YOUR_PROJECT_ID",
        "GOOGLE_ADS_DEVELOPER_TOKEN": "YOUR_DEVELOPER_TOKEN"
      }
    }
  }
}

编辑点评

社区里管理 Google Ads 的 MCP 不少,有的还能直接改出价、建广告。我们选官方这个,正因为它目前只读:智能体只能查,不会误改预算,适合先把“拉数和分析”交出去。想让智能体动手改投放,就得另找工具并自担风险。门槛在前期:开发者令牌的申请和访问级别、OAuth 客户端、ADC 都要自己配好。README 也提醒,连上后你的广告数据会交给所接的模型,调用里还会附带一个用于统计使用情况的请求头。多人共用时,可以按 README 用 Podman 或 Cloud Run 跑成 HTTP 服务。许可证为 Apache-2.0。