facebook-ads-library-mcp

Overview

This MCP server provides access to Facebook's public ads library, allowing users to search for any company's current ad campaigns. It features batch processing capabilities for querying multiple brands simultaneously, smart credit management for API costs, and enhanced video analysis using Google's Gemini AI. The server includes intelligent caching and request deduplication for improved performance, while maintaining backward compatibility with existing workflows.

Try asking AI

After installing, here are 5 things you can ask your AI assistant:

• get_meta_platform_id

  Returns platform ID given one or many brand names

  Try:Get the platform ID for 'Nike'Try:Find platform IDs for Nike, Adidas, and Under Armour
• get_meta_ads

  Retrieves ads for specific page(s) (platform ID)

  Try:Get ads for Nike's platform IDTry:Retrieve ads for multiple platform IDs including Nike and Adidas
• analyze_ad_image

  Analyzes ad images for visual elements, text, colors, and composition

  Try:Analyze Nike's latest ad image for visual elements and brand messagingTry:Extract text and visual elements from this ad image
• analyze_ad_video

  Analyzes single ad video using Gemini AI for comprehensive insights

  Try:Analyze Nike's new ad video for storytelling strategyTry:Extract key messaging from this video ad
• analyze_ad_videos_batch

  Analyzes multiple videos in single API call for token efficiency

  Try:Analyze Nike, Adidas, and Under Armour's video ads togetherTry:Compare messaging in multiple video ads from different brands
• get_cache_stats

  Gets statistics about cached media and storage usage

  Try:Show me cache statistics for analyzed mediaTry:How much space is being used by cached media?
• search_cached_media

  Searches previously analyzed media by brand, colors, people, or media type

  Try:Search for previously analyzed Nike adsTry:Find all cached media with blue color scheme
• cleanup_media_cache

  Cleans up old cached media files to free disk space

  Try:Clean up old cached media filesTry:Free up disk space by removing old analyzed media

Comparable tools

Installation

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

{
  "mcpServers": {
    "fb_ad_library": {
      "command": "{{PATH_TO_PROJECT}}/facebook-ads-library-mcp/venv/bin/python",
      "args": [
        "{{PATH_TO_PROJECT}}/facebook-ads-library-mcp/mcp_server.py"
      ]
    }
  }
}

FAQ

What API keys do I need?

You need a ScrapeCreators API key required for accessing the Facebook Ads Library. Optionally, you can add a Google Gemini API key for enhanced video analysis capabilities.

How do I handle API credit exhaustion?

When credits are exhausted, the server will provide a direct link to the ScrapeCreators dashboard where you can purchase additional credits. The server will automatically resume working once credits are available.

Compare facebook-ads-library-mcp with