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 許可證。