Google Ads Library MCP Server

これは Google Ads Transparency Center のための Model Context Protocol (MCP) サーバーです。

これを使うと、Google の公開広告透明性センターで任意の企業やブランドを検索し、現在配信している広告を確認して、その広告を分析できます。広告画像・テキストの分析、包括的なインサイトを伴う動画広告の分析、企業間の戦略比較、そしてキャンペーンで効果が上がっている要素の把握が可能です。

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 で無料ではじめる →

自分で実行したい場合、セルフホストの完全な手順は以下に記載しています。

ホスト版とセルフホストの比較

ほとんどの人にとって、ホスト版 が最も速い道です。サーバー自体を変更・拡張したい場合は、セルフホストを選んでください。

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 として設定します

• Gemini APIキーは Google AI Studio で取得します（任意。動画分析用）

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キーの取得方法

• .env ファイル内で広告データの APIキーを 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 も追加されていることを確認してください

動画分析が動作しない場合:

• 有効な Google Gemini APIキーが .env ファイルにあることを確認してください

• 動画分析には GEMINI_API_KEY という環境変数がプロトタイプされています

MCP サーバー接続の問題:

• MCP 設定のパスが正しい場所を指していることを確認してください

• pip install -r requirements.txt で全ての依存関係をインストール済みであることを確認してください

• 設定変更後に Claude Desktop / Cursor を再起動してください

Claude Desktop の連携については、MCPドキュメント も併せて参照してください。ログの確認方法や一般的な問題を解決するヒントが掲載されています。

Google Ads 固有の注意点:

• ブランド名ではなく企業ドメイン（例: "nike.com"）で検索してください

• 画像・動画広告に加えてテキスト広告にも対応しています

• 広告ごとに、見出しや説明文が異なる複数のバリエーションを持つことがあります

FAQ

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（Desktop と Web）、Cursor、Manus、その他 Model Context Protocol に対応する任意のクライアントで動作します。

無料版はありますか？ あります。Proxy のホスト版 に無料枠があるので、セットアップなしで広告分析を始められます。

セルフホストするべきか、ホスト版を使うべきですか？ 手間なく高速かつ安定して Google Ads Transparency Center のデータにアクセスしたいなら、ホスト版 を選んでください。ほとんどの人にはこれが最適です。サーバーコードを自分で変更・拡張したい人だけセルフホストを選びましょう。

フィードバック

皆さんのフィードバックを心からお待ちしています。このリストの次の機能として実装してほしいものや、完全に新しい機能のリクエストがある場合は、ぜひお知らせください。

ライセンス

このプロジェクトは MIT ライセンスの下に公開されています。

Proxy のチームより ❤️ を込めて作られました。