Repository avatar
Monitoring
v0.1.0
active

scrapeadlibrary

com.scrapeadlibrary/scrapeadlibrary

Search the public Meta Ad Library: ads, creatives, EU transparency data and advertisers.

Documentation

ScrapeAdLibrary MCP Server

An MCP server that lets AI assistants (Claude Desktop, Claude Code, Cursor, Cline...) search the public Meta Ad Library (Facebook, Instagram, Messenger, Audience Network, Threads) through the ScrapeAdLibrary API: competitor ads, creatives, advertisers, political ad spend, EU (DSA) reach and targeting.

Features

5 Tools — search ads, ad detail, advertiser profile, advertiser's ads, advertiser search

4 Documentation Resources — API reference, quickstart, pricing, workflow examples

3 Prompt Templates — competitor ad research, keyword market scan, single ad analysis

Connect without installing (Claude, ChatGPT, Claude Code)

The same tools are available as a hosted remote MCP server with OAuth sign-in: no API key to copy, nothing to install. Add this URL as a custom connector and sign in with your ScrapeAdLibrary account:

https://api.scrapeadlibrary.com/mcp
  • Claude (web, Desktop, mobile): Customize → Connectors → Add custom connector.
  • ChatGPT: chatgpt.com/plugins → Add custom MCP server → OAuth.
  • Claude Code: claude mcp add --transport http scrapeadlibrary https://api.scrapeadlibrary.com/mcp, then /mcp to sign in.

Calls use your account's credits with the API's pricing. Step-by-step guide: scrapeadlibrary.com/docs/mcp.

Quick Start (local server with an API key)

1. Get an API Key

Sign up at scrapeadlibrary.com and create an API key (starts with sal_).

2. Configure Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "scrapeadlibrary": {
      "command": "uvx",
      "args": ["scrapeadlibrary-mcp"],
      "env": {
        "SCRAPEADLIBRARY_API_KEY": "sal_your_key_here"
      }
    }
  }
}

3. Use it

Ask Claude:

  • "What ads is Nike running in Italy right now? Summarise their messaging."
  • "Show me active video ads about 'protein powder' in the US, sorted by impressions"
  • "Which advertisers run ads for 'running shoes'?"
  • "Get the EU reach and targeting of ad 1550534860016399"

Configuration for Other Clients

Cursor

Add the same JSON block to .cursor/mcp.json.

Claude Code

claude mcp add scrapeadlibrary -e SCRAPEADLIBRARY_API_KEY=sal_your_key_here -- uvx scrapeadlibrary-mcp

Installation Alternatives

pip

pip install scrapeadlibrary-mcp
SCRAPEADLIBRARY_API_KEY=sal_xxx scrapeadlibrary-mcp

npx

SCRAPEADLIBRARY_API_KEY=sal_xxx npx scrapeadlibrary-mcp

(The npm package is a thin wrapper: it runs the Python server via uvx, or python3 -m as a fallback.)

Docker

docker build -t scrapeadlibrary-mcp .
docker run -i --rm -e SCRAPEADLIBRARY_API_KEY=sal_xxx scrapeadlibrary-mcp

Tools

ToolDescriptionCostKey defaults
search_adsSearch ads by keyword and/or advertiser, with country, status, media, platform, language, date filters1 credit per 10 adslimit=10, status=active
get_adFull ad: text, media, cards, advertiser, payer/beneficiary, EU/UK transparency2 credits—
get_pageAdvertiser profile: category, likes, Instagram, active ads estimate1 credit—
get_page_adsAds of one advertiser1 credit per 10 adslimit=10, status=active
search_pagesAdvertisers that ran ads matching a keyword1 credit per 10 resultslimit=10

Empty results and errors cost 0 credits. Lists return a cursor to fetch the next page.

Environment Variables

VariableRequiredDescription
SCRAPEADLIBRARY_API_KEYYesYour API key (starts with sal_)
SCRAPEADLIBRARY_BASE_URLNoOverride API base URL (default: https://api.scrapeadlibrary.com)

Development

uv venv && uv pip install -e ".[dev]"
.venv/bin/pytest
.venv/bin/ruff check . && .venv/bin/ruff format --check .

Test with MCP Inspector:

SCRAPEADLIBRARY_API_KEY=sal_xxx .venv/bin/mcp dev dev_server.py

assets/logo-400.png is still the placeholder logo inherited from the template: replace it with the final brand logo before publishing to registries.

License

MIT

PYPI
scrapeadlibrary-mcp
Install Command
pip install scrapeadlibrary-mcp