mcpField
M
mcp-facebook-posts-scraper

mcp-facebook-posts-scraper

Local
github.com/mambalabsdevSocial Media0Updated 2d ago

About mcp-facebook-posts-scraper

An Apify-backed MCP server that retrieves public Facebook Page posts as rows. It is intended for users collecting post text, dates, reactions, comments, shares, media type, and links from Pages.

Key features

  1. 01Fetch posts from public Pages
  2. 02Return dates and post text
  3. 03Include reactions, comments, and shares
  4. 04Report media type and link
  5. 05Limit results by date

Use cases

  1. 01Collect recent posts from a Facebook Page
  2. 02Review Page posts from a chosen date
  3. 03Compare engagement details across posts

MCP support

Exposes the `get_facebook_page_posts` tool to MCP clients. It starts the Apify actor, waits for its run, and returns dataset rows.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
"mcpServers": {
"com-mambabuilt-mcp-facebook-posts-scraper": {
"command": "npx",
"args": [
"-y",
"@mambalabsdev/mcp-facebook-posts-scraper"
],
"env": {
"APIFY_TOKEN": "<APIFY_TOKEN>"
}
}
}
}
Run commandnpx -y @mambalabsdev/mcp-facebook-posts-scraper
Environment variables to set
APIFY_TOKENSecretApify API token from https://console.apify.com/account/integrations

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npm@mambalabsdev/mcp-facebook-posts-scraper1.0.2

Tools

1

Saved tool list · updated 2d ago

ParameterTypeRequiredDescription
pagesarrayNoPublic Page names or facebook.com addresses, for example NASA. Groups and personal profiles are not read. In Clay, put the column inside a one item list.
since_datestringNoOptional date like 2026-01-31. Reading stops at the first post older than this.
max_charge_usdnumberNoOptional. The run stops before a charge that would pass this amount. Summary rows are always returned.
max_posts_per_pagenumberNoText number from 1 to 500. Default 20.

Details

From the project README

Facebook Posts Scraper MCP Server

MCP Registry npm version npm downloads license

An MCP server for the Mamba Labs Facebook Posts Scraper actor on Apify. Public Facebook Page posts as rows.

What's Inside

What it does

Takes public Facebook Page names or addresses and returns one row per post with date, text, reactions, comments, shares, media type, and link.

All of the work runs on Apify. This package is a thin client that starts the actor run, waits for it, and hands back the dataset rows.

Quick start

You need Node.js 18 or newer and an Apify account with an API token.

Add this to your Claude Desktop config (claude_desktop_config.json), Cursor, or any MCP client:

{
  "mcpServers": {
    "mamba-facebook-posts-scraper": {
      "command": "npx",
      "args": [
        "-y",
        "@mambalabsdev/mcp-facebook-posts-scraper"
      ],
      "env": {
        "APIFY_TOKEN": "your-apify-token"
      }
    }
  }
}

Restart the client. The get_facebook_page_posts tool appears.

Prerequisites

Example prompts

  • "Get the last 20 posts from the NASA Facebook Page."
  • "Get posts since 2026-10-01 from these Facebook Pages."

Tool

get_facebook_page_posts. One tool. Example arguments:

{
  "pages": [
    "NASA"
  ],
  "max_posts_per_page": 5
}

Inputs

Every buyer facing input of the actor. Omitted inputs take the actor's own defaults.

InputTypeRequiredDescription
pagesarraynoPublic Page names or facebook.com addresses, for example NASA. Groups and personal profiles are not read. In Clay, put the column inside a one item list.
max_posts_per_pagenumbernoText number from 1 to 500. Default 20.
since_datestringnoOptional date like 2026-01-31. Reading stops at the first post older than this.
max_charge_usdnumbernoOptional. The run stops before a charge that would pass this amount. Summary rows are always returned.

Pricing

Pay per event on Apify, billed to your Apify account. Prices in USD.

EventFree planBronzeSilverGold
post-row, one post$0.0075$0.007125$0.00675$0.006375
apify-actor-start, per run start$0.003$0.003$0.003$0.003

Page status rows and refused input are free. Mamba Labs pays the platform costs of the run, Apify proxy traffic included.

Full actor documentation

apify.com/mambalabs/facebook-posts-scraper

License

MIT. See LICENSE.

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.