Skip to main content
Glama
Facebook Posts Scraper MCP Server

Facebook Posts Scraper MCP Server

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

Related MCP server: facebook-mcp

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.

Input

Type

Required

Description

pages

array

no

Public 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_page

number

no

Text number from 1 to 500. Default 20.

since_date

string

no

Optional date like 2026-01-31. Reading stops at the first post older than this.

max_charge_usd

number

no

Optional. 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.

Event

Free plan

Bronze

Silver

Gold

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.

Available Tools

1 tool
get_facebook_page_postsGet Facebook Page postsA
Read-onlyIdempotent

Get posts from public Facebook Pages. Returns one row per post with date, text, reactions, comments, shares, media type, and link.

NameRequiredDescriptionDefault
pagesNoPublic 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_dateNoOptional date like 2026-01-31. Reading stops at the first post older than this.
max_charge_usdNoOptional. The run stops before a charge that would pass this amount. Summary rows are always returned.
max_posts_per_pageNoText number from 1 to 500. Default 20.

TDQS

A4/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already declare readOnly, idempotent, openWorld and non-destructive, so safety needs no restatement. The description earns credit by disclosing the output shape (one row per post with named fields) in the absence of an output schema. It does not mention rate limits, historical depth limits, or cost behavior (left to the schema's max_charge_usd).

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Two sentences, no filler, purpose first and return shape second. Nothing is redundant with the name or title.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a read-only, zero-required-parameter collection tool with full schema coverage and annotations, the description plus schema cover what an agent needs to call it correctly and interpret results. Minor gaps: no note on pagination/limits or what happens when a Page is unavailable.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, and the descriptions there are strong (date cutoff semantics, charge cap, 1–500 post limit, one-item list convention). The tool description adds no parameter meaning beyond that, so baseline 3 applies.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

States a specific verb and resource (get posts from public Facebook Pages) and immediately scopes it to public Pages, which distinguishes it from profile/group reading. The second sentence enumerates the returned fields, so an agent knows exactly what data it gets without opening a schema.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Usage is only implied by the word 'public' — the agent can infer this is a read/collection tool with no alternatives to choose from (no siblings). Explicit exclusions (groups and personal profiles not supported) exist only in the schema's 'pages' description, not in the tool description itself.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

  1. 1 tool updatev1.0.1
    • First observedget_facebook_page_posts

TDQS

A4/5.0

Scored across 1 tool

Disambiguation5/5

With only one tool, there is no possibility of selection confusion. The tool's purpose—retrieving posts from a public Facebook Page—is stated clearly and cannot be mistaken for anything else.

Naming Consistency5/5

The single name get_facebook_page_posts follows a clean verb_noun pattern (get + resource) and is fully descriptive of what it returns. There are no competing conventions to clash with.

Tool Count3/5

One tool is defensible for a narrowly scoped scraper whose only job is fetching page posts, but it is on the thin side—there is no way to fetch post-level detail or paginate through a broader workflow. It sits at the borderline of 'focused' and 'underbuilt'.

Completeness3/5

The response shape is rich (date, text, reactions, comments, shares, media, link), covering the core read operation. However, there is no visible surface for pagination/date-range control, per-post detail, or bulk retrieval, so agents needing more than a single default fetch will hit a dead end.

Maintenance

ActivityMaintained
ResponsivenessNo recent community issues

Related MCP Connectors

Related MCP Servers

  • A
    license
    C
    quality
    D
    maintenance
    Enables access to the Facebook Scraper3 API to extract data from Facebook profiles, pages, groups, and the marketplace. It provides comprehensive tools for searching posts, people, and events, as well as retrieving detailed metadata for comments, reactions, and media.
    40
    1
    MIT
  • A
    license
    Not graded
    quality
    D
    maintenance
    Enables analytics and management of Facebook Pages through the Meta Graph API, including posts, insights, audience, and publishing.
    GPL 3.0
  • A
    license
    Not graded
    quality
    D
    maintenance
    Enables authentication with Facebook and provides tools to list pages, post text/images, upload videos, and create Reels on Facebook Pages.
    3 npm
    ISC