Facebook Ads Library MCP

🚀 Facebook Ads Library MCP Server

This server is a Model Context Protocol (MCP) server designed for the Facebook Ads Library. It allows you to search the public ads library of Facebook for any company or brand. You can view their current ads and conduct advertising analysis. This includes analyzing ad images and text, obtaining video links, comparing companies' advertising strategies, and gaining insights into the effectiveness of their campaigns.

Here is an example of what you can do when it's connected to Claude: Example Link

To get updates on this and other projects we work on, enter your email here

🚀 Quick Start

✨ Features

• Search the Facebook public ads library for any company or brand.
• Analyze ad images, text, and get video links.
• Compare different companies' advertising strategies.
• Gain insights into the effectiveness of advertising campaigns.

💻 Usage Examples

Basic Usage

Here are some example prompts you can use:

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.

Don't want to deal with code? Try our no-code version

📦 Installation

Prerequisites

• Python 3.12+
• Anthropic Claude Desktop app (or Cursor)
• Pip (Python package manager), install with python -m pip install
• An access token for Scrape Creators

Steps

1. Clone this repository

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

2. Obtain an API token from Scrape Creators Sign up here
3. Connect to the MCP server Copy the below json with the appropriate {{PATH}} values and {{API KEY}}:

   {
     "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}}"
         ]
       }
     }
   }
   

   For Claude Desktop: Save this as claude_desktop_config.json in your Claude Desktop configuration directory at:

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

   For Cursor: Save this as mcp.json in your Cursor configuration directory at:

   ~/.cursor/mcp.json
   

4. Restart Claude Desktop / Cursor Open Claude Desktop and you should now see the Facebook Ads Library as an available integration. Or restart Cursor.

🔧 Technical Details

1. Claude sends requests to the Python MCP server.
2. The MCP server queries the ScrapeCreator API through tools.
3. Data flows back through the chain to Claude.

Available MCP Tools

This MCP server provides tools for interacting with Facebook Ads library objects:

Troubleshooting

For additional Claude Desktop integration troubleshooting, see the MCP documentation. The documentation includes helpful tips for checking logs and resolving common issues.

Feedback

Your feedback will be massively appreciated. Please tell us which features on that list you like to see next or request entirely new ones.

📄 License

This project is licensed under the MIT License.