Facebook Ads Library MCP

🚀 Facebook Ads Library MCP Server

このサーバーは、Facebook Ads Library用のModel Context Protocol (MCP) サーバーです。これを使用すると、任意の企業やブランドについてFacebookの公開広告ライブラリを検索し、現在実行中の広告を確認し、広告を分析することができます。広告の画像やテキストを分析し、ビデオリンクを取得し、企業の戦略を比較し、キャンペーンの有効な要素を洞察することができます。

Claudeに接続した場合の使用例を以下に示します。

使用例のリンク

このプロジェクトや他のプロジェクトの更新情報を受け取るには、ここにメールアドレスを入力 してください。

🚀 クイックスタート

このサーバーを使用することで、Facebookの広告ライブラリを通じて企業やブランドの広告を分析できます。Claudeと接続することで、具体的な質問を投げかけ、広告に関する洞察を得ることが可能です。

✨ 主な機能

• 任意の企業やブランドのFacebook広告ライブラリを検索
• 広告の画像やテキストを分析
• ビデオリンクの取得
• 企業間の広告戦略の比較
• キャンペーンの有効な要素の洞察

💻 使用例

基本的な使用法

以下は、Claudeに対して投げかけることができる質問の例です。

How many ads is 'AnthropicAI' running? What’s their split across video and image?

What messaging is 'AnthropicAI' running right now in their ads?

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 のアクセストークン

手順

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

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

2. Scrape CreatorsからAPIトークンを取得する

   ここ でサインアップします。

3. MCPサーバーに接続する

   適切な {{PATH}} 値と {{API KEY}} を持つ以下のJSONをコピーします。

   {
     "mcpServers": {
       "fb_ad_library": {
         "command": "python",
         "args": [
           "{{PATH_TO_SRC}}/fb_ad_library_mcp/src/mcp_server.py",
           "--scrapecreators-api-key",
           "{{YOUR_SCRAPECREATORS_API_KEY}}"
         ]
       }
     }
   }
   

   Claude Desktopの場合:

   これを claude_desktop_config.json として、Claude Desktopの設定ディレクトリに保存します。

   ~/Library/Application Support/Claude/claude_desktop_config.json
   

   Cursorの場合:

   これを mcp.json として、Cursorの設定ディレクトリに保存します。

   ~/.cursor/mcp.json
   

4. Claude Desktop / Cursorを再起動する

   Claude Desktopを開くと、Facebook Ads Libraryが利用可能な統合として表示されるはずです。

   または、Cursorを再起動します。

🔧 技術詳細

1. ClaudeがPython MCPサーバーにリクエストを送信します。
2. MCPサーバーがツールを通じてScrapeCreator APIにクエリを実行します。
3. データがチェーンを通じてClaudeに戻ります。

利用可能なMCPツール

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

📄 ライセンス

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