Social Fetch

Social Fetch MCP

コーディングエージェントがビルドしながら、実際のソーシャルメディアやウェブのデータを取得できるようにします。

ドキュメント | API リファレンス | クレジットと請求

サーバー URL： https://api.socialfetch.dev/mcp

これは何ですか？

Social Fetch MCP は、Cursor、VS Code、Claude、Windsurf、その他の MCP クライアントを Social Fetch API に接続します。インストールすると、エージェントはエディター内からクリエイターを検索したり、投稿を取得したり、プラットフォームを検索したり、ウェブページを読んだり、残高を確認したり、Social Fetch のドキュメントを読んだりできます。

次のような質問にエージェントに回答してほしい場合にご利用ください。

• 「この TikTok クリエイターを見つけて、最新の動画をアプリに追加してください。」
• 「この YouTube 動画の文字起こしを取得して、スポンサーシップを要約してください。」
• 「この Instagram の投稿を取得し、レスポンスの形式を確認して、バックエンドに組み込んでください。」
• 「Social Fetch のドキュメントを読んで、Reddit 検索に適したエンドポイントを選んでください。」

MCP サーバーは Social Fetch がホストしています。

https://api.socialfetch.dev/mcp

このリポジトリからローカルサーバーをクローン、ビルド、実行する必要はありません。クライアントはホストされた Streamable HTTP エンドポイントに接続し、ブラウザーで OAuth 認証を行います。

利用する理由

アプリが使用するものと同じ API を利用できると、エージェントの能力が高まります。これにより、ドキュメント、ダッシュボード、スクリプト、貼り付けた JSON の間を行き来することなく、エージェントから Social Fetch に直接、認証済みの経路でアクセスできます。

• セットアップを簡単に： エージェントから Social Fetch のツールを直接呼び出せます。
• より良い回答： エージェントはエンドポイントを選ぶ前に、最新のドキュメントを検索して読むことができます。
• 実データを活用： エディター内から TikTok、Instagram、YouTube、X/Twitter、Reddit、Spotify、ウェブなどを使ってテストできます。
• エディターの設定に API キーは不要： OAuth で一度サインインするだけです。
• どこでも同じ API： MCP ツールは公開 REST API、SDK、ドキュメントに対応しています。

取得できるデータ

Social Fetch MCP は、次のエンドポイントツールを提供します。

• TikTok、Instagram、YouTube、X/Twitter、Telegram、Facebook、Threads、LinkedIn、Reddit、Spotify のデータ。
• プロフィール、投稿、動画、コメント、文字起こし、検索結果、プラットフォーム固有のメタデータ。
• ウェブページの Markdown 生成と、AI を利用したウェブページに関する質問への回答。
• アカウント情報とクレジット残高。
• docs_search と docs_read による Social Fetch のドキュメント。

エンドポイントツールの利用料は REST API と同様に課金されます。ドキュメントツール、auth_whoami、billing_balance_get は検索クレジットを消費しません。

必要条件

• Social Fetch アカウント。
• 従量課金制の API ルートを利用するためのクレジット。
• Cursor、VS Code、Claude Code、Claude Desktop、MCP Inspector など、リモート Streamable HTTP と OAuth に対応した MCP クライアント。

ワンクリックインストール

• Cursor にインストール
• VS Code にインストール
• Windsurf にインストール
• ホスト型インストールページを開く

インストール後、ブラウザーで OAuth のフローを完了してください。ワンクリックリンクが機能しない場合（エディターがインストールされていない、カスタム URL スキームがブロックされている、またはハンドラーがない場合）は、以下の手動セットアップを使用してください。

手動セットアップ

Cursor

~/.cursor/mcp.json またはプロジェクトの .cursor/mcp.json に追加します。

{
  "mcpServers": {
    "socialfetch": {
      "url": "https://api.socialfetch.dev/mcp"
    }
  }
}

Cursor を再起動し、MCP 設定を開いて、求められたらブラウザーで OAuth フローを完了してください。

VS Code

settings.json に追加します。

{
  "mcp": {
    "servers": {
      "socialfetch": {
        "url": "https://api.socialfetch.dev/mcp"
      }
    }
  }
}

Claude Code

claude mcp add --transport http socialfetch https://api.socialfetch.dev/mcp

次に /mcp を実行し、Social Fetch を認証して OAuth フローを完了します。

Claude Desktop

次の URL を使用して、カスタムのリモート MCP コネクターを追加します。

https://api.socialfetch.dev/mcp

Claude から求められたら、Social Fetch を認証してください。

stdio のみをサポートするクライアント

クライアントが stdio MCP サーバーのみをサポートしている場合は、mcp-remote を使用してホスト型サーバーにブリッジします。

npx mcp-remote https://api.socialfetch.dev/mcp

コマンドで起動する stdio プロセスを、クライアントの接続先に設定してください。

認証

Social Fetch MCP は OAuth 2.1 を使用します。フローは MCP クライアントが処理します。

1. クライアントがブラウザーで Social Fetch のサインインページを開きます。
2. サインインまたはアカウントを作成し、アクセスを承認します。
3. クライアントがアクセストークンを受け取り、各 MCP リクエストとともに送信します。

MCP 設定に Social Fetch API キーを貼り付けないでください。REST API リクエストと同様に、クレジットはサインイン中のアカウントに請求されます。

ツール

tools/list はエンドポイントツールとドキュメントツールを公開します。

エンドポイントツール名は、ドットをアンダースコアに置き換えた API オペレーション ID と一致します。

ツール名	API オペレーション
tiktok_profile_get	tiktok.profile.get
instagram_post_get	instagram.post.get
web_markdown_generate	web.markdown.generate
auth_whoami	auth.whoami
billing_balance_get	billing.balance.get

各エンドポイントツールの引数は、対応する API ルートのパラメーターと同じです。エンドポイント一覧、引数スキーマ、レスポンス形式、料金の詳細については、API リファレンスを参照してください。

ドキュメントツールも 2 つ利用できます。

ツール名	目的
docs_search	API、SDK、認証、エラー、クレジット、インテグレーションに関する Social Fetch のドキュメントを検索します。
docs_read	/docs/sdk などのパス名を指定して、ドキュメントページ全体を Markdown 形式で読み込みます。

推奨されるエージェントプロンプト：

Social Fetch MCP のドキュメントを使って、このアプリに TypeScript SDK で TikTok プロフィール検索を追加してください。

例：TikTok プロフィール

Cursor、MCP Inspector、またはその他の MCP クライアントで、tiktok_profile_get を次の引数で呼び出します。

{ "handle": "nike" }

結果には、REST API が返すものと同じ data と meta のエンベロープが含まれます。従量課金の呼び出し後に meta.creditsCharged と meta.requestId を確認してください。

トラブルシューティング

症状	確認すること
すべての呼び出しで 401 が発生する	サーバーを再接続し、OAuth をもう一度完了してください。トークンがないか、期限切れの可能性があります。
OAuth のリダイレクトがループする	Social Fetch でのサインインを完了し、アクセスを承認してクライアントに戻ってください。
402 レスポンスが返される	従量課金対象のルートで使用できるクレジットがアカウントにありません。クレジットと請求でチャージしてください。
ツールが表示されない	サーバーを再接続してください。解決しない場合は、MCP クライアントを再起動してください。
クライアントが stdio のみに対応している	npx mcp-remote https://api.socialfetch.dev/mcp を使用してください。

リポジトリの内容

• server.json - ホスト型リモートサーバーの MCP Registry メタデータ。
• examples/ - コピーして使える MCP クライアント設定のスニペット。
• assets/socialfetch-mark.svg - Social Fetch のマークのローカルコピー（https://api.socialfetch.dev/mcp/icon.svg でも配信されています）。

実装は、この公開リスティングリポジトリではなく、Social Fetch の非公開 API サービスにあります。

関連リンク

• Social Fetch MCP ドキュメント
• Social Fetch API リファレンス
• TypeScript SDK
• n8n コミュニティノード

ライセンス

MIT (c) Social Freak Ltd