FbAdLibraryMCPServer MCP Server

@StinCodes

Basic information

About FbAdLibraryMCPServer MCP Server

Build a Model Context Protocol (MCP) server that provides access to Facebook's Ad Library through web scraping. The server should allow clients to search for advertisements with various filters and retrieve comprehensive ad data.

FbAdLibraryMCPServer MCP Server config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "FbAdLibraryMCPServer": {
      "command": "npx",
      "args": [
        "playwright",
        "install"
      ]
    }
  }
}

FbAdLibraryMCPServer MCP Server tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

Fetch the live tool list by running this server in a temporary sandbox using the button above.

Overview

What is FbAdLibraryMCPServer?

FbAdLibraryMCPServer is an MCP server that provides access to Facebook's Ad Library through web scraping. It exposes a single MCP tool for searching advertisements with comprehensive filtering options.

How to use FbAdLibraryMCPServer?

Install dependencies (npm install and npx playwright install), then start the server with npm run dev (development) or npm run build && npm start (production). Connect any MCP-compatible client to the HTTP endpoint (default http://localhost:3000/mcp). Use the built-in search_ads tool with parameters such as company, start_date, end_date, keywords, limit, and order.

Key features of FbAdLibraryMCPServer

MCP-compliant, built using the official MCP SDK
Extracts full ad data: advertiser, content, dates, impressions, spend
Advanced filtering by company, date range, and keywords
Smart pagination retrieves up to 100 ads per search
Flexible sorting by date (ascending/descending) or relevance
Anti-bot detection countermeasures for reliable scraping

Use cases of FbAdLibraryMCPServer

Researching competitor advertising strategies
Analyzing ad content, impressions, and spending patterns
Tracking ad campaigns for specific companies over time
Studying ad targeting demographics for academic research

Frequently asked questions

What MCP tool does the server expose?

The server exposes a single tool called `search_ads` that accepts optional parameters for company, dates, keywords, limit, and sort order.

What is the maximum number of ads returned per search?

The server can return up to 100 ads per search. The default limit is 50.

Does the server require authentication?

No authentication is required to connect to the server's HTTP endpoint.

How does the server handle anti-bot detection?

It uses virtual display (Xvfb), natural navigation patterns, simplified browser configuration, a 30-second browser launch timeout, and different behavior in production vs development to bypass Facebook's detection.

What are the known limitations of FbAdLibraryMCPServer?

The server runs in non-headless mode, is limited to 100 ads per search, date formats depend on Facebook's display, and it is subject to Facebook's anti-bot measures.

Comments

More Developer Tools MCP servers

Modelglass

Modelglass turns "which model should I use?" into a lookup instead of a guess. Seven tools give your agent live pricing across image, language, video, and audio models. Sourced and versioned, not scraped once and forgott

SSH MCP Server

hypnosis

SSH MCP server for AI agents: remote commands, file transfer, log search and server audits through OpenSSH.

LastPing

Know when your AI agents, cron jobs and CI pipelines fail, stall or go quiet. Your agent sets up monitors from a plain description, tells you what is broken and why, reads run history and traces, and writes notes on inci

LocalCan

Gives AI agents public URLs (tunnels) for localhost, live HTTP traffic inspection, snapshot publishing, and access control. Part of LocalCan, the ngrok alternative for Mac, Windows and Linux. Free plan.

ArtiBot Cloud MCP - Zhijiangyun 智匠云

bofob

ArtiBot Cloud MCP (Zhijiangyun 智匠云) — cloud MCP server for robot manipulation data & GPU workloads. 15 tools: robot fleet management, data collection & video recording, post-processing pipelines, and benchmark evaluation