使用说明

谷歌广告MCP服务器

一个全面的模型上下文协议（MCP）服务器，提供谷歌广告API集成。此工具使您能够以编程方式管理Google广告活动、关键字、广告、转化率和性能指标。

🚀 关于

此MCP服务器旨在将Google Ads API与Claude Desktop或其他兼容MCP的应用程序集成在一起。它是用TypeScript编写的，是以编程方式管理您的Google Ads帐户的强大桥梁。

🎯 主要特点

账户管理：管理多个Google Ads帐户
活动创建和管理：搜索、展示、购物、视频活动类型
广告组管理：投标策略和预算控制
关键字管理：添加/编辑正面和负面关键字
性能跟踪：详细的指标和报告
转化跟踪：转换行动管理

📋 可用工具

🎯 活动工具

list_campaigns -列出所有具有绩效指标的活动
create_campaign -创建新活动（搜索、展示、购物、视频、多渠道）
update_campaign -更新活动设置（名称、状态、预算）

📁 广告组工具

list_ad_groups -列出带有指标的广告组
create_ad_group -创建新的广告组
update_ad_group -更新广告组设置
get_ad_group -获取特定广告组的详细信息

📢 广告工具

list_ads -列出带有性能数据的广告
create_responsive_search_ad -创建响应式搜索广告
update_ad_status -更新广告状态

🔍 关键字工具

list_keywords -列出带有性能数据的关键字
add_keywords -向广告组添加新关键字
add_negative_keywords -添加负面关键字（活动或广告组级别）
update_keyword -更新关键字状态和出价

🎯 转换跟踪工具

list_conversions -列出所有转换操作
create_conversion -创建新的转换操作
update_conversion -更新转换设置

📊 性能和分析工具

get_account_performance -客户级绩效指标
get_campaign_performance -活动绩效报告（每日细分）
get_ad_group_performance -广告组绩效报告
get_search_terms_report -搜索词分析

🛍️ 购物活动工具

get_shopping_performance -购物活动表现
get_product_performance -基于产品的性能分析

👤 账户管理工具

list_accounts -列出所有可访问的Google Ads帐户
get_account_hierarchy -显示经理/客户帐户关系

🛠️ 安装步骤

1.先决条件

Node.js（v18或更高版本）
npm或纱线
Google Ads API访问
Claude Desktop（用于MCP集成）

2.克隆存储库

git clone https://github.com/yourusername/google-ads-mcp.git
cd google-ads-mcp

3.安装依赖项

npm install

4.获得Google Ads API证书

a）获取开发者令牌

访问https://developers.google.com/google-ads/api/docs/get-started/dev-token
使用您的Google Ads帐户登录
申请开发者代币

b）创建OAuth2凭据

首选https://console.cloud.google.com/
创建新项目或选择现有项目
导航到“API和服务”>“凭据”
点击“创建凭据”>“OAuth客户端ID”
选择“桌面应用程序”作为应用程序类型
保存您的客户端ID和客户端密码

c）获取刷新令牌

使用谷歌OAuth2游乐场：https://developers.google.com/oauthplayground/
或者使用Google Ads API示例中的辅助脚本

5.设置环境变量

复制 .env.example 向 .env 并填写您的值：

cp .env.example .env

编辑 .env 文件：

GOOGLE_ADS_CLIENT_ID=your-client-id-here
GOOGLE_ADS_CLIENT_SECRET=your-client-secret-here
GOOGLE_ADS_DEVELOPER_TOKEN=your-developer-token-here
GOOGLE_ADS_REFRESH_TOKEN=your-refresh-token-here
GOOGLE_ADS_CUSTOMER_ID=your-customer-id-here

# For manager accounts (optional)
GOOGLE_ADS_LOGIN_CUSTOMER_ID=your-login-customer-id-here

6.建设项目

npm run build

7.克劳德桌面配置

要将MCP服务器添加到Claude Desktop，请执行以下操作：

打开克劳德桌面设置
使用以下示例 claude-desktop-config.example.json 配置：

{
  "mcpServers": {
    "google-ads": {
      "command": "node",
      "args": ["/absolute/path/to/google-ads-mcp/dist/index.js"],
      "env": {
        "GOOGLE_ADS_CLIENT_ID": "your-client-id",
        "GOOGLE_ADS_CLIENT_SECRET": "your-client-secret",
        "GOOGLE_ADS_DEVELOPER_TOKEN": "your-developer-token",
        "GOOGLE_ADS_REFRESH_TOKEN": "your-refresh-token",
        "GOOGLE_ADS_CUSTOMER_ID": "your-customer-id"
      }
    }
  }
}

重新启动克劳德桌面

💻 发展

以开发模式运行

npm run dev

生产建设

npm run build

以生产模式启动

npm start

🏗️ 项目结构

google-ads-mcp/
├── src/
│   ├── index.ts              # Main MCP server file
│   ├── config.ts             # Configuration management
│   ├── google-ads-client.ts  # Google Ads API client
│   └── tools/                # MCP tool implementations
│       ├── accounts.ts       # Account management tools
│       ├── campaigns.ts      # Campaign tools
│       ├── ad-groups.ts      # Ad group tools
│       ├── ads.ts           # Ad tools
│       ├── keywords.ts      # Keyword tools
│       ├── conversions.ts   # Conversion tracking tools
│       ├── performance.ts   # Performance reporting tools
│       ├── analytics.ts     # Analytics tools
│       └── shopping.ts      # Shopping campaign tools
├── dist/                    # Compiled JavaScript files
├── .env.example            # Example environment variables
├── claude-desktop-config.example.json  # Example Claude Desktop config
├── package.json            # Project dependencies
├── tsconfig.json          # TypeScript configuration
└── README.md              # This file

🤝 贡献

欢迎拉取请求。对于重大更改，请先打开一个问题来讨论您想要更改的内容。

📄 许可证

麻省理工学院