AI导哈

Google Ads管理工具

一个独立的MCP服务器，提供42种Google Ads工具，用于与Claude Desktop、Cursor或任何兼容MCP的AI客户端一起使用。

  • by RoyAzran
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 RoyAzran/google-ads-mcp-server

使用说明

谷歌广告MCP服务器

一个独立的MCP服务器，它公开 42个谷歌广告工具 适用于Claude Desktop、Cursor或任何兼容MCP的AI客户端。

工具

分析（阅读）

工具 说明
get_gads_overview 账户级指标汇总
get_gads_campaigns 活动绩效列表
get_gads_keywords 带有出价和QS的热门关键词
get_gads_search_terms 触发广告的实际搜索词
get_gads_ad_groups 广告群表现
get_gads_daily_trend 日复一日的消费、点击、转化
get_gads_ads 个人广告创意表现
get_gads_geo 地理性能
get_gads_device_breakdown 台式机vs手机vs平板电脑
get_gads_hourly_trend 一周中的小时和天性能
get_gads_audiences 观众细分表现
get_gads_extensions Sitelink、callout、呼叫分机性能
get_gads_shopping 购物产品性能
get_gads_pmax 性能最大资产组结果
get_keyword_ideas 关键词规划师——数量、竞争、出价
gads_get_demographics 按性别和年龄段分列的业绩
gads_get_landing_pages 登录页面性能
gads_get_paid_organic 付费与有机重叠
gads_get_bidding_strategies 列出投资组合投标策略
gads_get_asset_report PMax资产绩效标签
gads_list_customer_accounts 列出所有MCC可访问的帐户
gads_get_billing_info 账户账单状态
gads_get_change_history 最近的帐户更改事件
gads_get_recommendations 谷歌的优化建议
gads_get_conversion_actions 列出所有跟踪的转换
gads_get_label_performance 按标签分组的性能

管理（写作）

工具 说明
gads_update_status 暂停或启用活动/广告组
gads_update_budget 更改活动预算
gads_create_campaign 使用预算创建搜索活动
gads_create_ad_group 创建广告组
gads_add_keywords 将关键字添加到广告组
gads_add_negative_keywords 添加负面关键字
gads_create_responsive_search_ad 创建响应式搜索广告
gads_update_keyword_bid 更新关键字的CPC出价
gads_apply_recommendation 应用推荐
gads_update_ad 暂停/启用/删除单个广告
gads_create_sitelink 将网站链接资产添加到活动中
gads_create_conversion_action 创建新的转换操作
gads_create_label 创建标签
gads_apply_label 将标签应用于活动/广告组
gads_duplicate_campaign 复制现有活动
gads_get_keyword_forecast 预测展示次数/点击次数/成本

设置

步骤1——安装依赖项

pip install -r requirements.txt

第二步——获取谷歌广告开发者代币

开发者令牌通过Google Ads API识别您的应用程序。它是 与OAuth凭据分开.

  1. 登录到…… ads.google.com --你需要一个 经理（MCC）账户
  2. 在顶部导航中单击 工具和设置 （扳手图标）
  3. 在...之下 设置，单击 API中心
  4. 接受Google Ads API服务条款
  5. 你的 开发者令牌 显示--复制它

初始访问级别为 测试账号 -您可以进行API调用，但只能针对测试帐户。要对真实帐户使用API，请单击 申请基本访问权限 并填写表格。谷歌通常会在几天内批准。

GOOGLE_ADS_DEVELOPER_TOKEN=AbCdEfGhIjKlMnOp12345678

步骤3——创建Google Cloud项目和OAuth 2.0凭据

这给了你 GOOGLE_CLIENT_ID 和 GOOGLE_CLIENT_SECRET.

  1. 首选 console.cloud.google.com
  2. 单击顶部的项目下拉列表→ 新项目 → 给它起个名字→ 创建
  3. 选择新项目后，转到 API和服务→ 图书馆
  4. 搜索 谷歌广告API -如果您看到它，您可以选择启用它（这里使用的REST API并不严格要求这样做，但它在控制台中启用配额跟踪）
  5. 首选 API和服务→ OAuth 授权界面
    • 用户类型： 外部的 → 创建
    • 填写 应用名称 （例如。 Ads MCP), 支持邮箱, 开发人员电子邮件 → 保存并继续
    • 在“范围”步骤中，单击 添加或删除作用域 → 搜索 adwords → 选择 https://www.googleapis.com/auth/adwords → 更新 → 保存并继续
    • 在“测试用户”步骤中，添加您自己的谷歌电子邮件→ 保存并继续
  6. 首选 API和服务→ 凭证
  7. 点击 +创建凭据→ OAuth 2.0客户端ID
    • 应用程序类型： 桌面应用程序
    • 名称：任何事物（例如。 Ads MCP client)
    • 点击 创建
  8. 复制 客户端ID 和 客户端密钥 显示在对话框中
GOOGLE_CLIENT_ID=123456789-abc.apps.googleusercontent.com
GOOGLE_CLIENT_SECRET=GOCSPX-xxxxxxxxxxxxxxxxxxxx

步骤4--获取刷新令牌

运行附带的辅助脚本。它打开一个浏览器，您使用有权访问您的Google Ads帐户的Google帐户登录，并打印您的刷新令牌。

python get_token.py

如果浏览器没有自动打开，请复制终端中打印的URL并手动粘贴。
请确保您使用登录 相同的Google帐户 它链接到您的Google Ads帐户。

复制打印值：

GOOGLE_REFRESH_TOKEN=1//0gxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

步骤5--查找您的客户ID

GOOGLE_ADS_CUSTOMER_ID --您要查询的广告商帐户：

  1. 登录到…… ads.google.com
  2. 您的10位客户ID显示在 右上角，格式为 123-456-7890
  3. 删除破折号： 1234567890
GOOGLE_ADS_CUSTOMER_ID=1234567890

GOOGLE_ADS_LOGIN_CUSTOMER_ID --仅当您通过Manager（MCC）帐户访问客户端帐户时才需要：

  • 如果您通过MCC管理多个客户帐户，请将其设置为 经理帐户的客户ID （格式相同——登录经理帐户时的右上角）
  • 如果您直接登录到没有MCC的单个广告商帐户， 留空
GOOGLE_ADS_LOGIN_CUSTOMER_ID=   # leave blank if not using MCC

步骤6——填写.env文件

cp .env.example .env

打开 .env 并粘贴所有值：

GOOGLE_CLIENT_ID=123456789-abc.apps.googleusercontent.com
GOOGLE_CLIENT_SECRET=GOCSPX-xxxxxxxxxxxxxxxxxxxx
GOOGLE_REFRESH_TOKEN=1//0gxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
GOOGLE_ADS_DEVELOPER_TOKEN=AbCdEfGhIjKlMnOp12345678
GOOGLE_ADS_CUSTOMER_ID=1234567890
GOOGLE_ADS_LOGIN_CUSTOMER_ID=   # optional — only for MCC users

步骤7——测试服务器

python server.py

您应该看到服务器启动时没有错误。按 Ctrl+C 停止。

步骤8--添加到Claude桌面

配置文件位置：

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • 视窗: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "google-ads": {
      "command": "python",
      "args": ["C:/absolute/path/to/mcp-google-ads/server.py"],
      "env": {
        "GOOGLE_CLIENT_ID": "123456789-abc.apps.googleusercontent.com",
        "GOOGLE_CLIENT_SECRET": "GOCSPX-xxxxxxxxxxxxxxxxxxxx",
        "GOOGLE_REFRESH_TOKEN": "1//0gxxxxxxxxxx",
        "GOOGLE_ADS_DEVELOPER_TOKEN": "AbCdEfGhIjKlMnOp12345678",
        "GOOGLE_ADS_CUSTOMER_ID": "1234567890",
        "GOOGLE_ADS_LOGIN_CUSTOMER_ID": ""
      }
    }
  }
}

保存后重新启动Claude Desktop。您应该在MCP服务器列表中看到“谷歌广告”。

活动创建流程

gads_create_budget → gads_create_campaign → gads_create_adgroup → gads_add_keywords → gads_create_responsive_search_ad

示例提示

  • “创建一个名为‘品牌’的搜索活动，预算为每天20美元”
  • “这个月我最喜欢的关键词是什么？”
  • “将负面关键字‘free’添加到我的主广告系列中”
  • “向我展示‘跑鞋’的关键词创意”
  • “预测关键词点击量：[‘在线买鞋’、‘跑鞋’]”
  • “应用所有待处理的建议”

相关 MCP