Google Ads Library MCP Server

这是一个用于 Google Ads Transparency Center 的模型上下文协议（MCP）服务器。

借助它，你可以搜索 Google 公开的 Ads Transparency Center，查找任意公司或品牌，查看他们当前投放的广告并分析其广告策略。你可以分析广告图片/文本，对视频广告进行全面的洞察分析，比较不同公司的策略，并深入了解其广告活动中哪些方法行之有效。

下面是它连接到 Claude 之后可以执行的操作示例。

https://github.com/user-attachments/assets/a47aa689-e89d-4d4b-9df7-6eb3a81937ee

托管版本（推荐）

使用 Google Ads Library MCP 最简单的方式是使用 Proxy (useproxy.dev) 提供的托管版本。 无需 API 密钥、无需 Gemini 密钥、无需 Python、无需运行服务器——只需连接并开始查询。

• ⚡ 零配置 —— 无需安装、配置或维护

• 🔑 无需 API 密钥 —— 完全跳过 ScrapeCreators 和 Gemini 密钥

• 🔌 随处可用 —— 支持 ChatGPT、Claude、Cursor、Manus，以及其他任何支持 MCP 的环境

• 🚀 始终最新 —— 新工具和修复会自动推送

👉 免费在 useproxy.dev 开始使用，立即开始 →

如果你更喜欢自己运行，完整的自托管设置见下文。

托管版 vs. 自托管

对于大多数人来说，托管版本 是最快的路径。如果你特别想自己修改或扩展服务器，再选择自托管。

Related MCP server: google-ads-transparency-mcp

示例提示词

How many ads is 'AnthropicAI' running? What's their split across video and image?

What messaging is 'AnthropicAI' running right now in their ads?

Analyze the video ads from 'Nike' and extract their visual storytelling strategy, pacing, and brand messaging techniques.

Do a deep comparison to the messaging between 'AnthropicAI', 'Perplexity AI' and 'OpenAI'. Give it a nice forwardable summary.

安装

前提条件

• Python 3.12+

• Anthropic Claude Desktop 应用程序（或 Cursor）

• Pip（Python 包管理器），使用 python -m pip install 安装

• 广告数据提供商的 API 密钥，设置为 SCRAPECREATORS_API_KEY（见下方配置）

• Google Gemini API 密钥，用于视频分析（可选，仅供视频广告使用）

不希望处理 API 密钥？请参阅上文的托管版本，跳过全部设置。

快速安装（推荐）

1. 克隆并运行安装脚本

   git clone https://github.com/proxy-intell/google-ads-library-mcp.git
   cd google-ads-library-mcp
   
   # For macOS/Linux:
   ./install.sh
   
   # For Windows:
   install.bat

2. 配置你的 API 密钥

   编辑所创建的 .env 文件，并添加你的 API 密钥：

   • 将广告数据 API 密钥设置为 SCRAPECREATORS_API_KEY

   • 在 Google AI Studio 获取 Gemini API 密钥（可选，用于视频分析）

3. 按照显示的 MCP 配置操作

   安装脚本会显示你需要添加到 Claude Desktop 或 Cursor 的精确配置。

手动安装

如果你希望手动安装：

1. 克隆本仓库

   git clone https://github.com/proxy-intell/google-ads-library-mcp.git
   cd google-ads-library-mcp

2. 安装依赖库

   pip install -r requirements.txt

3. 配置 API 密钥

   复制模板并配置你的 API 密钥：

   cp .env.template .env
   # Then edit .env with your actual API keys

   获取 API 密钥：

   • 将你的广告数据 API 密钥设置为 .env 文件中的 SCRAPECREATORS_API_KEY

   • 在这里获取 Google Gemini API 密钥（可选，用于视频分析）

4. 连接到 MCP 服务器

   将 MCP 服务器配置添加到你的 Claude Desktop 或 Cursor 配置中：

   {
     "mcpServers": {
       "google_ad_library": {
       "command": "/usr/local/opt/python@3.13/bin/python3",
         "args": [
           "{{PATH_TO_PROJECT}}/google-ads-library-mcp/mcp_server.py"
         ]
       }
     }
   }

   将 {{PATH_TO_PROJECT}} 替换为你克隆此仓库的完整路径。

   注意： API 密钥会自动从 .env 文件加载。命令行参数仍然支持，如果提供了参数，则优先于环境变量。

   对于 Claude Desktop：

   将以下内容保存为 claude_desktop_config.json，放在你的 Claude Desktop 配置目录中：

   ~/Library/Application Support/Claude/claude_desktop_config.json

   对于 Cursor：

   将以下内容保存为 mcp.json，放在你的 Cursor 配置目录中：

   ~/.cursor/mcp.json

5. 重新启动 Claude Desktop / Cursor

   打开 Claude Desktop，你现在应该可以看到 Google Ads Library 作为一个可用的集成。

   或者重新启动 Cursor。

技术细节

1. Claude 会向 Python MCP 服务器发送请求。

2. MCP 服务器会向广告数据 API 查询 Google Ads Transparency Center 数据。

3. 数据通过链路流回 Claude。

Google Ads

该服务器连接到 Google 的 Ads Transparency Center：

• Google Ads：使用公司域名（例如 "nike.com"）或广告主 ID 进行搜索

• 响应格式：返回带有格式类型（文本/图片/视频）以及详细变体的广告

• 广告详情：每个广告可能有多个变体，包含不同的标题和描述

• 区域数据：包含特定区域的统计信息和展示次数数据

建议：

• 搜索时使用公司域名（例如 "nike.com"），而不是品牌名称

• 除了图片和视频广告，现在还支持文本广告

• 每个广告可能有多个具有不同标题和描述的变体

可使用的 MCP 工具

此 MCP 服务器提供的工具用于与 Google Ads Transparency Center 对象进行交互：

故障排查

常见问题

找不到 API 密钥错误：

• 确保你的 .env 文件位于项目根目录

• 如果你没有 .env 文件，请通过 cp .env.template .env 从模板复制

• 确认你的 API 格式正确且不带引号

• 确认 .env 文件中包含 SCRAPECREATORS_API_KEY=your_key_here

• 视频分析功能还需要同时添加 GEMINI_API_KEY=your_key_here

视频分析不工作：

• 确认你的 .env 文件中有有效的 Google Gemini API 密钥

• 视频分析需要 GEMINI_API_KEY 环境变量

MCP 服务器连接问题：

• 确认 MCP 配置中的路径指向正确位置

• 确保你已经通过 pip install -r requirements.txt 安装了所有依赖项

• 修改配置后重新启动 Claude Desktop/Cursor

如需其他 Claude Desktop 集成故障排查，请参见 MCP 文档。该文档包含有关检查日志和解决常见问题的有用提示。

Google Ads 专用注意事项：

• 搜索时使用公司域名（例如 "nike.com"）而不是商标名称

• 文本广告除图片和视频广告外已支持

• 每个广告可以有多个变体，包含不同的标题和描述

常见问题

使用 Google Ads Library MCP 的最简单方式是什么？ 最简单的方式是使用 Proxy（useproxy.dev） 提供的托管版本。不需要 API 密钥、不需要安装、不需要服务器——直接连接到 ChatGPT、Claude、Cursor 或任何 MCP 客户端，即可立即开始查询。你可以免费开始使用。

使用这个 MCP 需要 API 密钥吗？ 只有自托管才需要。useproxy.dev 上的托管版本 会为你处理所有数据访问，因此不需要 ScrapeCreators 或 Gemini 密钥。自托管需要 SCRAPECREATORS_API_KEY（如果做视频分析，还需要 Gemini 密钥）。

它与哪些 MCP 客户端兼容？ 托管版和自托管版都支持 ChatGPT、Claude（桌面和 Web）、Cursor、Manus，以及. 在其他任何支持 Model Context Protocol 的客户端中。

有免费版本吗？ 有——Proxy 提供的托管版本 提供免费层级，你可以无需任何设置，直接开始分析广告。

我应该选择自托管还是托管？ 如果你想快速、省心地获取 Google Ads Transparency Center 数据并进行零维护，使用托管版本，多数用户推荐这种方式。只有当你希望自己修改或扩展服务器代码时，才考虑自托管。

反馈

我们非常感谢你的反馈。请联系我们，告诉我们你希望在下一次迭代中看到这些功能中的哪个，或者提出全新的功能需求。

许可证

本项目采用 MIT License。

由 Proxy 团队用 ❤️ 制作。