MCP server · SDKs · n8n

Facebook and Instagram data, wherever you build

Give AI agents Facebook and Instagram tools through MCP, or call the same API from Python, JavaScript, Go, PHP and n8n. One API key, no OAuth.

For AI agents

MCP server

12 read-only tools covering 50 actions, with structured output. Use the hosted endpoint, with nothing to install. Send your key as Authorization: Bearer YOUR_API_KEY and replace YOUR_API_KEY with the key from your dashboard.

Hosted endpoint · Streamable HTTP

https://mcp.socialapis.io/mcp
claude mcp add --transport http socialapis https://mcp.socialapis.io/mcp \
  --header "Authorization: Bearer YOUR_API_KEY"
Where: Run in your terminal

Other MCP clients work the same way: point them at the hosted endpoint with the header, or run npx -y @socialapis/mcp with SOCIALAPIS_API_KEY set. Full guide

For developers

SDKs

Official open-source clients for Python, JavaScript, Go and PHP, with cursor pagination. All four cover every endpoint.
$ pip install socialapis-sdk
from socialapis import Facebook, Instagram

fb = Facebook(api_token="YOUR_API_KEY")
page = fb.get_page_info("nike")
print(page.title, page.followers_count)

ig = Instagram(api_token="YOUR_API_KEY")
profile = ig.get_profile_details("nike")
print(profile.username, profile.followers_count)

Package registries

All packages

Everything we publish on npm, PyPI, Packagist and the Go module index, all open source. The focused packages wrap the same API for one job, like the Meta Ads Library or a Page's posts.
  • PyPIsocialapis-sdk

    Python SDK: every Facebook and Instagram endpoint, sync and async.

    pip install socialapis-sdk

    PyPI ↗Source ↗

  • npmsocialapis-sdk

    JavaScript / TypeScript SDK: every endpoint, typed responses.

    npm install socialapis-sdk

    npm ↗Source ↗

  • Gogithub.com/SocialAPIsHub/socialapis-go

    Go SDK: every endpoint, no dependencies.

    go get github.com/SocialAPIsHub/socialapis-go

    Go ↗Source ↗

  • Packagistsocialapishub/socialapis

    PHP SDK: every endpoint, for Laravel, Symfony, WordPress or plain PHP.

    composer require socialapishub/socialapis

    Packagist ↗Source ↗

  • npm@socialapis/mcp

    MCP server for AI agents (local stdio; the hosted endpoint needs no install).

    npm install @socialapis/mcp

    npm ↗Source ↗

  • npmn8n-nodes-socialapis

    n8n community node: every operation as dropdowns.

    npm install n8n-nodes-socialapis

    npm ↗Source ↗

  • PyPIfacebook-scraper-api

    Facebook Pages, posts, groups and comments with facebook-scraper style functions and a CLI.

    pip install facebook-scraper-api

    PyPI ↗Source ↗

  • npmfacebook-scraper-api

    Facebook Pages, posts, groups and comments for Node.js, with a CLI.

    npm install facebook-scraper-api

    npm ↗Source ↗

  • PyPIfacebook-ads-library-api

    Meta Ads Library search by keyword or advertiser, with CSV export and a CLI.

    pip install facebook-ads-library-api

    PyPI ↗Source ↗

  • npmfacebook-ads-library-api

    Meta Ads Library search for Node.js, with CSV export and a CLI.

    npm install facebook-ads-library-api

    npm ↗Source ↗

For automations

n8n

The SocialAPIs community node adds every Facebook and Instagram operation to n8n as dropdowns, with no HTTP Request setup. It also works as a tool for n8n AI Agents.
  1. 1In n8n, open Settings → Community Nodes and select Install.
  2. 2Enter n8n-nodes-socialapis and confirm.
  3. 3Add a SocialAPIs node and create a credential with your API key.

npm ↗GitHub ↗

Spreadsheets

Google Sheets add-on

Pull Facebook Page followers, Instagram profiles and posts, and Meta Ads Library ads into a sheet with formulas like =SOCIALAPIS_FB_PAGE("nasa", "followers").
SocialAPIs for Google SheetsInstall steps, the six functions and an example sheet

For coding agents

Agent skill

An open-source skill that teaches Claude Code, Cursor, Codex and other coding agents how to use SocialAPIs: which endpoint answers which question, auth, pagination, credits and errors. It uses the MCP tools when they're connected and the REST API otherwise.

Install

npx skills add SocialAPIsHub/skills

Then set SOCIALAPIS_API_KEY in your environment and ask your agent for Facebook or Instagram data.

SKILL.md ↗GitHub ↗

Listings

Find us on

The SocialAPIs MCP server is listed in these directories and marketplaces.

Frequently Asked Questions

Quick answers about MCP, the SDKs and n8n

An MCP (Model Context Protocol) server that gives AI assistants 12 read-only tools (50 actions) for public Facebook and Instagram data: pages, posts, comments, groups, the Ads Library, Marketplace, Instagram profiles, posts, reels and locations. Claude, Cursor, VS Code, Cline and other MCP clients can call them directly.

No. Clients that support remote MCP servers connect to https://mcp.socialapis.io/mcp with your API key in the Authorization header. For clients that only run local servers, such as Claude Desktop, use npx @socialapis/mcp (needs Node.js 18+).

MCP tool calls, SDK calls and n8n calls all use the same credits as the REST API. The free plan includes 200 credits a month with no credit card. Each tool description states its price.

The key goes in a request header, never in the URL, so it doesn't end up in server logs. Keep config files with your key out of version control; in VS Code, use the input prompt shown above so the key isn't written to the file at all.

Facebook and Instagram today. The MCP server, SDKs and n8n node all cover the same endpoints as the REST API.

One key for everything

MCP, SDKs, n8n and the REST API. 200 free calls a month, no credit card.