Facebook Scraper3

Provides access to Facebook Scraper3 data via an MCP server, enabling endpoint-driven data retrieval for profiles, posts, comments, pages, and more.

python

0

GitHub Stars

python

Language

4 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "bach-ai-tools-bachai-facebook-scraper3": {
      "command": "python",
      "args": [
        "server.py"
      ],
      "env": {
        "API_KEY": "YOUR_API_KEY_HERE"
      }
    }
  }
}

This MCP Server provides access to the Facebook Scraper3 API through a standardized MCP interface. It enables authenticated requests to a set of Facebook scraping endpoints from your applications, with a Python-based package flow and convenient runtime options.

How to use

You will run this MCP Server as a stdio-based service. Start it from your MCP client or orchestration tool, providing your API key for authentication. You can operate it alongside other MCP servers and invoke any of the supported endpoints as part of your data retrieval and automation workflows.

How to install

Prerequisites you need before installation:

How to install

pip install bach-facebook_scraper3

Run using uvx (recommended)

uvx --from bach-facebook_scraper3 bach_facebook_scraper3

uvx --from bach-facebook_scraper3@latest bach_facebook_scraper3

Run in development mode

python server.py

Run after installation as a command

pip install bach-facebook_scraper3
bach_facebook_scraper3

Available tools

profiles_photos

Read profile photos (from recent) and paginate using the cursor to get the next page. Endpoint: GET /profile/photos

comment_by_id

Get a comment by its id. Endpoint: GET /comment

search_people

Search for people. Endpoint: GET /search/people

search_hashtag

Search posts by hashtag. Endpoint: GET /search/hashtags

profile_reels

Get profile reels; obtain reels_profile_id from profile details. Endpoint: GET /profile/reels

page_events

Get all future events created by a page. Endpoint: GET /page/events/future

post_reactions

Get reactions for a post. Endpoint: GET /post/reactions

comments___nested

Get nested comments using legacy Facebook id. Endpoint: GET /post/comments_nested

page_reels

Get page reels; use reels_page_id instead of page id. Endpoint: GET /page/reels

listing_details

Get listing details from marketplace. Endpoint: GET /marketplace/details

search

Search marketplace listings with pagination. Endpoint: GET /marketplace/search

comments

Get post comments using a comment_id from the post. Endpoint: GET /post/comments

search_groups_posts

Search groups for posts. Endpoint: GET /search/groups_posts

page_videos

Get page videos using a delegate id (not the page id). Endpoint: GET /page/videos

pages_photos

Read page photos (from recent) and paginate using the cursor. Endpoint: GET /page/photos

pages_posts

Read page posts (from recent). Endpoint: GET /page/posts

page_details

Read page details. Endpoint: GET /page/details

page_past_events

Get all past events created by a page; paginate with cursor. Endpoint: GET /page/events/past

get_group_posts

Get group posts; only PUBLIC groups can be scraped. Endpoint: GET /group/posts

get_group_future_events

Get group future events; only PUBLIC groups can be scraped; paginate with cursor. Endpoint: GET /group/future_events

search_events

Search for Facebook events. Endpoint: GET /search/events

game_lives

Get game live videos; paginate with cursor. Endpoint: GET /gaming/live

browse_games

Browse games; use empty query to browse all; paginate with cursor. Endpoint: GET /gaming/games

page_reviews

Get page reviews; paginate with cursor. Endpoint: GET /page/reviews

search_video

Search Facebook videos. Endpoint: GET /search/videos

profile_posts

Read profile posts (from recent) if public. Endpoint: GET /profile/posts

events_details_by_id

Get event details by event id. Endpoint: GET /event/details_id

locations

Search for Facebook locations by id; include country or remove diacritics if needed. Endpoint: GET /search/locations

search_post

Perform Facebook posts search. Endpoint: GET /search/posts

events_details_by_url

Get event details by URL. Endpoint: GET /event/details

profiles_details_by_id

Get profile details by id. Endpoint: GET /profile/details_id

profile_details_by_url

Get profile details by URL. Endpoint: GET /profile/details_url

profile_id

Get profile id by URL. Endpoint: GET /profile/profile_id

get_post_details

Get post details by URL or post id; if both are set, post id is used. Endpoint: GET /post

get_group_details

Get group summary. Endpoint: GET /group/details

get_group_id

Get Facebook group id. Endpoint: GET /group/id

page_id

Get page id from URL. Endpoint: GET /page/page_id

reshares

Get post reshares. Endpoint: GET /post/share

search_place

Search for a Facebook place. Endpoint: GET /search/places

search_pages

Search for Facebook pages. Endpoint: GET /search/pages