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。