Google Ads Mcp

google-ads-mcp

用于 Google Ads 的 MCP 服务——通过 Claude 诊断支出效率、展示份额和素材效果。

提供 22 种工具，覆盖广告系列、关键字、RSA、素材、受众、地域／设备细分、展示份额、竞价洞察和预算进度，另附原始 GAQL 查询入口。专为需要实际诊断问题的 B2B 付费搜索团队和代理商打造，而不只是回答“列出我的广告系列”这类仪表板式查询。

---

为什么要开发它

大多数 Google Ads MCP 服务止步于“列出广告系列＋基本指标”。这个服务关注的是付费搜索团队真正会问的问题：哪些 RSA 素材被标记为 LOW，应该替换？、哪些关键字消耗了预算却没有带来转化？、在竞价洞察中，我的展示份额被谁抢走了？、移动设备与桌面设备的 CPA 差距有多大？、*哪些广告系列目前受预算限制？*这些都是改善表现的关键手段，而这里都将它们作为一流工具提供。

与官方的 googleads/google-ads-mcp 不同：本服务提供 RSA 素材效果标签、竞价洞察、展示份额分析、地域／设备细分、受众定位检查和预算进度。

---

示例提示词

安装后，可以向 Claude 询问：

• “本月我的展示份额与竞争对手相比如何？我最常输给谁？”
• “显示所有效果标签为 LOW 的 RSA 素材，以便我替换它们。”
• “过去 30 天里，哪些关键字的支出最高但没有带来任何转化？”
• “所有广告系列中，移动设备与桌面设备的 CPA 差异有多大？”
• “目前有广告系列受预算限制吗？显示 Lost IS (Budget)。”
• “列出我的再营销受众，并告诉我哪些受众规模足以用于搜索定位。”

---

演示

🎥 演示视频即将推出——展示如何在 60 秒内通过 Claude 诊断浪费的广告支出。

---

功能

类别	工具
账户	列出账户、账户信息
广告系列	列出广告系列、广告系列效果、广告组效果
关键字	关键字效果、搜索字词报告
转化	按广告系列查看转化、列出转化操作
广告文案／RSA	列出含 Ad Strength 的 RSA、RSA 素材效果标签
素材／扩展信息	列出账户素材、广告系列素材
受众	列出用户列表、广告系列受众定位
效果	地域效果、设备效果、展示份额、竞价洞察
预算	列出预算、预算进度
查询入口	原始 GAQL 查询

---

前提条件

• Node.js 20+
• Google Ads Developer Token（在此申请）
• Google Cloud Console 中的 OAuth 2.0 凭据（Client ID＋Secret）
• 具有 https://www.googleapis.com/auth/adwords 范围的 refresh token

---

环境变量

变量	必需	描述
GOOGLE_ADS_DEVELOPER_TOKEN	是	你的 Google Ads 开发者令牌
GOOGLE_ADS_CLIENT_ID	是	OAuth 2.0 客户端 ID
GOOGLE_ADS_CLIENT_SECRET	是	OAuth 2.0 客户端密钥
GOOGLE_ADS_REFRESH_TOKEN	是	OAuth 2.0 refresh token
GOOGLE_ADS_CUSTOMER_ID	是*	默认客户 ID（不含连字符）。可在每次工具调用时覆盖。
GOOGLE_ADS_LOGIN_CUSTOMER_ID	否	用于 MCC 访问的经理账户 ID

---

用法

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "google-ads": {
      "command": "npx",
      "args": ["-y", "google-ads-mcp"],
      "env": {
        "GOOGLE_ADS_DEVELOPER_TOKEN": "YOUR_TOKEN",
        "GOOGLE_ADS_CLIENT_ID": "YOUR_CLIENT_ID",
        "GOOGLE_ADS_CLIENT_SECRET": "YOUR_CLIENT_SECRET",
        "GOOGLE_ADS_REFRESH_TOKEN": "YOUR_REFRESH_TOKEN",
        "GOOGLE_ADS_CUSTOMER_ID": "1234567890"
      }
    }
  }
}

Claude Code

{
  "mcpServers": {
    "google-ads": {
      "command": "node",
      "args": ["/path/to/google-ads-mcp/dist/index.js"],
      "env": {
        "GOOGLE_ADS_DEVELOPER_TOKEN": "YOUR_TOKEN",
        "GOOGLE_ADS_CLIENT_ID": "YOUR_CLIENT_ID",
        "GOOGLE_ADS_CLIENT_SECRET": "YOUR_CLIENT_SECRET",
        "GOOGLE_ADS_REFRESH_TOKEN": "YOUR_REFRESH_TOKEN",
        "GOOGLE_ADS_CUSTOMER_ID": "1234567890"
      }
    }
  }
}

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "google-ads": {
      "command": "npx",
      "args": ["-y", "google-ads-mcp"],
      "env": {
        "GOOGLE_ADS_DEVELOPER_TOKEN": "YOUR_TOKEN",
        "GOOGLE_ADS_CLIENT_ID": "YOUR_CLIENT_ID",
        "GOOGLE_ADS_CLIENT_SECRET": "YOUR_CLIENT_SECRET",
        "GOOGLE_ADS_REFRESH_TOKEN": "YOUR_REFRESH_TOKEN",
        "GOOGLE_ADS_CUSTOMER_ID": "1234567890"
      }
    }
  }
}

Docker

docker build -t google-ads-mcp .
docker run --rm \
  -e GOOGLE_ADS_DEVELOPER_TOKEN=YOUR_TOKEN \
  -e GOOGLE_ADS_CLIENT_ID=YOUR_CLIENT_ID \
  -e GOOGLE_ADS_CLIENT_SECRET=YOUR_CLIENT_SECRET \
  -e GOOGLE_ADS_REFRESH_TOKEN=YOUR_REFRESH_TOKEN \
  -e GOOGLE_ADS_CUSTOMER_ID=1234567890 \
  google-ads-mcp

---

工具参考

工具	描述
gads_run_gaql	运行任意原始 GAQL 查询——用于自定义报告的备用方案
gads_list_accounts	列出所有可访问的 Google Ads 账户
gads_account_info	名称、币种、时区、经理标记、状态
gads_list_campaigns	包含状态、渠道类型和出价策略的广告系列
gads_campaign_performance	展示次数、点击次数、CTR、CPC、费用、转化次数、CPA、ROAS
gads_ad_group_performance	包含广告系列上下文的广告组指标
gads_keyword_performance	包含匹配类型、质量得分、费用和转化次数的关键字
gads_search_terms_report	触发广告的实际用户查询——查找否定关键字和机会
gads_conversions_by_campaign	每个广告系列的转化次数 × 转化操作
gads_list_conversion_actions	所有转化操作及其类别、类型和计数方法
gads_list_rsas	RSA 及其所有标题、描述、广告效力和审核状态
gads_rsa_asset_performance	每项素材资源的效果标签：BEST / GOOD / LOW / PENDING / LEARNING
gads_list_assets	账户素材资源：附加链接、宣传信息、结构化摘要、图片
gads_campaign_assets	与广告系列关联的素材资源及其字段类型
gads_list_audiences	用户列表（再营销、客户匹配）及其规模和匹配率
gads_campaign_audience_targeting	广告系列中的受众群体及出价调整系数和包含/排除设置
gads_geo_performance	按国家、地区和城市划分的效果
gads_device_performance	按 MOBILE / DESKTOP / TABLET 划分的费用、转化次数和 CPA
gads_impression_share	每个广告系列的搜索展示份额、因预算损失的展示份额、因排名损失的展示份额
gads_auction_insights	与竞争对手相比的展示份额、重叠率和排名超越率
gads_list_budgets	所有预算：金额、投放方式、周期、建议预算
gads_budget_pacing	每个广告系列的费用与预算对比及使用率 %

---

从源代码构建

git clone https://github.com/ZLeventer/google-ads-mcp.git
cd google-ads-mcp
npm install
npm run build

---

许可证

MIT — Copyright (c) 2026 Zach Leventer