金大哥 - google-ads-library-mcp MCP 详情

article

README

🚀 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 密钥（可选，仅在分析视频广告时需要）

快速安装（推荐）

克隆并运行安装脚本

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

# 对于 macOS/Linux 系统：
./install.sh

# 对于 Windows 系统：
install.bat

配置 API 密钥 编辑生成的 .env 文件，并添加你的 API 密钥：
- 从 scrapecreators.com 获取 ScrapeCreators API 密钥
- 从 Google AI Studio 获取 Google Gemini API 密钥（可选，用于视频分析）
按照显示的 MCP 配置进行操作 安装脚本将显示需要添加到 Claude 桌面应用程序或 Cursor 的具体配置信息。

手动安装

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

克隆此仓库

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

安装依赖项
```
pip install -r requirements.txt
```
配置 API 密钥 复制模板并配置你的 API 密钥：
```
cp .env.template .env
# 然后使用实际的 API 密钥编辑 .env 文件
```
获取 API 密钥的方法：
- 在此处注册 Scrape Creators
- 在此处获取 Google Gemini API 密钥（可选，用于视频分析）
连接到 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
```
重启 Claude 桌面应用程序 / Cursor 打开 Claude 桌面应用程序，你现在应该可以看到 Google 广告库作为可用的集成选项。或者重启 Cursor。

🔧 技术细节

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

Google 广告

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

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

小贴士：

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

可用的 MCP 工具

此 MCP 服务器提供了与 Google 广告透明度中心对象进行交互的工具： | 工具名称 | 描述 | | ---- | ---- | | get_google_ads | 从 Google 广告透明度中心检索公司当前正在投放的广告（通过域名或广告商 ID） | | get_google_ad_details | 获取特定 Google 广告的详细信息，包括所有变体和区域统计信息 | | analyze_ad_image | 下载并分析广告图片的视觉元素、文本、颜色和构图 | | analyze_ad_video | 使用 Gemini AI 下载并分析广告视频，以获得全面的视频洞察 | | get_cache_stats | 获取缓存媒体（图片和视频）的统计信息和存储使用情况 | | search_cached_media | 按品牌、颜色、人物或媒体类型搜索之前分析过的媒体 | | cleanup_media_cache | 清理旧的缓存媒体文件以释放磁盘空间 |

🛠️ 故障排除

常见问题

未找到 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 许可证。

google-ads-library-mcp