Google Ads Library MCP

🚀 Google Ads Library MCP Server

这是一个用于 Google 广告透明度中心的模型上下文协议（MCP）服务器。借助它，你可以在 Google 的公共广告透明度中心搜索任何公司或品牌，查看它们当前正在投放的广告，并对其广告进行分析。你可以分析广告图片或文本，对视频广告进行全面洞察分析，比较不同公司的广告策略，并深入了解它们广告活动的有效之处。

以下是该服务器与 Claude 连接后的使用示例：

示例链接

要获取此项目及其他相关项目的更新信息，请在此订阅

另外，欢迎加入我们的 Twitter 社区，一起交流 MCP 相关内容。

🚀 快速开始

示例提示

'AnthropicAI' 正在投放多少个广告？视频广告和图片广告的比例是多少？

'AnthropicAI' 目前在广告中使用了哪些宣传信息？

分析 'Nike' 的视频广告，提取其视觉叙事策略、节奏和品牌宣传技巧。

对 'AnthropicAI'、'Perplexity AI' 和 'OpenAI' 的宣传信息进行深入比较，并给出一个便于转发的总结。

📦 安装指南

前提条件

• Python 3.12 及以上版本
• Anthropic Claude 桌面应用程序（或 Cursor）
• Pip（Python 包管理器），使用 python -m pip install 进行安装
• Scrape Creators 的访问令牌
• 用于视频分析的 Google Gemini API 密钥（可选，仅在分析视频广告时需要）

快速安装（推荐）

1. 克隆并运行安装脚本

   git clone https://github.com/trypeggy/google-ads-library-mcp.git
   cd google-ads-library-mcp
   
   # 对于 macOS/Linux 系统：
   ./install.sh
   
   # 对于 Windows 系统：
   install.bat
   

2. 配置 API 密钥 编辑生成的 .env 文件，并添加你的 API 密钥：

   • 从 scrapecreators.com 获取 ScrapeCreators API 密钥
   • 从 Google AI Studio 获取 Google Gemini API 密钥（可选，用于视频分析）

3. 按照显示的 MCP 配置进行操作 安装脚本将显示需要添加到 Claude 桌面应用程序或 Cursor 的具体配置信息。

手动安装

如果你更喜欢手动安装，可以按照以下步骤进行：

1. 克隆此仓库

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

2. 安装依赖项

   pip install -r requirements.txt
   

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

   cp .env.template .env
   # 然后使用实际的 API 密钥编辑 .env 文件
   

   获取 API 密钥的方法：

   • 在 此处 注册 Scrape Creators
   • 在 此处 获取 Google Gemini API 密钥（可选，用于视频分析）

4. 连接到 MCP 服务器 将 MCP 服务器配置添加到你的 Claude 桌面应用程序或 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 桌面应用程序： 将上述配置保存为 claude_desktop_config.json，并放置在以下目录中：

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

   对于 Cursor： 将上述配置保存为 mcp.json，并放置在以下目录中：

   ~/.cursor/mcp.json
   

5. 重启 Claude 桌面应用程序 / Cursor 打开 Claude 桌面应用程序，你现在应该可以看到 Google 广告库作为可用的集成选项。或者重启 Cursor。

🔧 技术细节

1. Claude 向 Python MCP 服务器发送请求。
2. MCP 服务器向 ScrapeCreators API 查询 Google 广告透明度中心的数据。
3. 数据通过链路返回给 Claude。

Google 广告

此服务器连接到 Google 的广告透明度中心：

• Google 广告：使用公司域名（例如，"nike.com"）或广告商 ID 进行搜索。
• 响应格式：返回具有格式类型（文本/图片/视频）和详细变体的广告。
• 广告详情：每个广告可能有多个具有不同标题和描述的变体。
• 区域数据：包括特定区域的统计信息和展示数据。

小贴士：

• 搜索时使用公司域名（例如，"nike.com"）而不是品牌名称。
• 除了图片和视频广告，现在还支持文本广告。
• 每个广告可能有多个具有不同标题和描述的变体。

可用的 MCP 工具

此 MCP 服务器提供了与 Google 广告透明度中心对象进行交互的工具：

🛠️ 故障排除

常见问题

未找到 API 密钥错误：

• 确保 .env 文件位于项目根目录中。
• 如果你没有 .env 文件，请从模板复制：cp .env.template .env。
• 检查你的 API 密钥格式是否正确，不包含引号。
• 验证 .env 文件中是否包含 SCRAPECREATORS_API_KEY=your_key_here。
• 对于视频分析，确保 .env 文件中也添加了 GEMINI_API_KEY=your_key_here。

视频分析无法正常工作：

• 确认你的 .env 文件中包含有效的 Google Gemini API 密钥。
• 视频分析需要 GEMINI_API_KEY 环境变量。

MCP 服务器连接问题：

• 验证 MCP 配置中的路径是否指向正确的位置。
• 确保你已经使用 pip install -r requirements.txt 安装了所有依赖项。
• 在更改配置后重启 Claude 桌面应用程序 / Cursor。

有关 Claude 桌面应用程序集成的更多故障排除信息，请参阅 MCP 文档。该文档包含了检查日志和解决常见问题的有用提示。

Google 广告特定注意事项：

• 搜索时使用公司域名（例如，"nike.com"）而不是品牌名称。
• 除了图片和视频广告，现在还支持文本广告。
• 每个广告可能有多个具有不同标题和描述的变体。

💬 反馈

我们非常感谢你的反馈。请告诉我们你希望在后续版本中看到哪些功能，或者提出全新的功能需求。

📄 许可证

本项目采用 MIT 许可证。