Agent skill · marketing growth · aradotso
facebook-ads-library-mcp-server
MCP server for querying and analyzing Facebook Ads Library data with batch processing and AI-powered video/image analysis
Why this skill is useful
Adds batch processing capabilities and AI-powered analysis scripts for Facebook Ads that are not available in public documentation.
What it needs
Requires git, python3 installed locally. Requires google, scrapecreators account access. About 6k tokens when loaded. Last updated 2026-08-05. 8 stars on the source repository.
What this skill does
Facebook Ads Library MCP Server Skill by ara.so — Marketing Skills collection This MCP (Model Context Protocol) server enables AI agents to query Facebook's public Ads Library API, retrieve advertising data for brands, and perform AI-powered analysis of ad creative including images and videos. It supports batch processing for efficient multi-brand queries and includes intelligent caching and credit management. What It Does Brand Search: Convert brand names to Meta platform IDs Ad Retrieval: Fetch currently running ads for one or multiple brands Image Analysis: Analyze ad images for visual elements, text, colors, and composition Video Analysis: Deep analysis of video ads using Gemini AI (pacing, storytelling, messaging) Batch Processing: Query multiple brands or platform IDs simultaneously with ~88% token savings Smart Caching: Reduces API calls and improves performance Credit Management: Automatic detection of API credit exhaustion Installation Quick Install Manual Setup MCP Configuration Claude Desktop (~/Library/Application Support/Claude/claudedesktopconfig.json): Cursor (~/.cursor/mcp.json): Replace /full/path/to/ with your actual project path. API Keys Required 1. ScrapeCreators API (required): Sign up at scrapecreators.com 2. Google Gemini API (optional, for video analysis): Get key at Google AI Studio Store keys in .env file: Available MCP Tools 1. getmetaplatformid Converts brand name(s) to Meta platform ID(s). Input: Single brand name (string) or multiple brands (array) Output: 2. getmetaads Retrieves currently running ads for platform ID(s). Input: Single platform ID (string) or multiple IDs (array) Output: 3. analyzeadimage Analyzes visual elements in ad images. Input: Output: Detailed analysis of colors, composition, text, people, emotions, and visual elements. 4. analyzeadvideo Analyzes a single video ad using Gemini AI. Input: Output: Comprehensive analysis including pacing, storytelling, brand messaging, visual techniques, and strategic insights. 5. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills aradotso/facebook-ads-library-mcp-server