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 代理社區啟發。

🌟 星標歷史