Google Ads MCP

Google Ads MCP

site icon
2025.04.09 46
Python广告数据分析AI 集成金融服务开发效率
Google Ads MCP 是一个连接 Google Ads 与 Claude AI 的工具,允许用户通过自然语言对话分析广告数据。该集成提供了对广告系列信息、性能指标、关键词分析和广告管理的访问,所有这些都可以通过与 Claude 的简单聊天完成。
View on GitHub

Overview

基本能力

产品定位

Google Ads MCP 是一个广告数据分析工具,通过 AI 助手 Claude 提供自然语言交互的广告数据分析和可视化功能。

核心功能

  1. 账户管理:查看所有 Google Ads 账户及其基本信息。
  2. 广告系列分析与报告:分析广告系列表现,跟踪展示、点击、转化和成本等指标。
  3. 关键词与广告表现:识别表现最佳和最差的关键词,分析广告文案效果。
  4. 预算与竞价管理:监控广告系列预算和支出,分析竞价策略。
  5. 数据可视化:通过图表和图形展示广告数据。

适用场景

  1. 广告专业人士需要快速分析广告表现。
  2. 需要自然语言交互的广告数据分析。
  3. 需要可视化广告数据的用户。

工具列表

工具名称 功能描述
list_accounts 列出所有 Google Ads 账户
execute_gaql_query 执行 Google Ads 查询语言 (GAQL) 查询
get_campaign_performance 获取广告系列性能数据
get_ad_performance 获取广告创意性能数据
run_gaql 运行任意 GAQL 查询并格式化结果

常见问题解答

  1. Python 命令未找到:在 macOS 上,默认 Python 命令通常是 python3 而不是 python
  2. Claude 配置问题:确保所有文件路径正确,服务账户有权访问 Google Ads 账户。
  3. Google Ads API 限制:检查 API 配额限制和开发者令牌权限。

使用教程

使用依赖

  1. 安装 Python (版本 3.11 或更高)
  2. 安装 Node.js
  3. 安装 Claude Desktop

安装教程

  1. 下载 Google Ads MCP: bash git clone https://github.com/ixigo/mcp-google-ads.git
  2. 创建虚拟环境: bash python -m venv .venv
  3. 激活虚拟环境: ```bash # On Mac/Linux: source .venv/bin/activate

# On Windows: .venv\Scripts\activate 4. 安装依赖:bash pip install -r requirements.txt ```

调试方式

  1. 测试 Google Ads API 连接: bash python test_google_ads_mcp.py
  2. 检查 Claude 配置:确保所有路径和令牌正确。
  3. 查看错误消息:在 Claude 的响应中查找错误信息。

许可证

该项目遵循 MIT 开源许可条款。