FbAdLibraryMCPServer

Name: FbAdLibraryMCPServer
Author: StinCodes

@StinCodes

关于 FbAdLibraryMCPServer

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.

基本信息

分类

开发工具

运行时

node

传输方式

stdio

发布者

StinCodes

配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

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

工具

未检测到工具

工具是从 README 中自动提取的。维护者可以在 ## Tools 标题下列出工具,即可填充这部分内容。

概览

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

FAQ from FbAdLibraryMCPServer

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.

开发工具分类下的更多 MCP 服务器

MCP Containers

metorial

Connect any AI model to 1200+ integrations (MCP, CLI, API)

3.3K

Test

x1xhlol

FULL Augment Code, Claude Code, Cluely, CodeBuddy, Comet, Cursor, Devin AI, Junie, Kiro, Leap.new, Lovable, Manus, NotionAI, Orchids.app, Perplexity, Poke, Qoder, Replit, Same.dev, Trae, Traycer AI, VSCode Agent, Warp.dev, Windsurf, Xcode, Z.ai Code, Dia & v0. (And other Open Sou

141.7K