基本能力
产品定位
Google Ads MCP 是一个广告数据分析工具,通过 AI 助手 Claude 提供自然语言交互的广告数据分析和可视化功能。
核心功能
- 账户管理:查看所有 Google Ads 账户及其基本信息。
- 广告系列分析与报告:分析广告系列表现,跟踪展示、点击、转化和成本等指标。
- 关键词与广告表现:识别表现最佳和最差的关键词,分析广告文案效果。
- 预算与竞价管理:监控广告系列预算和支出,分析竞价策略。
- 数据可视化:通过图表和图形展示广告数据。
适用场景
- 广告专业人士需要快速分析广告表现。
- 需要自然语言交互的广告数据分析。
- 需要可视化广告数据的用户。
工具列表
| 工具名称 | 功能描述 |
|----------|----------|
| list_accounts
| 列出所有 Google Ads 账户 |
| execute_gaql_query
| 执行 Google Ads 查询语言 (GAQL) 查询 |
| get_campaign_performance
| 获取广告系列性能数据 |
| get_ad_performance
| 获取广告创意性能数据 |
| run_gaql
| 运行任意 GAQL 查询并格式化结果 |
常见问题解答
- Python 命令未找到:在 macOS 上,默认 Python 命令通常是
python3
而不是python
。 - Claude 配置问题:确保所有文件路径正确,服务账户有权访问 Google Ads 账户。
- Google Ads API 限制:检查 API 配额限制和开发者令牌权限。
使用教程
使用依赖
- 安装 Python (版本 3.11 或更高)
- 安装 Node.js
- 安装 Claude Desktop
安装教程
- 下载 Google Ads MCP:
bash
git clone https://github.com/ixigo/mcp-google-ads.git - 创建虚拟环境:
bash
python -m venv .venv - 激活虚拟环境:
```bash
# On Mac/Linux:
source .venv/bin/activate
# On Windows:
.venv\Scripts\activate
4. 安装依赖:
bash
pip install -r requirements.txt
```
调试方式
- 测试 Google Ads API 连接:
bash
python test_google_ads_mcp.py - 检查 Claude 配置:确保所有路径和令牌正确。
- 查看错误消息:在 Claude 的响应中查找错误信息。