What it does
Facebook & Instagram data for AI agents: pages, posts, groups, ads, Marketplace, profiles, reels.
- Connects 电脑或云端
- Account or key Cloud: Needs Authorization · Local: Needs SOCIALAPIS_API_KEY
- Category 营销与社交媒体
可搭配使用
教 AI 做这类工作的 Skill,可与本项一起使用
为什么排在这里
列表按使用分(满分 100)排序,由以下部分组成
| 热度 | 7/80 | GitHub 星标或每周下载量:较大的计 60,较小的计 20 |
|---|---|---|
| 新鲜度 | 12/12 | 30 天内有发布或代码更新得满分 |
| 仍在响应 | 8/8 | 上次检查时云端端点有响应 |
| 使用分 | 27/100 |
质量: 基础检查通过 5/5 项(仅展示,不用于排序) · 上升势头: 暂无数据 (只用于“上升中”标签)
安装
选择你使用的 AI 应用,然后复制设置。
用一句话让 AI 帮你安装
请帮我安装 SocialAPIs。按照 https://mcp.popnx.com/i/socialapishub-social-media-api.md 操作,先把命令给我看,等我同意后再运行。粘贴到能在你电脑上工作的 AI(如 Claude Code、Cursor)。它会读取我们的步骤,先给你看命令,等你同意。无需密钥,无需注册。 · 查看 AI 会读取的全文
通过 5/5 项检查 · 你的提问会经过开发者的服务器(mcp.socialapis.io) · ✓ 命令已检查 2026年11月14日
第一步:你用哪个 AI?
选择你用的应用,步骤会显示在下方。
可连接 Claude · 约 5 分钟
需要 SocialAPIs 的密钥(在开发者网站创建) · 在 claude.ai 或桌面应用设置一次,即可在聊天中使用 · 免费账户可添加 1 个 · Team/Enterprise 方案由所有者(Owner)添加
打开 Claude 的 Connectors 页面
CustomizeConnectors
点击“Add” → “Custom” → “Web”,填写这 2 项
把这里的内容复制到 Claude 中同名的输入框,然后点击 Continue
Name · 名称SocialAPIsRemote MCP server URL · 地址https://mcp.socialapis.io/mcp在 Request headers 下添加这个名称和值
Header 名称Authorization值Bearer <在这里粘贴你的密钥>只把密钥粘贴到应用的输入框里,不要粘贴到聊天中或发给任何人
在 Claude 检测到的登录设置页点击 Continue · Authentication 按作者说明选择(Sign in now、Sign in when needed 或 No sign in),然后点击 Add
在聊天中开启
+ConnectorsSocialAPIs
试一试
用 SocialAPIs 告诉我你能帮我做什么,然后做一件给我看✓ 如果 Claude 说正在使用 SocialAPIs,或回答中出现 SocialAPIs 的工具名称,就表示连接成功
菜单名称已于 2026年11月11日 对照 Anthropic 帮助页面核实 · 你的界面可能因版本略有不同
ChatGPT 暂时无法连接 SocialAPIs
SocialAPIs 连接时需要你自己的密钥,但 OpenAI 帮助页面只说明了 OAuth 登录,没有我们能核实的填密钥方式
你可以改用这些方式
A · 使用能连接 SocialAPIs 的应用
- 需要 SocialAPIs 的密钥(在开发者网站创建) · 在 claude.ai 或桌面应用设置一次,即可在聊天中使用 · 免费账户可添加 1 个 · Team/Enterprise 方案由所有者(Owner)添加
- 需要 SocialAPIs 的密钥(在开发者网站创建)
- 需要 SocialAPIs 的密钥(在开发者网站创建)
- 需要 SocialAPIs 的密钥(在开发者网站创建)
B · 营销与社交媒体 类中能连接 ChatGPT 的其他服务器
从同类中使用较多的里挑选,仅限用地址即可连接、无需密钥的
- Google Ads + Meta Ads + SEO/GEO MCP✓ ChatGPT
- Cargo✓ ChatGPT
- NotFair✓ ChatGPT
可连接 Claude Code · 约 5 分钟
需要 SocialAPIs 的密钥(在开发者网站创建)
注册并创建 SocialAPIs 的密钥
打开开发者网站,注册账户并创建 API 密钥,下一步要用。价格和免费方案请看开发者网站。
获取密钥的方法见下方开发者的 README
打开终端
Mac:按 Command+空格,输入 Terminal · Windows:打开 PowerShell
粘贴这条命令并按 Enter
claude mcp add --transport http --scope user social-media-api https://mcp.socialapis.io/mcp --header 'Authorization: Bearer your-value'按 Enter 前,把“your-value”改成你的密钥
只把密钥粘贴到应用的输入框里,不要粘贴到聊天中或发给任何人
在 Claude Code 中输入 /mcp
应能看到 SocialAPIs 在列表中并显示已连接
试一试
用 SocialAPIs 告诉我你能帮我做什么,然后做一件给我看✓ 如果 Claude Code 说正在使用 SocialAPIs,或回答中出现 SocialAPIs 的工具名称,就表示连接成功
菜单名称已于 2026年11月11日 对照 Anthropic 帮助页面核实 · 你的界面可能因版本略有不同
可连接 Cursor · 约 5 分钟
需要 SocialAPIs 的密钥(在开发者网站创建)
注册并创建 SocialAPIs 的密钥
打开开发者网站,注册账户并创建 API 密钥,下一步要用。价格和免费方案请看开发者网站。
获取密钥的方法见下方开发者的 README
填写你的密钥
在 SocialAPIs 的设置中,Authorization 还是空的,填入你的密钥并保存
只把密钥粘贴到应用的输入框里,不要粘贴到聊天中或发给任何人
在 Cursor 中以 Agent 模式打开 AI 聊天
试一试
用 SocialAPIs 告诉我你能帮我做什么,然后做一件给我看✓ 如果 Cursor 说正在使用 SocialAPIs,或回答中出现 SocialAPIs 的工具名称,就表示连接成功
菜单名称已于 2026年11月11日 对照 Cursor 帮助页面核实 · 你的界面可能因版本略有不同
可连接 VS Code · 约 5 分钟
需要 SocialAPIs 的密钥(在开发者网站创建)
注册并创建 SocialAPIs 的密钥
打开开发者网站,注册账户并创建 API 密钥,下一步要用。价格和免费方案请看开发者网站。
获取密钥的方法见下方开发者的 README
填写你的密钥
在 SocialAPIs 的设置中,Authorization 还是空的,填入你的密钥并保存
只把密钥粘贴到应用的输入框里,不要粘贴到聊天中或发给任何人
在 VS Code 中以 Agent 模式打开 AI 聊天
试一试
用 SocialAPIs 告诉我你能帮我做什么,然后做一件给我看✓ 如果 VS Code 说正在使用 SocialAPIs,或回答中出现 SocialAPIs 的工具名称,就表示连接成功
菜单名称已于 2026年11月11日 对照 VS Code 帮助页面核实 · 你的界面可能因版本略有不同
开发者专用:终端命令和 JSON 设置
通过网页连接
Claude Code
claude mcp add --transport http --scope user social-media-api https://mcp.socialapis.io/mcp --header 'Authorization: Bearer your-value'Cursor (~/.cursor/mcp.json)
{
"mcpServers": {
"social-media-api": {
"url": "https://mcp.socialapis.io/mcp",
"headers": {
"Authorization": "Bearer your-value"
}
}
}
}VS Code (mcp.json)
{
"servers": {
"social-media-api": {
"type": "http",
"url": "https://mcp.socialapis.io/mcp",
"headers": {
"Authorization": "Bearer your-value"
}
}
}
}安装在电脑上
Claude Code
claude mcp add --scope user social-media-api --env SOCIALAPIS_API_KEY=your-value -- npx -y @socialapis/mcpClaude Desktop (claude_desktop_config.json)
{
"mcpServers": {
"social-media-api": {
"command": "npx",
"args": [
"-y",
"@socialapis/mcp"
],
"env": {
"SOCIALAPIS_API_KEY": "your-value"
}
}
}
}Cursor (~/.cursor/mcp.json)
{
"mcpServers": {
"social-media-api": {
"command": "npx",
"args": [
"-y",
"@socialapis/mcp"
],
"env": {
"SOCIALAPIS_API_KEY": "your-value"
}
}
}
}VS Code (mcp.json)
{
"servers": {
"social-media-api": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@socialapis/mcp"
],
"env": {
"SOCIALAPIS_API_KEY": "your-value"
}
}
}
}需要你填写的值
SOCIALAPIS_API_KEY机密 必填 env您的 SocialAPIs API 密钥。请在 https://socialapis.io/dashboard 获取查看英文原文
Your SocialAPIs API key. Get yours at https://socialapis.io/dashboardMCP_PROXY_URLenvMCP 代理服务器 URL(可选)。查看英文原文
MCP proxy server URL (optional)- Bearer 令牌,使用您的 SocialAPIs API 密钥(Authorization: Bearer )。在 https://socialapis.io/dashboard 获取。
查看英文原文
Bearer token with your SocialAPIs API key (Authorization: Bearer ). Get one at https://socialapis.io/dashboard
说明为自动翻译,变量名保持原样;不确定时请查看原文。
这些设置是根据作者在注册中心的条目生成的。如果 README 的写法不同,请以 README 为准。
一览
哪些应用可以使用它
依据这个服务器的连接方式和各应用自己的文档,检查于 2026年11月10日。
通过互联网连接,适用于
ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatOpen WebUIRaycast
在你的电脑上运行,适用于
ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast
它能做什么
工具名称和描述与服务器在 2026年11月18日 报告的完全一致。这些内容由作者撰写,不是我们写的;我们以纯文本形式显示。
facebook_pageFacebook pages: profile details, page ID, posts, videos, reels and photo albums. Actions: - action=details: Get a Facebook page's profile: name, category, follower and like counts, bio, contact info (email, phone, website, address), rating and the ad_page_id used by the Ads Libra
facebook_groupPublic Facebook groups: details, group ID, posts, videos and photo albums. Actions: - action=details: Get a public Facebook group's profile: name, description, member count, privacy, rules and activity stats. Use action=posts for its posts. Pricing: 1 credit per call. Inputs: lin
facebook_postFacebook posts, videos and comments: post details, attachments, comments and replies. Actions: - action=details: Get a Facebook post's text, author, timestamp, media, and reaction, comment and share counts. Start here for any post. If you need view counts, video download URLs or
facebook_searchSearch Facebook by keyword: pages, people, posts, videos and locations. Actions: - action=pages: Find Facebook pages by keyword (brand, business or topic name), optionally near a location. Returns page names, URLs, categories and follower counts, 3 per call, plus an end_cursor. U
facebook_adsMeta Ads Library: search ads, find advertisers by keyword, advertiser page details, single ad details and supported countries. Actions: - action=search: Search ads in the Meta Ad Library. Pass a keyword (query) to find ads about a topic, or ad_page_id to list one advertiser's ads
facebook_marketplaceFacebook Marketplace: search listings, vehicles and rentals, listing and seller details, categories and city coordinates. Actions: - action=search: Search general Facebook Marketplace listings (items for sale) by keyword or category near a location, with price, condition, radius
facebook_media_downloadResolve a Facebook media URL (image, video or audio, e.g. from a post or reel) to direct downloadable file URLs. Returns URLs, not file bytes. Pricing: 1 credit per call. Inputs: url (required).
instagram_profileInstagram profiles: details, user ID, posts, reels, highlights and highlight stories. Actions: - action=details: Get an Instagram profile by username: bio, follower and post counts, verification status and related profiles. Pricing: 1 credit per call. Inputs: username (required),
instagram_postInstagram posts: full post details, or the shortcode from a post URL. Actions: - action=details: Get one Instagram post or reel in full: caption, media URLs, engagement counts, timestamp and owner. Needs the shortcode (the part after /p/ or /reel/ in the URL, or from action=id).
instagram_reelsInstagram Reels: the trending feed, or reels that use a given audio track. Actions: - action=feed: Get Instagram's recommended and trending reels. Pass clips_media_id from a previous result to continue the feed or get similar reels by the same author. Not tied to a user; for one
instagram_searchSearch Instagram by keyword and get the top matching users, hashtags and places. Use it to find a username, or a place's location_id for instagram_location (action=posts). Returns an end_cursor for more. Pricing: 1 credit per call. Inputs: keyword (required), end_cursor (optional
instagram_locationInstagram locations: posts tagged at a place, and nearby places. Actions: - action=posts: List Instagram posts tagged at a location: top posts (tab=ranked) or most recent (tab=recent). Needs a location_id, e.g. from a place in instagram_search (action=search). Returns an end_curs
基础检查i
我们检查的是任何人都能看到的信息;我们没有阅读代码。不适用的检查项不计入总数。 · 检查于 2026年11月19日
- ✓ 通过
作者与仓库一致
注册名称已通过 GitHub 账户 SocialAPIsHub 验证,该账户拥有此仓库
- ✓ 通过
仍在维护
代码最后更新于20天前
- ✓ 通过
有许可证
使用 MIT
- ✓ 通过
端点有响应
在 688 毫秒内响应(HTTP 200)
- – 不适用
使用 OAuth 登录
无需登录
- ✓ 通过
工具描述中没有隐藏指令
已读取 12 个工具描述,未发现针对 AI 的隐藏指令
云端地址最近 4 次检查中有 4 次响应 · 最近一次 688 ms · 检查于 2026年11月18日
已公开的漏洞(OSV.dev)
OSV.dev 中没有 @socialapis/mcp@2.2.0 的记录
只检查这个版本的包本身,不包括所有依赖 · 检查于 2026年11月15日
作者:申请重新检查或报告信息错误
给作者:在 README 中加徽章
如果你是作者,可把这段代码贴到 README。徽章会链接回本页。
[](https://mcp.popnx.com/en/servers/socialapishub-social-media-api)讨论
提问、分享技巧或报告无法使用。按“有帮助”数量排序。
用户评价
还没有评价
与“营销与社交媒体”中的其他服务器比较i
- 星标数多于此分类中其他 4175 个服务器的 93%
- 发布到注册中心的时间比此分类中其他 4175 个服务器的 58% 更新
- 基础检查结果等于或优于此分类中其他 4175 个服务器的 99%
与注册中心里这个分类中所有活跃的服务器比较。只有当发布者拥有该仓库时,星标数才计入。
常见问题
SocialAPIs 安全吗?
它在 5 项适用的基础检查中通过了 5 项。我们没有阅读代码。在添加密钥或令牌之前,请先看看这个服务器要求哪些权限,并使用只具备所需权限的密钥。
它需要哪些密钥或代码?
你需要填写:Authorization, SOCIALAPIS_API_KEY
它在我的电脑上运行还是在云端?
两种方式都可以:安装在你的电脑上,或者连接云端版本。
它还在维护吗?
GitHub 仓库最后更新于20天前,最新版本(2.2.0)于23天前进入注册中心。
哪些应用可以使用它?
支持 MCP 的应用,例如 Claude Desktop、Claude Code、Cursor 和 VS Code。它通过 URL 连接,因此也能用于接受远程 MCP 的应用,例如网页版 ChatGPT(Business 及以上为完整 MCP;Pro 为只读)。
有什么可以替代它?
同一分类中有:Relaticle, ChatbotX, X (Twitter) MCP Server by Xquik, Betterlytics, BibiGPT YouTube Video Summarizer
功能相近的其他选择
同一分类、其他作者、命令已通过检查。官方的排在前面,再按星标排序。
如何看卡片:↓ 每周下载量i★ GitHub 星标i三大支柱:评价 · 检查 · 使用情况i更新 = 最新版本发布到注册中心的时间i
Relaticle
Open-source CRM your AI agents can write to: companies, people, opportunities, tasks and notes.
ChatbotX
Omnichannel customer messaging, CRM contacts, flows, sequences, broadcasts, and AI automation.
X (Twitter) MCP Server by Xquik
Xquik is the world's fastest and cheapest X (Twitter) data API with the most complete X data.
Betterlytics
Query your Betterlytics web analytics from AI agents: traffic, funnels, journeys, errors, uptime.
BibiGPT YouTube Video Summarizer
AI video summarizer: summarize and transcribe YouTube, Bilibili, TikTok and podcast videos.
| 本项 SocialAPIs | Relaticle | ChatbotX | X (Twitter) MCP Server by Xquik | Betterlytics | BibiGPT YouTube Video Summarizer | |
|---|---|---|---|---|---|---|
| 运行位置 | 云端或安装在电脑上都可以 | 在云端运行,无需安装 | 在云端运行,无需安装 | 在云端运行,无需安装 | 在云端运行,无需安装 | 在云端运行,无需安装 |
| 需要密钥 | 是 | 否 | 否 | 否 | 是 | 否 |
| 可在 Claude 中按 + 添加 | 否 | 否 | 否 | 否 | 否 | 否 |
| 基础检查 | 5/5 | 4/4 | 4/4 | 4/4 | 4/4 | 4/4 |
| 许可证 | MIT | AGPL-3.0 | NOASSERTION | MIT | AGPL-3.0 | MIT |
| 价格 | 登记中未列出费用 | 登记中未列出费用 | 登记中未列出费用 | 登记中未列出费用 | 登记中未列出费用 | 登记中未列出费用 |
作者的 README
打开 README
按原文从作者的仓库复制。PopNx MCP 没有审查或背书其内容。HTML、图片和脚本已被移除。链接会离开本站。
SocialAPIs MCP Server
Facebook & Instagram data for AI agents — local (npx) or hosted (remote MCP)
Website • Documentation • Discord • npm
Official SDKs: Python • JavaScript / TypeScript • Go
🚀 Quick Start
AI agents (Cline, Claude Code, Cursor): follow
llms-install.mdfor step-by-step install and verification.
One-click: use the Install in Cursor button above — then replace YOUR_API_KEY in Cursor's MCP settings with your key. Also listed on Smithery, cursor.directory, mcp.so and the official MCP Registry (io.github.SocialAPIsHub/social-media-api).
Option A — Hosted (remote MCP, no install)
Point any client that supports remote MCP servers (Streamable HTTP) at:
https://mcp.socialapis.io/mcp
Authenticate with your SocialAPIs API key in a header:
Authorization: Bearer YOUR_API_KEY
(x-api-token: YOUR_API_KEY also works.) Tool listing works without a key; tool calls need one. Example config for clients that take a URL + headers:
{
"mcpServers": { "socialapis": { "url": "https://mcp.socialapis.io/mcp", "headers": { "Authorization": "Bearer YOUR_API_KEY" } } } }
Option B — Local (npx, stdio)
Installation
npm install -g @socialapis/mcp
Configuration
Add to your Claude Desktop config:
macOS:
nano ~/Library/Application\ Support/Claude/claude_desktop_config.json
Windows:
notepad %APPDATA%\Claude\claude_desktop_config.json
🔧 Configuration
Method 1: Command Line Argument (Recommended for Claude Desktop)
{
"mcpServers": { "socialapis": { "command": "npx", "args": ["-y", "@socialapis/mcp", "YOUR_API_KEY"] } } }
Method 2: Environment Variable
# Set environment variable
export SOCIALAPIS_API_KEY=your_api_key_here
Run without argument
npx @socialapis/mcp
Method 3: .env File (For Development)
# Copy example file
cp .env.example .env
Edit with your values
nano .env
.env file:
SOCIALAPIS_API_KEY=your_api_key_here
MCP_PROXY_URL=https://mcp.socialapis.io
Environment Variables
| Variable | Description | Default |
|---|---|---|
SOCIALAPIS_API_KEY | Your SocialAPIs API key | None (required) |
MCP_PROXY_URL | MCP proxy server URL | https://mcp.socialapis.io |
PORT | HTTP server port | 3001 |
API_BASE_URL | Backend API URL | https://api.socialapis.io |
SOCIALAPIS_CATALOG_URL | Live endpoint catalog the server follows (server only) | https://auth.socialapis.io/api/public/endpoints |
SOCIALAPIS_CATALOG_REFRESH_MS | How often the catalog (server) or tool list (npm client) is re-read | 600000 (10 min) |
SOCIALAPIS_LIVE_CATALOG | 0 = always use the bundled definitions (server only) | on |
Live catalog
Prices, descriptions and parameters follow the SocialAPIs API without a new release. The server reads the public endpoint catalog at startup (3 s timeout) and every 10 minutes, compares it with src/catalogBaseline.json (the catalog src/tools.js was written against) and applies only what changed since: a new price replaces the tool's Pricing: sentence, an edited description or parameter replaces ours, added and removed parameters are added and removed, and a disabled endpoint's action says "Currently unavailable." Tool and action names never change, and new endpoints don't become tools until a release adds them. If the catalog can't be read, or a change would make two actions' parameters conflict, the last good definitions (at first the bundled ones) stay. GET /health shows catalog: { source, version, fetchedAt, routes }. The npm client re-reads the tool list every 10 minutes and sends notifications/tools/list_changed when it changes.
After updating tools.js to match the API, refresh the baseline: node scripts/snapshot-catalog.mjs --from https://auth.socialapis.io/api/public/endpoints (public fields only).
Get API Key
- Sign up at socialapis.io
- Go to Dashboard
- Copy your API key
- Replace
YOUR_API_KEYin config
Test It
Restart Claude Desktop and ask:
Get Nike's Facebook page details
📋 Features
- 🌐 One API key - Facebook and Instagram behind a single interface
- 🤖 AI-First - Built for Claude, Cursor, and AI agents
- 📊 Rich Data - Posts, comments, engagement metrics
- 🔍 Advanced Filtering - Time ranges, pagination
- 🎯 Simple Auth - No OAuth complexity
- 🧩 Structured output - every tool declares an output schema and returns
{ result, creditsCharged, creditsRemaining }, so agents can track credit spend directly - 🛡️ Read-only annotations - all tools are marked
readOnlyHint, so clients can skip confirmation prompts - ⚡ Fast - Global edge network
- 🔒 Secure - API keys stay local
🛠️ Available Tools
12 tools covering 50 actions across Facebook and Instagram. Each tool groups one resource and takes an action argument; every action maps to one REST endpoint on api.socialapis.io. Tool descriptions list each action, the parameters it needs and its credit cost.
| Tool | Actions |
|---|---|
facebook_page | details (followers, contact info, category; exact_followers_count=true costs 5 credits), id, posts (limit 3-9, date filters), videos (limit 6-12), reels, albums (profile_id from id, limit 8-16), album_items (photos and videos in an album) |
facebook_group | details, id, posts (limit 3-9, date filters), videos, albums (group_id from id, limit 8-16), album_items |
facebook_post | details, details_extended (view counts, video URLs, audio metadata), id, attachments (5 credits), video, comments, comment_replies |
facebook_search | pages, people, posts, videos, locations (location UIDs for the other searches) |
facebook_ads | search (ads by keyword, page, country, status), keywords (advertisers for a keyword), page_details, archive_details, countries |
facebook_marketplace | search (price, location, category, condition filters), vehicles, rentals, listing, seller, categories, city_coordinates |
facebook_media_download | Download URLs for Facebook images and videos |
instagram_profile | details, id, posts, reels, highlights, highlight_details |
instagram_post | details, id (shortcode from a post URL) |
instagram_reels | feed, by_audio |
instagram_search | Popular users, hashtags and places for a keyword |
instagram_location | posts (recent or top), nearby |
Example call: facebook_page with {"action": "posts", "link": "https://www.facebook.com/nike", "limit": 9}.
Upgrading from 1.x: the earlier per-endpoint tool names (facebook_get_page_details, instagram_get_profile_posts, …) still work when called directly, so existing prompts and scripts keep running. They're no longer listed. If your client auto-approves tools by name, add the new names.
Not supported yet
Only Facebook and Instagram are live today. TikTok, X / Twitter, LinkedIn and YouTube are on the roadmap with no committed dates — tools for them will appear here only once they ship.
Track the platform roadmap at socialapis.io/api-sources.
💡 Usage examples
Each prompt below is a real Claude Desktop session. Some of these are single-tool-call patterns ("get me X"); some require Claude to chain multiple calls + aggregate the results (noted where).
Single-call patterns (fast, cheap)
What's Nike's follower count on Facebook?
→ Uses facebook_page action=details (1 credit)
Get the latest 9 posts from facebook.com/EngenSA → Uses facebook_page action=posts with limit=9 (1-3 credits depending on actual returned count)
Show me the Meta ads currently running for "Apple Vision Pro" in Germany → Uses facebook_ads action=search (1 credit)
Multi-call patterns (Claude orchestrates these — but it's slower + more expensive)
Compare engagement on Nike vs Adidas's last 9 Facebook posts
→ Claude calls facebook_page action=posts twice (~2-6 credits total), aggregates reactions/comments/shares per post, returns a comparison.
What are people saying in the comments on Coca-Cola's last 3 posts? → Claude calls facebook_page action=posts (1 credit) then facebook_post action=comments 3 times (3 credits) and summarizes.
Show me marketplace listings for "PlayStation 5" under $400 in Berlin → Claude calls facebook_marketplace action=city_coordinates (1 credit) + facebook_marketplace action=search with filters (1 credit).
What this MCP server does NOT do
Some queries look natural in a chat ("compare engagement over the last month") but require aggregations the API doesn't expose as a single tool yet. Claude can still answer them, but it'll fan out into many tool calls — which is slow + expensive.
| Query shape | Why it's hard |
|---|---|
| "Engagement rate over the last 30 days" for a page | Requires fetching every post in the date range (paginated, limit capped at 9 per call) and computing engagement per post. Hits the LLM tool-call budget on busy pages. |
| "Compare engagement rates between Brand A, B, C over the last month" | Same problem, 3× — one paginated fetch per brand, then comparison math. Works for small windows; slow for "last month" on high-volume pages. |
| Historical archive older than what Facebook itself serves | We surface what Facebook makes publicly visible. Posts that scrolled off Facebook's visible feed aren't retrievable. |
| Server-side time-series (daily engagement, weekly growth) | Not yet — on the roadmap as a future engagement-stats endpoint with built-in aggregation. |
If your use case maps to one of these patterns and you want the aggregation pre-computed instead of LLM-orchestrated, contact support with the specific query — we're prioritizing the aggregation endpoint based on customer demand.
🏗️ Architecture
Claude Desktop
↓ @socialapis/mcp (local MCP client) ↓ https://mcp.socialapis.io (global proxy) ↓ https://api.socialapis.io (data API)
Why this architecture?
- ✅ Low latency (global edge network)
- ✅ High reliability (99.9% uptime)
- ✅ Auto rate limiting
- ✅ Smart caching
- ✅ Your API key stays local
🔧 Development
Local Setup
# Clone repository
git clone https://github.com/SocialAPIsHub/mc