Facebook Ad Library MCP
A small MCP server that scrapes the public Facebook Ad Library for competitive ad research — from your MCP client, with no Facebook account and no API token.
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.
AbrirDo publicador
A small MCP server that scrapes the public Facebook Ad Library for competitive ad research — from your MCP client, with no Facebook account and no API token.
Free, self-hosted MCP server that scrapes the public Facebook Ad Library (no API token) for competitive ad research — advertiser, copy, landing pages, CTAs, any country.
It exists because the paid Ad Library scrapers (Apify actors, ScrapeCreators, and friends) charge for something that is publicly visible in a browser. This just drives a headless browser instead.
Meta's ads_archive API only returns political & issue ads worldwide (and all ad
types only for the EU/UK). For an ordinary commercial advertiser in most of the world it
returns nothing useful — no ads, no spend, no impressions. So this server doesn't use it
at all. It renders the same Ad Library web page you'd open yourself and parses the cards.
Two tools:
search_ad_library(query, country="MX", ...) — keyword search.scrape_ad_library_url(url, ...) — scrape any Ad Library URL you already have.Both return structured records per ad:
Plus an advertisers histogram and the raw_markdown of the page so the model can pull
anything the parser missed.
git clone https://github.com/RamsesAguirre777/facebook-ads-library-mcp.git
cd facebook-ads-library-mcp
python -m venv venv && source venv/bin/activate
pip install -r requirements.txt
python -m playwright install chromium # crawl4ai needs a browser
Claude Code:
claude mcp add facebook-ads -- /abs/path/venv/bin/python /abs/path/facebook_ads_mcp_complete.py
Claude Desktop (claude_desktop_config.json):
{
"mcpServers": {
"facebook-ads": {
"command": "/abs/path/venv/bin/python",
"args": ["/abs/path/facebook_ads_mcp_complete.py"]
}
}
}
Restart the client.
"Search the Mexico Ad Library for 'automatización con inteligencia artificial',
group by advertiser, and list the landing domains."
"Scrape https://www.facebook.com/ads/library/?active_status=active&ad_type=all&country=MX&q=nike&search_type=keyword_unordered
with scroll_rounds=15 and summarise the creative angles."
Full discovery → website-teardown workflow: docs/examples.md.
scroll_rounds (default 8) — the Ad Library is infinite-scroll; the first paint is
only ~20–26 cards. Each round is a scroll-to-bottom + 2.5s wait. 0 = first render only
(fast); 15+ for a deep historical sweep. It trades time for completeness.wait_seconds (default 8) — SPA hydration wait before scraping. Raise it if results
come back empty.country — ISO code the ads were delivered in (MX, US, ES, …).advertiser_page_id — target one Page's "all ads" view. This view is heavier
client-rendered and doesn't always hydrate headless; a keyword search of the advertiser
name is more reliable.crawl4ai (AsyncWebCrawler) opens the Ad Library URL in headless Chromium, waits for
the React app to hydrate, runs a scroll loop to trigger lazy-loaded cards, serialises the
DOM to markdown, and a regex parser (_parse_ad_library_markdown) splits it on
Library ID: boundaries and pulls the fields above.
Facebook answers the headless browser with HTTP 403 but still serves the rendered cards, so the tools judge success by whether cards parsed, not by status code.
raw_markdown is always returned as a fallback.platforms often comes back empty — the FB/IG/Messenger markers render as icons, not
text, so they only survive when the page includes their labels.wait_seconds.python -m pytest tests/ -q
Offline — they exercise the markdown parser against a fixture.
MIT — see LICENSE.
Free, self-hosted MCP server that scrapes the public Facebook Ad Library (no API token) for competitive ad research — advertiser, copy, landing pages, CTAs, any country.
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-10-27. Free, self-hosted MCP server that scrapes the public Facebook Ad Library (no API token) for competitive ad research — advertiser, copy, landing pages, CTAs, any country.