Google Ads Library MCP

🚀 Google Ads Library MCP Server

このプロジェクトは、Google Ads Transparency Center用のModel Context Protocol (MCP)サーバーです。これを使用すると、Googleの公開広告透明性センターを通じて、任意の企業やブランドの広告を検索し、現在実行中の広告を確認し、広告分析を行うことができます。広告の画像やテキストを分析したり、動画広告に対して包括的な洞察を得たり、企業間の戦略を比較したり、キャンペーンの有効性に関する洞察を得ることが可能です。

以下は、このサーバーをClaudeに接続した際の使用例です。

使用例のリンク

このプロジェクトや他のプロジェクトの更新情報を受け取るには、こちらから購読してください。

PS: MCPに関するすべての情報を得るために、Twitterコミュニティに参加してください。

🚀 クイックスタート

このセクションでは、Google Ads Library MCP Serverの基本的な使い方を説明します。

✨ 主な機能

• Google Ads Transparency Centerを通じて任意の企業やブランドの広告を検索することができます。
• 広告の画像やテキストを分析し、動画広告に対して包括的な洞察を得ることができます。
• 企業間の広告戦略を比較し、キャンペーンの有効性に関する洞察を得ることができます。

💻 使用例

基本的な使用法

以下は、このサーバーを使用した基本的なプロンプトの例です。

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 でインストール
• 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 Desktopまたは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サーバーに接続

   Claude DesktopまたはCursorの設定にMCPサーバーの設定を追加します。

   {
     "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サーバーがScrapeCreators APIに問い合わせ、Google Ads Transparency Centerのデータを取得します。
3. データがClaudeに返されます。

Google Ads

このサーバーは、GoogleのAds Transparency Centerに接続します。

• Google Ads: 企業のドメイン（例: "nike.com"）または広告主IDを使用して検索します。
• レスポンス形式: 広告の形式タイプ（テキスト/画像/動画）と詳細なバリエーションを含む広告を返します。
• 広告詳細: 各広告には、異なる見出しと説明を持つ複数のバリエーションがある場合があります。
• 地域データ: 地域固有の統計とインプレッションデータを含みます。

利用可能な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"）を使用してください。
• 画像や動画広告に加えて、テキスト広告もサポートされています。
• 各広告には、異なる見出しと説明を持つ複数のバリエーションがある場合があります。

📄 ライセンス

このプロジェクトは、MIT Licenseの下でライセンスされています。

💡 使用アドバイス 検索には企業のドメインを使用することをおすすめします。また、動画分析を行う場合は、Google Gemini APIキーを正しく設定することが重要です。

⚠️ 重要な注意事項 APIキーを正しく設定し、MCPサーバーの接続設定を正しく行ってください。設定が正しくない場合、サーバーが正常に動作しないことがあります。