
Google Ads MCP

2025.04.09
46
Python广告数据分析AI 集成金融服务开发效率
Google Ads MCP 是一个连接 Google Ads 与 Claude AI 的工具,允许用户通过自然语言对话分析广告数据。该集成提供了对广告系列信息、性能指标、关键词分析和广告管理的访问,所有这些都可以通过与 Claude 的简单聊天完成。
View on GitHub
Overview
基本能力
产品定位
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 的响应中查找错误信息。