Home
Servers
Search
Facebook Ads Library

Facebook Ads Library

by trypeggy

303 downloads

Not rated

GitHub

About

Get any answer from the Facebook Ads Library, conduct deep research including messaging, creative testing and comparisons in seconds.

Details

Author: trypeggy
Downloads: 303
Categories: Search, Community, Other, Developer Tools

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below

Plugin Name Facebook Ads Library

Command (node, npx, python, etc.)

Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

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

JSON

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

JSON

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

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

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

JSON

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

JSON

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

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

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

JSON

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

JSON

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

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

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

JSON

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

JSON

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

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

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

JSON

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

JSON

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

From the repository

The server is self-hosted and requires configuration with a Scrape Creators API key. No specific invocation commands are documented; setup involves deploying the server and connecting it to an MCP client that supports tool calls.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "facebook ads library": {
            "fb_ad_library": {
                "command": "python",
                "args": [
                    "{{PATH_TO_SRC}}/fb_ad_library_mcp/src/mcp_server.py",
                    "--scrapecreators-api-key",
                    "{{YOUR_SCRAPECREATORS_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}}"
        ]
    }
}

Get any answer from the Facebook Ads Library, conduct deep research including messaging, creative testing and comparisons in seconds.

This is a Model Context Protocol (MCP) server for the Facebook Ads Library.

With this you can search Facebook's public ads library for any company or brand, see what they're currently running and analyze their advertising. You can analyze ad images/text, analyze video ads with comprehensive insights, compare companies' strategies, and get insights into what's working in their campaigns.

Here's an example of what you can do when it's connected to Claude.

The easiest way to use the Facebook Ads Library MCP is the hosted version fromProxy (useproxy.dev).No API keys, no Gemini key, no Python, no server to run — just connect and start querying.

- ⚡Zero setup— nothing to install, configure, or maintain
- 🔑No API keys— skip the ScrapeCreators and Gemini keys entirely
- 🔌Works everywhere— ChatGPT, Claude, Cursor, Manus, and anywhere else that supports MCP
- 🚀Always up to date— new tools and fixes ship automatically

👉Get started for free at useproxy.dev →

Prefer to run it yourself? The full self-host setup is documented below.

For most people, the hosted versionis the fastest path. Choose self-host if you specifically want to modify or extend the server yourself.

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 app (or Cursor)
- Pip (Python package manager), install withpython -m pip install
- An API key for an ads data provider, set asSCRAPECREATORS_API_KEY(see configuration below)
- A Google Gemini API key for video analysis (optional, only needed for video ads)

Prefer not to deal with API keys? See the Hosted Versionabove to skip setup entirely.

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

- Create a virtual environment for dependency isolation
- Install all required dependencies
- Set up your configuration files
- Configure your API keysEdit the.envfile that was created and add your API keys:

- Set your ads data API key asSCRAPECREATORS_API_KEY
- Get your Gemini API key at Google AI Studio(optional, for video analysis)
- Follow the displayed MCP configurationThe install script will show you the exact configuration to add to Claude Desktop or Cursor.

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

- Create a virtual environment and install dependencies

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

- Configure API keysCopy the template and configure your API keys:To obtain API keys:

- Set your ads data API key asSCRAPECREATORS_API_KEYin the.envfile
- Get a Google Gemini API key here(optional, for video analysis)
- Connect to the MCP serverAdd the MCP server configuration to your Claude Desktop or Cursor config: Replace{{PATH_TO_PROJECT}}with the full path to where you cloned this repository.Note:The configuration uses the virtual environment's Python interpreter (venv/bin/python) for better dependency isolation and reliability.Note:API keys are now automatically loaded from the.envfile, so you don't need to pass them as command line arguments.For Claude Desktop:Save this asclaude_desktop_config.jsonin your Claude Desktop configuration directory at:For Cursor:Save this asmcp.jsonin your Cursor configuration directory at:
- Restart Claude Desktop / CursorOpen Claude Desktop and you should now see the Facebook Ads Library as an available integration. Or restart Cursor.
- Claude sends requests to the Python MCP server
- The MCP server intelligently batches and optimizes queries to the ads data API
- Smart caching reduces redundant API calls and improves performance
- Credit monitoring prevents workflow interruption with proactive error handling
- Data flows back through the chain to Claude with enhanced batch information

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

- When you see an "API credits exhausted" message, you need to top up your account
- The error message includes a direct link to your provider's dashboard
- You can check your current credit balance and purchase more credits there
- The server will automatically resume working once credits are available

- If you hit rate limits, the server will tell you how long to wait
- Batch operations help reduce the chance of hitting rate limits
- Consider spacing out large batch requests if you frequently hit limits

- Ensure your.envfile is in the project root directory
- If you don't have a.envfile, copy it from the template:cp .env.template .env
- Check that your API keys are correctly formatted without quotes
- Verify the.envfile containsSCRAPECREATORS_API_KEY=your_key_here
- For video analysis, ensureGEMINI_API_KEY=your_key_hereis also added

- Confirm you have a valid Google Gemini API key in your.envfile
- Video analysis requires theGEMINI_API_KEYenvironment variable

- Verify the path in your MCP configuration points to the correct location
- Make sure you've created a virtual environment and installed dependencies withpython3 -m venv venv && ./venv/bin/pip install -r requirements.txt
- Ensure your MCP configuration uses the virtual environment Python path (ending with/venv/bin/python)
- Restart Claude Desktop/Cursor after configuration changes

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

What is the easiest way to use the Facebook Ads Library MCP?The easiest way is the hosted version from Proxy (useproxy.dev). It requires no API keys, no installation, and no server — you connect it to ChatGPT, Claude, Cursor, or any MCP client and start querying immediately. You can start for free.

Do I need an API key to use this MCP?Only if you self-host. The hosted version at useproxy.devhandles all data access for you, so no ScrapeCreators or Gemini keys are needed. Self-hosting requires aSCRAPECREATORS_API_KEY(and a Gemini key for video analysis).

Which MCP clients does it work with?Both the hosted and self-hosted versions work with ChatGPT, Claude (Desktop and web), Cursor, Manus, and any other client that supports the Model Context Protocol.

Is there a free version?Yes — the hosted version from Proxyoffers a free tier so you can start analyzing ads without any setup.

Should I self-host or use the hosted version?Use the hosted versionif you just want fast, reliable access to Facebook Ads Library data with zero maintenance — this fits most users. Self-host only if you want to modify or extend the server code yourself.

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

This project is licensed under the MIT License.

Search global news using natural language. Webz.io News Search API returns the most relevant articles and content, with filters for source, country, language, date, sentiment, and category.

Search for IP addresses using Chaitin's IP Intelligence API.

Google News search capabilities with automatic topic categorization and multi-language support via SerpAPI integration.

A Model Context Protocol (MCP) server providing access to Google Programmable Search Engine (PSE) and Custom Search Engine (CSE).

A Model Context Protocol (MCP) server providing access to Google Search Console.

A Model Context Protocol (MCP) server for the Open Library API that enables AI assistants to search for book and author information.

An enhanced MCP server for SearXNG web searching, utilizing a category-aware web-search, web-scraping, and includes a date/time retrieval tool.

Local RAG (on-premises) with MCP server.

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

Install

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

About

Details

Jump to

Setting up with Highlight

From the repository

Claude Desktop / Cursor

McpServers

Install

More like this

Sequential Thinking

Brave Search

Filesystem

EverArt

Google Drive

Reactive Resume