Google Ads MCP 服务

用于LLM的Google Ads MCP服务器🚀

一个强大的 模型上下文协议（MCP） 连接的服务器 谷歌广告API 使用AI助手，如 克劳德桌面版 和 Cursor IDE.

此工具使您的LLM工作流程能够 自动化活动管理, 分析搜索词，以及 执行复杂的GAQL查询 纯粹通过自然语言。不再需要手动切换仪表板——直接与您的广告数据聊天。

✨ 特性

通过以下核心功能释放人工智能驱动营销的全部潜力：

• 📊 活动报告:
  • google_ads_list_campaigns：立即检索已启用活动的性能指标（印象、点击、CTR、成本、CPC）。
• 🔍 搜索词审核:
  • google_ads_get_search_terms：准确了解用户键入的内容以查找您的广告。通过识别过高的成本或高转化率条款来优化支出。
• 💪 高级用户查询（GAQL）:
  • google_ads_run_gaql：运行任何自定义 谷歌广告查询语言 针对定制报告需求的声明。
• 📈 关键词研究:
  • google_ads_get_keyword_volume：检索关键字列表的每月搜索量和竞争级别。目前已针对 巴西（PT-BR）.

🛠️ 先决条件

• Python 3.10 或更高。
• Google广告帐户：已启用API访问的经理帐户（MCC）或标准帐户。
• API证书：开发人员令牌、客户端ID、客户端密码和刷新令牌。
• 包管理器: uv （推荐用于速度）或标准 pip.

🚀 安装

1.克隆存储库

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

2.设置虚拟环境

选项A：使用 uv （最快）

uv venv
source .venv/bin/activate

选项B：使用标准Python

python -m venv venv
source venv/bin/activate  # Windows: venv\Scripts\activate

3.安装依赖项

pip install "mcp[cli]" google-ads

⚙️ 配置

环境变量

为了安全起见，凭据是通过环境变量传递的。将这些添加到您的 .env 在shell中文件或导出它们：

帐户映射(accounts.json)

通过将友好名称映射到客户ID，轻松管理多个帐户。创建一个 accounts.json 根目录下的文件：

{
  "My Client A": "123-456-7890",
  "Agency Account": "987-654-3210"
}

注意：服务器会自动处理连字符，因此“123-456-7890”被处理为“1234567890”。

📖 用法

使用MCP CLI进行测试

使用MCP检查器以交互方式运行服务器：

mcp dev server.py

集成：光标和克劳德桌面

将此配置添加到MCP设置文件中（通常 ~/.cursor/mcp.json 或 claude_desktop_config.json):

{
  "mcpServers": {
    "google-ads": {
      "command": "/absolute/path/to/your/venv/bin/python",
      "args": ["/absolute/path/to/mcp-google-ads/server.py"],
      "env": {
        "GOOGLE_ADS_DEVELOPER_TOKEN": "your_token",
        "GOOGLE_ADS_CLIENT_ID": "your_client_id",
        "GOOGLE_ADS_CLIENT_SECRET": "your_client_secret",
        "GOOGLE_ADS_REFRESH_TOKEN": "your_refresh_token"
      }
    }
  }
}

📄 许可证

该项目根据 MIT许可证.