Google Ads MCP Server

完整的 MCP 服务器，用于管理 Google Ads，具备完整的 CRUD、可视化仪表盘、报告，并管理 Google Ads 面板中可用的所有功能。

功能（85+ 个工具）

账户与客户

• list_accessible_customers — 列出可访问的账户

• get_customer_details — 账户详情

• list_customer_clients — 列出 MCC 下的客户

• update_customer — 更新设置

• get_account_hierarchy — 账户层级结构

• get_change_history — 变更历史

广告系列（完整 CRUD）

• list_campaigns — 使用过滤器列出广告系列

• get_campaign — 广告系列完整详情

• create_campaign — 创建广告系列（搜索、展示、购物、视频、Performance Max 等）

• update_campaign — 更新名称、状态、出价、日期

• remove_campaign — 移除广告系列

• get_campaign_performance — 效果指标

• copy_campaign — 复制广告系列设置

广告组（完整 CRUD）

• list_ad_groups — 列出广告组

• get_ad_group — 广告组详情

• create_ad_group — 创建广告组

• update_ad_group — 更新设置

• remove_ad_group — 移除广告组

• get_ad_group_performance — 效果指标

广告（完整 CRUD）

• list_ads — 列出广告

• get_ad — 广告详情

• create_responsive_search_ad — 创建自适应搜索广告（RSA），带标题和描述

• update_ad_status — 启用/暂停广告

• remove_ad — 移除广告

• get_ad_performance — 效果指标

关键词（完整 CRUD）

• list_keywords — 列出关键词及质量得分

• add_keywords — 添加关键词（完全匹配、词组匹配、广泛匹配）

• update_keyword — 更新出价、状态、URL

• remove_keyword — 移除关键词

• get_keyword_performance — 效果指标及展示份额

• get_search_terms — 搜索词报告

• add_negative_keywords — 添加否定关键词（广告系列或广告组）

预算与出价策略

• list_budgets — 列出预算

• create_budget — 创建预算

• update_budget — 更新金额/投放方式

• remove_budget — 移除预算

• list_bidding_strategies — 列出出价策略

• create_bidding_strategy — 创建出价策略（Target CPA、Target ROAS 等）

• update_bidding_strategy — 更新出价策略

• remove_bidding_strategy — 移除出价策略

受众与定向

• list_audiences — 列出受众/用户列表

• get_audience_performance — 受众效果

• list_campaign_targeting — 列出广告系列定向条件

• add_campaign_location_targeting — 地理位置定向

• add_campaign_language_targeting — 语言定向

• add_ad_schedule — 广告时段安排（dayparting）

• remove_campaign_criterion — 移除定向条件

• get_geo_target_constants — 获取地理位置常量

• get_demographics_performance — 人口属性效果

资产与附加信息

• list_assets — 列出所有资产

• create_sitelink_asset — 创建站点链接

• create_callout_asset — 创建附加宣传信息

• create_structured_snippet_asset — 创建结构化摘要

• create_call_asset — 创建电话扩展

• create_price_asset — 创建价格扩展

• create_promotion_asset — 创建促销扩展

• create_lead_form_asset — 创建潜在客户表单

• link_asset_to_campaign — 将资产关联到广告系列

• link_asset_to_ad_group — 将资产关联到广告组

• remove_asset — 移除资产

• get_asset_performance — 资产效果

• list_campaign_assets — 列出广告系列中的资产

• remove_campaign_asset — 取消关联资产

转化

• list_conversion_actions — 列出转化操作

• get_conversion_action — 转化操作详情

• create_conversion_action — 创建转化操作

• update_conversion_action — 更新转化操作

• remove_conversion_action — 移除转化操作

• get_conversion_performance — 转化效果

报告与仪表盘

• execute_gaql_query — 执行自定义 GAQL 查询

• get_account_dashboard — 账户完整仪表盘

• get_campaign_dashboard — 广告系列详细仪表盘

• get_performance_by_device — 按设备查看效果

• get_performance_by_network — 按网络查看效果

• get_performance_by_hour — 按小时查看效果

• get_performance_by_day_of_week — 按星期几查看效果

• get_geographic_performance — 地理位置效果

• get_landing_page_performance — 落地页效果

• compare_date_ranges — 比较日期范围

标签与共享集合

• list_labels — 列出标签

• create_label — 创建标签

• remove_label — 移除标签

• apply_label_to_campaign — 将标签应用到广告系列

• apply_label_to_ad_group — 将标签应用到广告组

• list_shared_sets — 列出共享列表

• create_shared_set — 创建共享否定列表

• add_shared_set_criteria — 向共享列表添加条件

• link_shared_set_to_campaign — 将共享列表关联到广告系列

建议与优化

• list_recommendations — 列出 Google 建议

• apply_recommendation — 应用建议

• dismiss_recommendation — 忽略建议

• get_optimization_score — 优化得分

实验与变更

• list_experiments — 列出 A/B 实验

• list_experiment_arms — 列出实验变体

• get_change_status — 近期变更

先决条件

1. Google Cloud Project 并已启用 Google Ads API

2. OAuth2 Client ID，类型为桌面应用

3. Google Ads 开发者令牌（在 ads.google.com > API Center 获取）

4. Node.js >= 18

安装

npm install
npm run build

配置

选项 1：环境变量

export GOOGLE_ADS_CLIENT_ID="seu-client-id"
export GOOGLE_ADS_CLIENT_SECRET="seu-client-secret"
export GOOGLE_ADS_DEVELOPER_TOKEN="seu-developer-token"
export GOOGLE_ADS_REFRESH_TOKEN="seu-refresh-token"
export GOOGLE_ADS_LOGIN_CUSTOMER_ID="123-456-7890"  # opcional, para contas MCC

选项 2：交互式设置

npm run auth

这将在 ~/.google-ads-mcp/credentials.json 中创建一个凭据文件。

在 Claude Code 中配置

添加到你的 ~/.claude/settings.json：

{
  "mcpServers": {
    "google-ads": {
      "command": "node",
      "args": ["/caminho/para/google-ads-manager-hub/dist/index.js"],
      "env": {
        "GOOGLE_ADS_CLIENT_ID": "seu-client-id",
        "GOOGLE_ADS_CLIENT_SECRET": "seu-client-secret",
        "GOOGLE_ADS_DEVELOPER_TOKEN": "seu-developer-token",
        "GOOGLE_ADS_REFRESH_TOKEN": "seu-refresh-token",
        "GOOGLE_ADS_LOGIN_CUSTOMER_ID": "1234567890"
      }
    }
  }
}

使用

配置完成后，所有工具都可以通过 MCP 使用。示例：

• "列出我所有的 campaign（广告系列）"

• "创建一个搜索广告系列，预算为 R$50/天"

• "显示最近 30 天的效果仪表盘"

• "将广告组 X 添加到关键词中：……"

• "暂停广告系列Y"

• "显示搜索词报告"

• "Google 对我的账户有什么建议？"

API 版本

此服务器使用 Google Ads API v23（最新版本，2026 年 1 月发布）。

项目结构

src/
├── index.ts                    # Entry point - MCP server
├── auth/
│   ├── oauth2.ts               # OAuth2 client + token management
│   └── setup.ts                # Interactive auth setup CLI
├── client/
│   └── google-ads-client.ts    # Google Ads REST API client
└── tools/
    ├── accounts/               # Account & customer management
    ├── campaigns/              # Campaign CRUD
    ├── adgroups/               # Ad group CRUD
    ├── ads/                    # Ad CRUD (RSA, etc.)
    ├── keywords/               # Keywords + search terms + negatives
    ├── budgets/                # Budgets + bidding strategies
    ├── audiences/              # Audiences + targeting + demographics
    ├── assets/                 # Assets (sitelinks, callouts, etc.)
    ├── conversions/            # Conversion actions + tracking
    ├── reporting/              # Dashboard + GAQL + analytics
    ├── labels/                 # Labels + shared sets
    ├── recommendations/        # Optimization recommendations
    ├── experiments/            # A/B tests + change tracking
    └── extensions/             # Price, promotion, lead form extensions