MCP Server

🚀 SocialAPIs MCP Server

SocialAPIs MCP Server 提供了统一的社交媒体 API，专为 AI 代理设计，能让 AI 便捷地获取多个平台的丰富数据，解决了多平台数据获取的复杂性问题，为 AI 应用提供了高效的支持。

🚀 快速开始

安装

npm install -g @socialapis/mcp

配置

添加到你的 Claude Desktop 配置中：

macOS：

nano ~/Library/Application\ Support/Claude/claude_desktop_config.json

Windows：

notepad %APPDATA%\Claude\claude_desktop_config.json

🔧 配置

方法一：命令行参数（推荐用于 Claude Desktop）

{
  "mcpServers": {
    "socialapis": {
      "command": "npx",
      "args": ["-y", "@socialapis/mcp", "YOUR_API_KEY"]
    }
  }
}

方法二：环境变量

# 设置环境变量
export SOCIALAPIS_API_KEY=your_api_key_here

# 无参数运行
npx @socialapis/mcp

方法三：.env 文件（用于开发）

# 复制示例文件
cp .env.example .env

# 用你的值编辑
nano .env

.env 文件：

SOCIALAPIS_API_KEY=your_api_key_here
MCP_PROXY_URL=https://mcp.socialapis.io

环境变量

获取 API 密钥

1. 在 socialapis.io 上注册。
2. 前往 仪表盘。
3. 复制你的 API 密钥。
4. 在配置中替换 YOUR_API_KEY。

测试

重启 Claude Desktop 并询问：

Get Nike's Facebook page details

✨ 主要特性

• 🌐 统一 API - 一个接口支持多个平台。
• 🤖 以 AI 为先 - 专为 Claude、Cursor 和 AI 代理构建。
• 📊 丰富数据 - 提供帖子、评论和参与度指标等。
• 🔍 高级过滤 - 支持时间范围和分页。
• 🎯 简单认证 - 无需复杂的 OAuth。
• ⚡ 快速响应 - 全球边缘网络。
• 🔒 安全可靠 - API 密钥保持本地。

🛠️ 可用工具

Facebook 页面

• facebook_get_page_id - 从 URL 中提取页面 ID。
• facebook_get_page_details - 获取页面信息、关注者和点赞数。
• facebook_get_page_posts - 按时间过滤获取帖子。
• facebook_get_page_reels - 获取卷轴/短视频。

Facebook 群组

• facebook_get_group_id - 从 URL 中提取群组 ID。
• facebook_get_group_details - 获取群组元数据。
• facebook_get_group_posts - 获取群组帖子。

Facebook 帖子

• facebook_get_post_id - 从 URL 中提取帖子 ID。
• facebook_get_post_details - 获取反应、评论和分享数。
• facebook_get_post_attachments - 获取媒体附件。
• facebook_get_video_details - 获取视频元数据。
• facebook_get_post_comments - 分页获取评论。

更多平台即将推出：Instagram、TikTok、YouTube、Twitter

💻 使用示例

基础用法

Monitor Nike's Facebook page and alert me if engagement drops below average

高级用法

# 品牌监测：监控耐克的 Facebook 页面，如果参与度低于平均水平则提醒
Monitor Nike's Facebook page and alert me if engagement drops below average

# 竞争分析：比较耐克、阿迪达斯和彪马上个月的参与率
Compare engagement rates between Nike, Adidas, and Puma over the last month

# 内容策略：可口可乐的 Facebook 页面上哪种类型的帖子获得的参与度最高？
What types of posts get the most engagement on Coca-Cola's Facebook page?

# 情感分析：分析我们近期帖子的评论并找出常见主题
Analyze comments on our recent posts and identify common themes

🏗️ 架构

Claude Desktop
    ↓
@socialapis/mcp (本地 MCP 客户端)
    ↓
https://mcp.socialapis.io (全球代理)
    ↓
https://api.socialapis.io (数据 API)

为什么采用这种架构？

• ✅ 低延迟（全球边缘网络）
• ✅ 高可靠性（99.9% 正常运行时间）
• ✅ 自动速率限制
• ✅ 智能缓存
• ✅ 你的 API 密钥保持本地

🔧 开发

本地设置

# 克隆仓库
git clone https://github.com/SocialAPIsHub/mcp-server.git
cd mcp-server

# 安装依赖
npm install

# 运行 MCP 客户端
npm start YOUR_API_KEY

# 运行 HTTP 代理服务器
npm run serve

项目结构

mcp-server/
├── src/
│   └── tools.js          # 工具定义
├── mcp-wrapper.js        # MCP 客户端（本地运行）
├── server.js             # HTTP 代理服务器
├── package.json
├── Dockerfile
└── README.md

测试

# 本地测试 MCP 客户端
node mcp-wrapper.js YOUR_API_KEY

# 测试 HTTP 代理
curl http://localhost:3001/health
curl http://localhost:3001/tools

# 测试特定工具
curl -X POST http://localhost:3001/proxy \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"tool":"facebook_get_page_details","arguments":{"link":"https://facebook.com/nike"}}'

📊 定价

查看详细定价 →

🤝 贡献

我们欢迎贡献！详情请参阅 CONTRIBUTING.md。

快速贡献指南

1. 分叉仓库。
2. 创建功能分支 (git checkout -b feature/amazing-feature)。
3. 提交更改 (git commit -m 'Add amazing feature')。
4. 推送到分支 (git push origin feature/amazing-feature)。
5. 打开拉取请求。

📖 详细文档

• 完整文档
• API 参考
• MCP 指南
• 示例

💬 支持

• 📧 邮箱：support@socialapis.io
• 💬 Discord：discord.gg/socialapis
• 🐛 问题反馈：GitHub Issues
• 📚 文档：docs.socialapis.io

🗺️ 路线图

• [x] 支持 Facebook API
• [x] 实现 MCP 服务器
• [x] 实现 HTTP 代理服务器
• [x] 发布 npm 包
• [ ] 支持 Instagram
• [ ] 支持 TikTok
• [ ] 支持 YouTube
• [ ] 支持 Twitter/X
• [ ] 实时 Webhook
• [ ] 高级分析
• [ ] Python SDK
• [ ] LangChain 集成

📄 许可证

本项目采用 MIT 许可证 - 详情请参阅 LICENSE 文件。

🙏 致谢

• 基于 Model Context Protocol 构建。
• 由 Anthropic Claude 提供支持。
• 受 AI 代理社区启发。

🌟 星标历史