Facebook Ads Library MCP Server
This is a Model Context Protocol (MCP) server for the Facebook Ads Library.
Potencialize seu agente
Instalação do publicador. Não é um endpoint do PlugMCP.
Host a copy with our keys and logs.
Ainda não há uma versão empacotada no registro. Siga o README do repositório.
URL remota ou um comando na sua máquina? Como as duas instalações diferem
Rodar no PlugMCP
A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.
AbrirWith 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 from Proxy (useproxy.dev). No API keys, no Gemini key, no Python, no server to run — just connect and start querying.
Prefer to run it yourself? The full self-host setup is documented below.
For most people, the hosted version is 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 -m pip installSCRAPECREATORS_API_KEY (see configuration below)Prefer not to deal with API keys? See the Hosted Version above 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
The install script will:
.env file that was created and add your API keys:SCRAPECREATORS_API_KEYIf you prefer to install manually:
git clone https://github.com/proxy-intell/facebook-ads-library-mcp.git
cd facebook-ads-library-mcp
python3 -m venv venv
./venv/bin/pip install -r requirements.txt
SCRAPECREATORS_API_KEY in the .env file{{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 .env file, so you don't need to pass them as command line arguments.
For Claude Desktop:
Save this as claude_desktop_config.json in your Claude Desktop configuration directory at:
For Cursor:
Save this as mcp.json in your Cursor configuration directory at:This MCP server provides tools for interacting with Facebook Ads library objects:
🆕 API Credits Exhausted:
🆕 Rate Limit Exceeded:
API Key Not Found Error:
.env file is in the project root directory.env file, copy it from the template: cp .env.template .env.env file contains SCRAPECREATORS_API_KEY=your_key_hereGEMINI_API_KEY=your_key_here is also addedVideo Analysis Not Working:
.env fileGEMINI_API_KEY environment variableMCP Server Connection Issues:
python3 -m venv venv && ./venv/bin/pip install -r requirements.txt/venv/bin/python)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.dev handles all data access for you, so no ScrapeCreators or Gemini keys are needed. Self-hosting requires a SCRAPECREATORS_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 Proxy offers a free tier so you can start analyzing ads without any setup.
Should I self-host or use the hosted version? Use the hosted version if 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 us which features on that list you like to see next or request entirely new ones.
This project is licensed under the MIT License.
Made with ❤️ by the team at Proxy.
MCP Server for Facebook ADs Library - Get instant answers from FB's ad library
Ferramentas
Ainda não há lista de ferramentas. Servidores remotos recebem uma após a primeira verificação de saúde.
Perguntas frequentes
Copie nesta página a configuração stdio para Cursor, Claude Desktop, Claude Code ou VS Code. Ela usa a instalação do publicador, não um proxy do PlugMCP.
Este registro não lista nenhuma variável de ambiente obrigatória.
Facebook Ads Library roda localmente via stdio.
Última verificação: 2026-11-16. MCP Server for Facebook ADs Library - Get instant answers from FB's ad library