MCP Server

🚀 SocialAPIs MCP Server

AIエージェント向けの統一ソーシャルメディアAPI

🚀 クイックスタート

インストール

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

🔧 設定

方法1: コマンドライン引数 (Claude Desktopで推奨)

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

方法2: 環境変数

# 環境変数を設定
export SOCIALAPIS_API_KEY=your_api_key_here

# 引数なしで実行
npx @socialapis/mcp

方法3: .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

競合分析

Compare engagement rates between Nike, Adidas, and Puma over the last month

コンテンツ戦略

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サポート
• [ ] リアルタイムウェブフック
• [ ] 高度な分析
• [ ] Python SDK
• [ ] LangChain統合

📄 ライセンス

このプロジェクトはMITライセンスの下でライセンスされています - 詳細はLICENSEファイルを参照してください。

🙏 謝辞

• Model Context Protocolを使用して構築
• Anthropic Claudeによって提供
• AIエージェントコミュニティからインスピレーションを得ています

🌟 スター履歴