Facebook Ads Library MCP Server

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.

✨ New Features

• 🚀 Batch Processing: Query multiple brands and platform IDs simultaneously to reduce API calls and improve efficiency
• 🎬 Video Batch Analysis: Analyze multiple videos in a single Gemini API call with ~88% token savings
• 💳 Smart Credit Management: Automatic detection of API credit exhaustion with direct links to top-up your ScrapeCreators account
• ⚡ Enhanced Performance: Intelligent caching and request deduplication for faster results
• 🔄 Backward Compatible: All existing queries work unchanged while gaining new batch capabilities

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

https://github.com/user-attachments/assets/a47aa689-e89d-4d4b-9df7-6eb3a81937ee

To try out the hosted version of ths MCP in ChatGPT, Claude, Manus or anywhere just subscribe here

Example Prompts

Single Brand Analysis

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.

Batch Analysis (New!)

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.

Installation

Prerequisites

• Python 3.12+
• Anthropic Claude Desktop app (or Cursor)
• Pip (Python package manager), install with python -m pip install
• An access token for Scrape Creators
• A Google Gemini API key for video analysis (optional, only needed for video ads)

Quick Install (Recommended)

1. Clone and run the install script

   git clone http://github.com/talknerdytome-labs/facebook-ads-library-mcp.git
   cd facebook-ads-library-mcp
   
   # For macOS/Linux:
   ./install.sh
   
   # For Windows:
   install.bat
   

   The install script will:

   • Create a virtual environment for dependency isolation
   • Install all required dependencies
   • Set up your configuration files

2. Configure your API keys

   Edit the .env file that was created and add your API keys:

   • Get your ScrapeCreators API key at scrapecreators.com
   • Get your Gemini API key at Google AI Studio (optional, for video analysis)

3. Follow the displayed MCP configuration

   The install script will show you the exact configuration to add to Claude Desktop or Cursor.

Manual Install

If you prefer to install manually:

1. Clone this repository

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

2. Create a virtual environment and install dependencies

   python3 -m venv venv
   ./venv/bin/pip insta
   

... View full README on GitHub