Facebook Ads Library

The Facebook Ads Library MCP Server connects Claude directly to Meta’s public advertising database through the Model Context Protocol.

It transforms Claude into a powerful advertising research tool that can search, analyze, and compare ad campaigns from any company or brand running Facebook advertisements.

Features

• 🔍 Company Ad Search – Find all active advertisements for any brand or company name
• 📊 Campaign Analysis – Break down ad spend distribution between video and image formats
• 📝 Messaging Extraction – Pull advertising copy and messaging strategies from live campaigns
• ⚖️ Competitive Comparison – Side-by-side analysis of multiple brands’ advertising approaches
• 🎯 Creative Intelligence – Access ad images, video links, and creative assets
• 📈 Performance Insights – Understand what messaging and formats competitors are actively running

Use Cases

• Competitive Research: Marketing teams can monitor competitors’ advertising strategies, messaging shifts, and creative approaches without manual Facebook browsing
• Campaign Planning: Agencies can analyze successful ad formats and messaging from industry leaders before launching client campaigns
• Market Intelligence: Business analysts can track advertising trends across multiple companies to identify market positioning and messaging patterns
• Content Strategy: Creative teams can examine high-performing ad copy and visual styles to inform their own campaign development

How to Use It

1. You need Python 3.12 or higher, Claude Desktop (or Cursor), pip package manager, and a Scrape Creators API token.

2. Clone the Repository.

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

3. Sign up at Scrape Creators to obtain your API token.

4. Configure MCP Connection. Create a configuration file with your paths and API key:

• For Claude Desktop: Save as claude_desktop_config.json in ~/Library/Application Support/Claude/
• For Cursor: Save as mcp.json in ~/.cursor/

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

5. Restart Claude Desktop or Cursor. The Facebook Ads Library integration will appear in your available tools.

6. Available Tools

• get_meta_platform_id: Converts brand names into Facebook platform IDs
• get_meta_ads: Retrieves all active advertisements for a specific platform ID

7. Usage Examples

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.

FAQs

Q: Do I need a Facebook Business account to use this MCP server?
A: No Facebook account required. This server accesses Meta’s public ads library, which contains all political and issue advertisements plus commercial ads that companies choose to make transparent.

Q: What’s the cost structure for the Scrape Creators API?
A: Scrape Creators operates on a credit-based system. Check their pricing page for current rates, but basic usage for competitive research typically costs a few dollars per month.

Q: Can I access historical ad data or just current campaigns?
A: The Facebook Ads Library contains both active and recently ended campaigns. You can access ads that have run within the past several months, not just currently active ones.

Q: What happens if a company name matches multiple Facebook pages?
A: The get_meta_platform_id tool returns platform IDs for all matching pages. You can then specify which page’s ads you want to analyze based on follower count, verification status, or page description.

Q: Are there rate limits I should know about?
A: Yes, both the Scrape Creators API and Facebook’s ads library have rate limits. The MCP server handles basic rate limiting, but heavy usage may require request spacing or upgraded API plans.

Q: Can I download the actual ad images and videos?
A: The server provides direct links to ad creatives hosted on Facebook’s CDN. You can view and analyze the content, but downloading would need to respect Facebook’s terms of service.