playbooks

home / mcp / facebook scraper3 mcp server

Facebook Scraper3 MCP Server

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

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
```

```bash
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