Facebook Ads Library Mcp

Facebook Ads Library MCP サーバー

Proxy（useproxy.dev）は、無料で利用できるホスト型の広告ライブラリ MCP サーバーです。 1 回接続するだけで、ChatGPT、Claude、Cursor などあらゆる MCP クライアントから、Meta、Google、LinkedIn、TikTok（EU）の広告ライブラリに掲載されている広告をリアルタイムで取得できます。API キーは不要で、1 日あたり 20 クレジットを無料で利用できます。このリポジトリは、オープンソースのセルフホスト可能な Facebook Ads Library サーバーです。ホスト版を 2 分で利用する →

これは、Facebook Ads Library 用の Model Context Protocol（MCP）サーバーです。

このサーバーを使うと、Facebook の公開広告ライブラリから企業やブランドの広告を検索し、現在配信中の広告を確認して、広告を分析できます。広告画像やテキスト、動画広告の包括的なインサイトを分析したり、企業間の戦略を比較したり、キャンペーンで効果を上げている要素についてインサイトを得たりできます。

Claude に接続した場合にできることの例を紹介します。

https://github.com/user-attachments/assets/a47aa689-e89d-4d4b-9df7-6eb3a81937ee

---

ホスト版（推奨）

Facebook Ads Library MCP を最も手軽に使う方法は、Proxy（useproxy.dev） のホスト版です。 API キーも Gemini キーも Python も、実行するサーバーも不要です。接続するだけですぐに検索できます。

• ⚡ セットアップ不要 — インストール、設定、メンテナンスは不要です
• 🔑 API キー不要 — ScrapeCreators と Gemini のキーは必要ありません
• 🔌 どこでも利用可能 — ChatGPT、Claude、Cursor、Manus など、MCP に対応するあらゆる環境で利用できます
• 🚀 常に最新 — 新しいツールや修正は自動的に反映されます

👉 useproxy.dev で無料で始める →

自分で実行したい場合は、セルフホストのセットアップ方法を以下に記載しています。

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

	ホスト版 — Proxy（useproxy.dev）	セルフホスト版
セットアップ時間	不要 — 接続するだけです	Python 環境 + 設定
必要な API キー	なし	ScrapeCreators + Gemini
インフラストラクチャ	完全管理	自分で実行・メンテナンスします
更新	自動	手動で git pull
ChatGPT、Claude、Cursor、Manus での動作	✅	✅
おすすめの対象	データを手軽に利用したいほとんどのユーザー	コードをカスタマイズしたい開発者

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

---

プロンプトの例

単一ブランドの分析

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.

一括分析（新機能！）

Compare the current advertising strategies across Nike, Adidas, and Under Armour. Show me their ad volumes, messaging themes, and creative approaches.

Do a deep comparison to the messaging between 'AnthropicAI', 'Perplexity AI' and 'OpenAI'. Give it a nice forwardable summary.

Analyze the holiday campaign strategies for Coca-Cola, Pepsi, Dr Pepper, and Sprite. What themes are they using?

Get the current ads for all major streaming services: Netflix, Disney+, Hulu, HBO Max, Amazon Prime Video, and Apple TV+. Compare their positioning strategies.

---

インストール

前提条件

• 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/facebook-ads-library-mcp.git
 cd facebook-ads-library-mcp

 # For macOS/Linux:
 ./install.sh

 # For Windows:
 install.bat

インストールスクリプトによって、次の処理が実行されます。

• 依存関係を分離するための仮想環境を作成します
• 必要な依存関係をすべてインストールします
• 設定ファイルをセットアップします

2. API キーを設定する 作成された .env ファイルを編集し、API キーを追加します。

• 広告データ API キーを SCRAPECREATORS_API_KEY に設定します
• Google AI Studio で Gemini API キーを取得します（任意、動画分析用）

3. 表示された MCP 設定に従う インストールスクリプトにより、Claude Desktop または Cursor に追加する正確な設定が表示されます。

手動インストール

手動でインストールする場合：

1. このリポジトリをクローンする

 git clone https://github.com/proxy-intell/facebook-ads-library-mcp.git
 cd facebook-ads-library-mcp

2. 仮想環境を作成し、依存関係をインストールする

 python3 -m venv venv
 ./venv/bin/pip install -r requirements.txt

3. API キーを設定する テンプレートをコピーし、API キーを設定します。 API キーの取得方法：

• 広告データ API キーを .env ファイルの SCRAPECREATORS_API_KEY に設定します
• こちらで Google Gemini API キーを取得します（任意、動画分析用）

4. MCP サーバーに接続する MCP サーバーの設定を Claude Desktop または Cursor の設定ファイルに追加します。 {{PATH_TO_PROJECT}} を、このリポジトリをクローンした場所の絶対パスに置き換えます。 注： この設定では、依存関係の分離と信頼性を高めるため、仮想環境の Python インタープリター（venv/bin/python）を使用します。 注： API キーは .env ファイルから自動的に読み込まれるため、コマンドライン引数として渡す必要はありません。 Claude Desktop の場合： Claude Desktop の設定ディレクトリに claude_desktop_config.json として保存します。設定ディレクトリは次の場所にあります。 Cursor の場合： Cursor の設定ディレクトリに mcp.json として保存します。設定ディレクトリは次の場所にあります。
5. Claude Desktop / Cursor を再起動する Claude Desktop を開くと、Facebook Ads Library が利用可能な連携機能として表示されます。 または、Cursor を再起動します。

---

技術的な詳細

1. Claude が Python MCP サーバーにリクエストを送信します
2. MCP サーバーが広告データ API へのクエリをインテリジェントにバッチ処理し、最適化します
3. スマートキャッシュによって重複する API 呼び出しが減り、パフォーマンスが向上します
4. クレジットの監視と事前のエラー処理により、ワークフローの中断を防ぎます
5. 拡張されたバッチ情報とともに、データが一連の処理を通じて Claude に返されます

利用可能な MCP ツール（拡張版）

この MCP サーバーは、Facebook Ads ライブラリのオブジェクトを操作するためのツールを提供します。

ツール名	説明	バッチ対応
get_meta_platform_id	1 つ以上のブランド名を指定してプラットフォーム ID を返します	✅ 複数のブランドに対応
get_meta_ads	指定したページ（プラットフォーム ID）の広告を取得します	✅ 複数のプラットフォーム ID に対応
analyze_ad_image	広告画像の視覚要素、テキスト、色、構成を分析します	⚡ キャッシュを強化
analyze_ad_video	Gemini AI を使用して単一の広告動画を分析し、包括的なインサイトを提供します	⚡ キャッシュを強化
analyze_ad_videos_batch	新機能 - 複数の動画を 1 回の API 呼び出しで分析し、トークン効率を高めます	🎬 トークンを約 88% 削減
get_cache_stats	キャッシュされたメディア（画像と動画）およびストレージ使用量の統計を取得します	-
search_cached_media	ブランド、色、人、メディアタイプで、分析済みのメディアを検索します	-
cleanup_media_cache	ディスク容量を確保するため、古いキャッシュ済みメディアファイルを削除します	-

---

トラブルシューティング

よくある問題

🆕 API クレジットの残高不足：

• 「API クレジットの残高不足」というメッセージが表示された場合は、アカウントにクレジットを追加してください
• エラーメッセージには、プロバイダーのダッシュボードへの直接リンクが含まれています
• そこで現在のクレジット残高を確認し、クレジットを追加購入できます
• クレジットが利用可能になると、サーバーは自動的に動作を再開します

🆕 レート制限超過：

• レート制限に達すると、サーバーが待ち時間を通知します
• バッチ処理を利用すると、レート制限に達する可能性を減らせます
• 大規模なバッチリクエストで頻繁に制限に達する場合は、リクエスト間隔を空けてください

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 設定のパスが正しい場所を指していることを確認してください
• 仮想環境を作成し、python3 -m venv venv && ./venv/bin/pip install -r requirements.txt で依存関係をインストールしたことを確認してください
• MCP 設定で、仮想環境の Python パス（末尾が /venv/bin/python）を使用していることを確認してください
• 設定を変更した後は、Claude Desktop/Cursor を再起動してください

Claude Desktop との連携に関するその他のトラブルシューティングについては、MCP ドキュメントを参照してください。ログの確認や一般的な問題の解決に役立つヒントが掲載されています。

---

よくある質問

Facebook Ads Library MCP を最も簡単に使う方法は何ですか？ 最も簡単なのは、Proxy（useproxy.dev）のホスト版を利用する方法です。API キーもインストールもサーバーも不要です。ChatGPT、Claude、Cursor、その他の MCP クライアントに接続すれば、すぐにクエリを開始できます。無料で始められます。

この MCP を使うには API キーが必要ですか？ セルフホストする場合に限り必要です。useproxy.dev のホスト版ではすべてのデータアクセスが処理されるため、ScrapeCreators または Gemini のキーは不要です。セルフホストするには SCRAPECREATORS_API_KEY が必要です（動画分析には Gemini キーも必要です）。

どの MCP クライアントで使えますか？ ホスト版とセルフホスト版のどちらも、ChatGPT、Claude（デスクトップ版とウェブ版）、Cursor、Manus、および Model Context Protocol に対応するその他すべてのクライアントで利用できます。

無料版はありますか？ はい。Proxy のホスト版には無料プランがあり、セットアップ不要ですぐに広告の分析を始められます。

セルフホストとホスト版のどちらを使うべきですか？ メンテナンスなしで Facebook Ads Library のデータにすばやく安定してアクセスしたい場合は、ホスト版をご利用ください。ほとんどのユーザーに適しています。サーバーコードを自分で変更または拡張したい場合に限り、セルフホストしてください。

---

フィードバック

皆さまからのフィードバックを心よりお待ちしております。次に追加してほしい機能や、まったく新しい機能のご要望をお知らせください。

---

関連リンク

• Proxy ホスト型 MCP：4つすべての広告ライブラリを1つのホスト型サーバーに集約、OAuth 対応、キー不要
• Google Ads Library MCP（セルフホスト型）
• LinkedIn Ads Library MCP（セルフホスト型）
• TikTok Ads Library MCP（セルフホスト型）
• すべてのクライアント向けインストールガイド

---

ライセンス

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

---

Proxy のチームが ❤️ を込めて作成しました。