socialbridge-mcp

socialbridge-mcp

SocialBridge API 用のリモート MCP（Model Context Protocol） コネクターです。9 つのネットワーク（Instagram、TikTok、YouTube、Twitter/X、Reddit、Facebook、Pinterest、Snapchat、Threads。LinkedIn は登録されていますが、隔離されています）にわたるソーシャルメディアデータを、統一された /v1 契約のもとで提供します。各ネットワークが公開する操作は同じ 4 種類（profile、posts、search、comments）で、platform が付与された単一のフラットなスキーマ（Profile / Post / Comment）を返します。また、プラットフォーム横断型の包括的な操作（search_all）と、いくつかのプラットフォーム固有の追加機能も備えています。

稼働中： https://socialbridge-mcp.vercel.app/mcp — 10 個のツール。上流の SocialBridge デプロイは従量課金（RapidAPI/Apify）であり、すべての /v1/* ルートで RapidAPI プロキシシークレットによるチェックが行われるため、このコネクターは同じシークレット（SOCIALBRIDGE_MCP_PROXY_SECRET。X-RapidAPI-Proxy-Secret ヘッダーで送信）を使って自身の送信リクエストを認証し、ソフトな IP ごとのレート制限（SOCIALBRIDGE_MCP_RATE_LIMIT。デフォルトはツール呼び出し 1 時間あたり 30 回、メモリ内）を適用します。これにより、無料の MCP 層が有料リスティングを無制限に迂回する手段ではなく、発見のためのチャネルとして機能します。詳しくは lib/ratelimit.js をご覧ください。

これは何か、なぜ独立したコネクターなのか

SocialBridge API は通常の REST API です。どの HTTP クライアントからでも、すでに直接呼び出すことができます。このリポジトリが存在するのは、MCP クライアント（Claude、ChatGPT、その他の MCP 対応エージェント）は任意の REST API を利用するのではなく、MCP ツールを利用するためです。 socialbridge-mcp は薄いアダプターレイヤーで、次の機能を提供します。

• SocialBridge の各エンドポイントを、LLM が推論して直接呼び出せる、検出可能で型付けされた MCP ツール（名前、説明、zod 入力スキーマ、アノテーション）として公開します。
• 単一の /mcp エンドポイントで MCP の ストリーミング可能な HTTP トランスポートを使用するため、1 つの URL だけで Claude、ChatGPT、その他の MCP クライアントにコネクターとして登録できます。
• それ以外のことは何もしません。すべてのツール呼び出しは SocialBridge への単純な fetch パススルーで、JSON レスポンスはツールの結果としてそのまま返されます。

認証：MCP 側ではなし（意図的）

SocialBridge のデータにはユーザーごとの区分がありません。公開ソーシャルメディアメタデータ（プロフィール、投稿、検索結果、コメント）です。呼び出し元ごとにアクセス制限を設ける必要がないため、このコネクターには OAuth、ログイン、Supabase、課金、デモデータと実データの切り替えはありません。すべての呼び出し元が同じ実際のライブデータを取得します。api/mcp.js は、リクエストごとに新しいステートレスな McpServer を構築します。

ただし、このコネクターは従量課金の上流への送信リクエストを引き続き認証します（下記参照）。これはサーバー間の詳細であり、MCP の呼び出し元からは見えません。呼び出し元ごとの認証ではありません。

ツール

実際の SocialBridge /v1 ルート（social-api/openapi.yaml + src/routes.js）ごとに 1 つのツールがあります。

ツール	SocialBridge エンドポイント	説明
social_profile	GET /v1/{platform}/profile	統一された Profile スキーマで、1 つのアカウントのプロフィールを返します。
social_posts	GET /v1/{platform}/posts	統一された Post[] で、アカウントの最近の投稿を返します。
social_search	GET /v1/{platform}/search	1 つのネットワークで投稿を検索します（統一された Post[]）。
social_comments	GET /v1/{platform}/comments	投稿へのコメント／返信を返します（統一された Comment[]）。
search_all	GET /v1/search/all	すべてのネットワークに 1 つのクエリを並列で実行し、結果を統合します。
reddit_history	GET /v1/reddit/history	API キー不要で Reddit の全履歴を取得します（Arctic Shift）。
facebook_ads	GET /v1/facebook/ads	統一された Ad[] として Meta 広告ライブラリのレコードを返します（利用制限あり）。
youtube_transcript	GET /v1/youtube/transcript	動画の字幕言語リスト／キューセグメントを返します。
threads_post	GET /v1/threads/post	ショートコードまたは URL で指定した 1 つのスレッドを、返信とともに返します。
snapchat_spotlight	GET /v1/snapchat/spotlight	クリエイターの公開 Spotlight フィードを返します（統一された Post[]）。

platform は instagram, tiktok, youtube, twitter, reddit, facebook, pinterest, snapchat, threads, linkedin の列挙型です。API キー不要のプラットフォームはセットアップなしで実際のデータを返します。利用制限のあるプラットフォームは正直に credentials_required を返し、LinkedIn は platform_disabled を返します。データを偽装することはありません。

10 個すべてのツールは読み取り専用で、{ readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: true } と注釈されています。

環境変数

変数	デフォルト値	用途
SOCIALBRIDGE_MCP_API_BASE_URL	https://social-api-olive.vercel.app	上流の SocialBridge ベース URL（ローカル／セルフホストのテスト用に上書きできます）。
SOCIALBRIDGE_MCP_PROXY_SECRET	(未設定)	RapidAPI プロキシシークレットです。上流の /v1/* ガードを通過するため、X-RapidAPI-Proxy-Secret として送信されます。未設定の場合、上流は 403 を返し、ツールはその内容を正直に通知します。
SOCIALBRIDGE_MCP_RATE_LIMIT	30	1 時間あたりの tools/call に対する IP ごとのソフト上限（メモリ内、サーバーレスインスタンスごと）。

これは従量制の SocialBridge API を利用する無料の探索ティアです。ヘビーユーザーは、有料の RapidAPI／Apify の掲載ページをご利用ください。

social-api のラップ方法

各ツールのハンドラーは、実際の SocialBridge REST API に対して通常の fetch(\${SOCIALBRIDGE_MCP_API_BASE_URL}${path}`, ...)を実行し（設定されている場合はX-RapidAPI-Proxy-Secret` ヘッダーを付加）、解析した JSON を MCP ツール結果のコンテンツとして返します。

{ content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] }

上流の HTTP エラー（4xx/5xx）は捕捉され、リクエストをクラッシュさせるのではなく、asError ヘルパーを通じて型付き MCP エラー結果として通知されます。

ローカル開発

npm install
node local-server.js &                       # serves /mcp and /health on :3900
SOCIALBRIDGE_MCP_PROXY_SECRET=... npm run smoke   # real end-to-end smoke test