Socialcrawl Mcp

---

インストール

リモートサーバー（ホスト型 — インストール不要）

ホスト型の Streamable HTTP エンドポイントに直接接続できます — インストールも実行も不要です:

Claude Code（CLI でも および Web / クラウドサンドボックス上の Claude Code でも動作します）

claude mcp add --scope user --transport http socialcrawl https://mcp.socialcrawl.dev/mcp \
  --header "Authorization: Bearer sc_your_key_here"

.mcp.json を読み込む任意のクライアント

{
  "mcpServers": {
    "socialcrawl": {
      "type": "http",
      "url": "https://mcp.socialcrawl.dev/mcp",
      "headers": { "Authorization": "Bearer ${SOCIALCRAWL_API_KEY}" }
    }
  }
}

Cursor / Windsurf / VS Code — 同じ URL とヘッダーで HTTP（「streamable-http」）サーバータイプを選択します。x-api-key: sc_your_key_here は代替ヘッダーとして使用できます。

ディスカバリーツール（socialcrawl_find、socialcrawl_endpoint、socialcrawl_estimate）はキーなしで動作するため、サインアップ前に試すことができます。claude.ai のカスタムコネクタ（設定 → コネクタ）には OAuth が必要です。OAuth 2.1 リソースサーバーモードはプレビュー版でデフォルトでは無効です（SOCIALCRAWL_OAUTH=1、詳細は docs/REMOTE-STREAMABLE-HTTP.md を参照）。ホスト型サーバーで有効になるまでは、上記のヘッダーベースのセットアップを使用してください。

ローカルでの実行を希望しますか？ 以下のすべての stdio オプションはこれまでとまったく同じように動作します。

npm

npm install -g socialcrawl-mcp

npm で利用可能です。ほとんどのユーザーには必要ありません — 以下の MCP クライアント設定は npx を使用し、初回実行時に自動インストールされます。

Claude Code（最も簡単）

claude mcp add --scope user socialcrawl -e SOCIALCRAWL_API_KEY=sc_your_key_here -- npx -y socialcrawl-mcp

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json（macOS）または %APPDATA%\Claude\claude_desktop_config.json（Windows）に追加します:

{
  "mcpServers": {
    "socialcrawl": {
      "command": "npx",
      "args": ["-y", "socialcrawl-mcp"],
      "env": {
        "SOCIALCRAWL_API_KEY": "sc_your_key_here"
      }
    }
  }
}

Cursor

プロジェクトルートの .cursor/mcp.json またはグローバルな ~/.cursor/mcp.json に追加します:

{
  "mcpServers": {
    "socialcrawl": {
      "command": "npx",
      "args": ["-y", "socialcrawl-mcp"],
      "env": {
        "SOCIALCRAWL_API_KEY": "sc_your_key_here"
      }
    }
  }
}

VS Code（Claude Code）

プロジェクト内の .vscode/mcp.json またはユーザー設定に追加します:

{
  "servers": {
    "socialcrawl": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "socialcrawl-mcp"],
      "env": {
        "SOCIALCRAWL_API_KEY": "sc_your_key_here"
      }
    }
  }
}

Windsurf

Windsurf の MCP 設定に追加します:

{
  "mcpServers": {
    "socialcrawl": {
      "command": "npx",
      "args": ["-y", "socialcrawl-mcp"],
      "env": {
        "SOCIALCRAWL_API_KEY": "sc_your_key_here"
      }
    }
  }
}

その他の MCP 互換クライアント

stdio トランスポートをサポートする任意の MCP クライアントがこのサーバーを使用できます。一般的なパターンは次のとおりです:

• コマンド: npx
• 引数: ["-y", "socialcrawl-mcp"]
• 環境: SOCIALCRAWL_API_KEY に API キーを設定

設定を保存した後、AI クライアントを再起動してください。

概要

socialcrawl-mcp は、AI エージェントを SocialCrawl API に接続する MCP (Model Context Protocol) サーバーです。SocialCrawl API は、ソーシャル、コマース、求人、金融、リサーチ、Web データを統合したデータ API です。タスクを指定せずに socialcrawl_find を実行すると、すべてのプラットフォームが一覧表示されます。socialcrawl_account の freshness を表示すると、ライブの件数を確認できます。

TikTok、Instagram、YouTube、Twitter/X、LinkedIn、Reddit、Threads、Douyin、Xiaohongshu、Telegram、Quora、Bluesky、Apple Music、GitHub、Hacker News、Product Hunt、Polymarket など、多数のプラットフォームからプロフィール、投稿、コメント、検索結果、トレンドコンテンツ、分析データを取得できます。Amazon、Walmart、Target、Home Depot、eBay、Klarna、AliExpress、Etsy、Sephora、H&M、Kohl's、Wayfair、Gumtree、Google Shopping から商品、オファー、価格履歴、レビュー、販売者を取得できます。Google Play と Apple App Store からアプリ、チャート、レビューを取得できます。Tripadvisor からホテル、レストラン、観光スポット、クルーズ、旅行者レビューを、さらに Yelp と Google Business からローカルビジネスデータを取得できます。Trustpilot からブランドの評判を、G2 からソフトウェアレビューを取得できます。LinkedIn、Indeed、Bing、Xing から求人情報と給与レンジを取得できます。市場の相場、価格履歴、財務諸表、オプションチェーン、米国議会の取引開示情報、Naver の韓国語検索と Data Lab トレンドシリーズ、Content Analysis によるセンチメント付きのクロス Web ブランド言及、Google News の見出しと Google Trends の関心曲線を取得できます。さらに Tavily と Perplexity による Web リサーチ、Grok による AI 搭載の X 検索、オンページ SEO 監査、そして 1 回の呼び出しで 14 のソースにファンアウトする単一の /search/everywhere エンドポイントも利用できます。

v2.0.0 の新機能: 11 個ではなく 7 個のツール(socialcrawl_find、socialcrawl_endpoint、socialcrawl_estimate、socialcrawl_request、socialcrawl_collect、socialcrawl_account、socialcrawl_manage)。1.x → 2.0 のマッピングについては利用可能なツールを、すべてのリリースについては CHANGELOG.md をご覧ください。

MCP サーバーが行うこと:

• タスクに適したエンドポイントを平易な言葉で検索し(すべてのエンドポイントを対象としたランキング検索で、URL とハンドルも解決)、各エンドポイントが返すデータをエージェントに伝えます
• すべてのプラットフォーム、メソッド、コンポジットにわたって、お客様に代わってライブデータを取得します
• すべての呼び出しを事前に見積もります(ラダー、定額、または従量制のバンド)。これにより、エージェントは支出前に予算を立てられます
• API を呼び出す前にリクエストをローカルで検証します: 必須パラメータ、oneOf グループ、enum 値、整数範囲、パラメータの組み合わせ、CSV の上限。不正な呼び出しはクレジットを消費せずに無料で失敗します
• エージェントが必要に応じてクエリできる組み込みの API ドキュメントを提供します。切り詰められるのではなく、ページングされます

セットアップ

1. API キーを取得する

socialcrawl.dev でサインアップし、ダッシュボードから API キーを取得してください。すべてのアカウントは 100 の無料クレジットで開始できます。クレジットカードは不要です。

2. キーを設定に追加する

上記のインストール設定にある sc_your_key_here を、実際の API キー(sc_ で始まります)に置き換えてください。

ヒント

MCP 設定に記載する代わりに、SOCIALCRAWL_API_KEY をシステム環境変数として設定することもできます。ディスカバリーとドキュメントのツールはキーがなくても動作します。実際の API リクエストにのみキーが必要です。

使用方法

AI エージェントに自然言語で尋ねてください。あとは MCP サーバーが処理します。

プロフィールを取得する

Get the TikTok profile for @charlidamelio

エージェントは platform: "tiktok"、resource: "profile"、params: { handle: "charlidamelio" } を指定して socialcrawl_request を呼び出し、フォロワー数、プロフィール文、認証ステータス、エンゲージメント指標を含む構造化されたプロフィールデータを返します。

プラットフォームを横断して検索する

Search YouTube for "machine learning tutorials"

投稿のコメントを取得する

Get the comments on this Instagram post: https://instagram.com/p/CwA1234abcd

クロスプラットフォームリサーチ

Compare the follower counts of @mkbhd on TikTok, Instagram, YouTube, and Twitter

エージェントは 4 回の API 呼び出しを順番に実行し(プラットフォームごとに 1 回)、結果を比較にまとめます。

小売業者を横断して購入する

Find the cheapest 65-inch OLED TV across Amazon, Walmart, Target, and eBay

利用可能なエンドポイントを調べる

What social media platforms can you access?

Show me all the TikTok endpoints

Which endpoints can give me video transcripts?

いずれも socialcrawl_find の呼び出しです。タスクを平易な言葉で指定すると、すべてのエンドポイントを横断してランク付けされ、プラットフォームの指定は不要です。

API から API を学ぶ

How do I get started with SocialCrawl?

Show me exactly how to call the Prism comments endpoint

Is this MCP server's endpoint list up to date?

これらは socialcrawl_endpoint と socialcrawl_account を呼び出し、コストはかかりません。

実行する前にコストを確認する

What would it cost to run a Prism brand-mentions report?

Show me everything I can call for 1 credit

Why did that last call charge me 7 credits instead of 2?

最初の 2 つは socialcrawl_estimate を呼び出します。3 つ目は socialcrawl_account に view: "transactions" を指定してクレジット元帳を読み取り、その request_id に対する控除行と返金行を表示します。

ドキュメントにアクセスする

How does the SocialCrawl credit system work?

How do I page through a list endpoint?

レスポンスの例

すべてのレスポンスは統一されたエンベロープ形式に従います。

{
  "success": true,
  "platform": "tiktok",
  "endpoint": "/v1/tiktok/profile",
  "data": {
    "content": { "text": "...", "media_urls": ["..."] },
    "author": { "username": "charlidamelio", "followers": 156000000 },
    "engagement": { "likes": 5200, "engagement_rate": 0.045 },
    "metadata": { "language": "en", "content_category": "entertainment" }
  },
  "credits_used": 1,
  "credits_remaining": 99
}

メモ

どのプラットフォームでも同じレスポンス構造が返されます。プラットフォームごとのパースロジックは不要です。

利用可能なツール

バージョン 2.0.0 では 7 つのツールを公開しています（tools/list は約 4.7k トークンで、1.x の 11 ツールの約 12.8k から減少しています）：

ツール	機能	API キーが必要？
socialcrawl_find	ここから始めてください。 平易な言葉で書かれたタスクが、最適なエンドポイント（デフォルトでは 3 つ）に変換されます。それぞれに、タスクがすでに提供しているパラメータ（URL と @handles は解決されます）、まだ不足しているパラメータ、クレジットコスト、実行すべき正確な呼び出しが含まれます。platform で絞り込めます。タスクがない場合は、プラットフォームの一覧、または 1 つのプラットフォームのエンドポイントを返します。デプロイ時はライブの /v1/utility/find で、それ以外はバンドルされたランカー（id、summary、returns、use_when、tags に対する BM25 とプラットフォームブースト）でランク付けされます	不要
socialcrawl_endpoint	1 つのエンドポイント（id: "tiktok/post/comments"）のコントラクト：目的、必須および任意のパラメータ、行の位置（rows_at）と最大 25 のレスポンスフィールド、コストと価格ルール、ページング、実測レイテンシとタイムアウト、次のエンドポイント、サンプルレスポンスへのリンク。プラットフォームスラッグはエンドポイントテーブルを返し、トピック（errors、pricing、pagination、judgments、hydration、overview など）はそのガイドを返します。キーが設定されている場合は /v1/utility/endpoint を通じてライブで提供されます	不要
socialcrawl_estimate	消費する前に正確なコストを算出：1 回の呼び出し（id + 送信する params、ジョブ合計には calls、ウォークには items）または呼び出しの plan。デプロイ時は /v1/utility/estimate を、それ以外はバンドルされた価格を使用します。プラットフォームスラッグは価格テーブルを返し、id がない場合は価格の概要を返します	不要
socialcrawl_request	1 つのエンドポイントを呼び出します：platform、resource、params（POST バッチエンドポイントの場合は body）。まずローカルで検証し、見積もりを行い、max_credits を超える場合は拒否し、SOCIALCRAWL_CONFIRM_ABOVE を超える場合は確認を求め、structuredContent（行、クレジット、ページング）を返します。fields / max_items / format で結果を整形します。大きなページは行の境界で分割され、socialcrawl://results/<request_id> リンクの背後に置かれます。不明なプラットフォームやリソースには did-you-mean が返されます	必要
socialcrawl_collect	ページングされたエンドポイントを、items 件の一意な行、最後のページ、または max_credits まで 1 回の呼び出しでウォークし、すべての行へのリソースリンクを JSONL、JSON、または CSV で提供します	必要
socialcrawl_account	無料チェック：balance（このセッションの消費を含む）、transactions（項目別の台帳、または 1 つの request_id のレシート）、status（プラットフォームの健全性）、freshness（このサーバーのカタログが API より遅れているか）	必要（status を除く）
socialcrawl_manage	area + action によるステートフルな作業：monitors（スケジュールされたレシピ）、cohorts（自分のパネルに対するメンション検索）、web（スクレイプ、検索、マップ、抽出、クロール/バッチ/エージェントジョブ、変更モニター、ブラウザセッション）、jobs（Prism バックグラウンドジョブ：送信、一覧、取得）。アクションのフィールドは input に、リソース id は id に入れます。誤ったフィールドはルールとともに無料で拒否されます	必要

1.x からのアップグレード。 SOCIALCRAWL_LEGACY_TOOLS=1 を設定すると、このメジャーバージョン向けに、廃止された 9 つの 1.x 名を薄いラッパーとしても登録します。マッピング：

1.x ツール	2.0 ツール
socialcrawl_list_platforms	引数なしの socialcrawl_find
socialcrawl_list_endpoints	socialcrawl_find（task または platform）。1 つのコントラクトには socialcrawl_endpoint
socialcrawl_pricing	socialcrawl_estimate
socialcrawl_discover	socialcrawl_endpoint（エンドポイントガイド）、socialcrawl_find（カタログ、プラン）、socialcrawl_account（freshness、status）
socialcrawl_get_docs	トピックを id とした socialcrawl_endpoint
socialcrawl_check_balance	socialcrawl_account（requestId は request_id になりました）
socialcrawl_monitors / socialcrawl_web / socialcrawl_cohorts	area: "monitors" / "web" / "cohorts" を指定した socialcrawl_manage
socialcrawl_request、socialcrawl_collect	変更なし（platform は did-you-mean 付きのプレーンな文字列になりました）

検出、ライブおよびバンドル

socialcrawl_find、socialcrawl_endpoint、socialcrawl_estimate は、サーバーにバンドルされたデータ（バックエンドのレジストリから生成、ダンプスキーマ v4）から応答し、キーは不要です。キーがある場合は、まず API の無料 /v1/utility/* ルート（find、resolve、endpoint、estimate）に問い合わせ、これらはライブレジストリから応答し、ルートがデプロイされていない場合はバンドルされた応答にフォールバックします。これらのいずれも 0 クレジットです。

鮮度が重要な理由。 このサーバーは、ビルド時に生成されたカタログを同梱していますが、API は動き続けます。データ呼び出しは常にライブ API にアクセスするため動作し続けますが、検出、価格設定、ローカル検証はそのスナップショットから応答します。サーバーはこれをプロセスごとに 1 回自身でチェックし、遅れている場合は次のツール結果に 1 行を追加します。無料の 1 回の呼び出しで、どちらの状況にあるかがわかります:

socialcrawl_account  view: "freshness"

これらの同じエンドポイントはプレーンな HTTP であるため、サードパーティの統合や MCP 以外のエージェントフレームワークでも curl で同一の情報を取得できます。

価格設定 — 使う前にコストを知る

socialcrawl_estimate が存在するのは、ほとんどの領域において単一の数値は嘘になるからです。SocialCrawl の課金は 3 通りあります:

• ラダー — リクエストごとのティア料金: 標準 1cr、アドバンスト 5cr、プレミアム 10cr。
• フラット（一部は無料） — エンドポイントごとの上書き、例: /v1/search/everywhere は 20cr フラット。
• 従量制 — 料金はリクエストによって異なります。事前の上限が差し引かれ、実際に行われた処理分まで返金されます。

従量制エンドポイントの基本コストを見積もると、すべての呼び出しを過小評価することになります: /v1/search/news は 1cr の基本料金ですが、実際には 2〜62cr を請求します — 記事を返す Google の国別レッグごとに 1 クレジット、さらに bing エンジンが追加された場合は記事ごとの課金です。このツールは、実際の価格帯、レジストリ自身の課金ルール、請求額を変動させるパラメーター、予算として見込むべき最悪のケースを返します:

action: "overview"   → ladder, every free endpoint, every flat override, every metered band + rule, cache TTLs, full refund matrix
action: "endpoint"   → one endpoint's price, rule, price-driving params, paging cost, worst case
action: "platform"   → a whole platform's cost table
action: "list"       → rank/filter by cost — "everything I can call for 1 credit", "the 10 most expensive endpoints"
action: "hydration"  → every include= row join: what it fills, per-row rate, row cap, fully-joined ceiling
action: "judgments"  → every judged list: free default labels/relevance, metered presets, the hold per opt-in

action: "endpoint" に送信する予定の include を渡すと、価格帯が算術的に算出されます — バックエンドの価格計算ツールが実行するのと同じ式を使い、結合ごとに項目化された正確な保留額です:

action: "endpoint", platform: "linkedin", resource: "search/people", include: "profile", rows: 3
→ holds 22 credits (10cr page + 12cr for 3 rows of `profile`), settling anywhere down to 10

あるいは、送信する正確な params（およびジョブ全体の場合は calls）を渡します。結合、従量制の判定、max_pages はすべて項目化され、max_pages はページ数を乗算します。なぜなら、走査される各ページは 1 回の呼び出しとして課金されるからです:

action: "endpoint", platform: "youtube", resource: "search", calls: 10,
params: { query: "espresso", include: "engagement,channel", label: "mention", brand: "Acme", max_pages: "3" }
→ 1cr page + 5cr engagement + 5cr channel + 4cr label=mention = up to 15cr per page
  × 3 pages = up to 45cr per call; 10 calls = up to 450 credits held, settling to what was filled and judged

また、実際の請求額が表示価格と異なる理由となるルールも示します。キャッシュヒット、冪等なリプレイ、空の結果、上流の障害、dry_run=1 のプレビューはすべて 0 クレジットです。seen=<id> は、すでに受け取った行の割合分だけ各ページを割引します。since / stop_at_id は、すでに保持している行で走査を終了します。

判定 — ラベルと関連性、デフォルトで無料

約 50 のリストエンドポイントは、追加クレジットなしで行を判定します。投稿には sponsored、intent、niche が付きます。コメントには sentiment、question、purchase_intent、complaint が付きます。レビューには sentiment と issue が付きます。これらはすべて computed.labels に入り、判定された検索はクエリに対する各行の関連性を computed.relevance でスコアリングします。クレジットを追加するのは以下のみです:

• 従量制プリセット: 投稿の mention（brand= 付き）、quality、injection。コメントの spam、toxic、low_quality。レビューの reports、incentivized。
• label=intent と offer=（あなたが販売するもの）の組み合わせ。
• relevance=score|filter と relevant_to= にあなた自身のトピックを指定。

それぞれ、ページの開始 25 行ごとに 1 クレジットを保持し（100 行のページで 4cr）、新たに判定された行まで精算されます。すでに判定済みの行とキャッシュされたページは無料です。judgments=off はデフォルトを無効にし、dry_run=1 は 0 クレジットでコストをプレビューします。id: "judgments" を指定した socialcrawl_endpoint が完全な契約です。

行ハイドレーション — 1 行ごとのページ取得とルックアップの代わりに 1 回の呼び出し

一部のリストが薄いのは、上流がそれ以上何も公開していないからです。Pinterest の検索結果には保存数がなく、LinkedIn のリアクター行にはフォロワー数がなく、YouTube の再生リストには再生回数や再生時間がありません。別の SocialCrawl エンドポイントが、それらのそれぞれを 1 行ずつ回答します。そのため、これらのエンドポイントは include= トークンを受け付け、同じ呼び出し内で各行をその兄弟エンドポイントに結合します。

GET /v1/pinterest/search?query=kitchen&include=engagement      → saves, likes, comments, shares on every row
GET /v1/youtube/playlist?playlistId=PL...&include=engagement,channel
GET /v1/linkedin/search/people?keywords=cto&include=profile&limit=3

• オプトイン。 トークンがなければ、結合も、追加クレジットも、追加レイテンシもありません。決して要求しない呼び出し元は、これまでどおりのコストしか支払いません。
• 実際に埋まった行ごとに課金。 上限は事前に確保されます。クレジットは、新たな兄弟ルックアップが埋めた行に対してのみ保持されます。兄弟エンドポイントのキャッシュから提供された行は無料で、埋められない行は返金され、完全に結合されたページは丸ごとキャッシュされるため、直後の繰り返しは 0 クレジットです。
• 行数上限が請求額の上限になります。 LinkedIn での limit=3&include=profile は 50 ではなく 22 クレジットを確保します。
• 何を行ったかを通知します。 data.hydration は行数、ルックアップ数、キャッシュヒット数、確保クレジットと保持クレジット、ミリ秒を報告します。_warnings は一部の行のみが埋まった場合に <token>_partial を含みます。

id: "hydration" を指定した socialcrawl_endpoint は、すべての結合、その価格、完全な契約を一覧表示します。socialcrawl_estimate は include を伴う 1 回の呼び出しを見積もります。

モニター — あらゆるレシピをスケジュール実行

area: "monitors" を指定した socialcrawl_manage は、任意のレジストリエンドポイントまたは Prism コンポジットを、スケジュールされたステートフルなモニター (/v1/monitors/*) でラップします。レシピを毎時/毎日/毎週 (または cron で) 再実行し、各結果を HMAC 署名付き webhook に配信し、メトリクスのしきい値や変化に対してアラートを発し、読み返せる実行ごとの時系列を保持します。「Prism は一度だけ答える。モニターがそれをあなたの代わりに見守る。」 モニターの管理は 0 クレジットです。各スケジュール実行は、レシピの通常コストに加えて 1 クレジットのスケジューリング プレミアムを請求します。完全な契約については、id: "monitors" を指定した socialcrawl_endpoint をご覧ください。

Web — スクレイプ、クロール、ブラウズ

area: "web" を指定した socialcrawl_manage は、単一の action パラメータを通じて、Web スクレイピングとブラウザ自動化の全機能 (web プラットフォーム、/v1/web/*) を操作します。

• 同期読み取り — scrape (URL → markdown/HTML/スクリーンショット/リンク)、search (ページ内容付きの Web 検索)、map (サイトの URL を発見)、extract (ページからの LLM 構造化データ)。
• 非同期ジョブ — サイト全体を crawl、多数の URL を batch_scrape、または agent (自律的なマルチステップ Web タスク)。それぞれがジョブを返し、job_get/job_list でポーリングし、job_errors (ページごとの失敗) で検査し、job_cancel で停止できます。crawl_preview は、料金を支払う前にクロールのパラメータを無料でドライランします。
• モニター — monitor_create/list/get/update/delete/checks は、URL を定期的に再チェックし、変更を webhook に配信します。
• セッション — session_create/get/list、session_execute (ライブページでコードを実行)、session_close。

有料の Web 機能のほとんどは定額ではなく従量制です。クロールは limit クレジットを確保し、クロールしなかったページごとに返金します。セッションは ttl_seconds に対して確保し、クローズ時に精算します。ジョブ、モニター、セッションの管理は 0 クレジットです。id: "web" を指定した socialcrawl_endpoint、または id: "web" を指定した socialcrawl_estimate をご覧ください。

スマート検証

API 呼び出しを行う前に、socialcrawl_request はバックエンド自身の課金前バリデータを、バンドルされたレジストリデータに対してミラーリングします。プラットフォームとリソースが存在すること、必須パラメータと oneOf グループが満たされていること、enum 値が正当であること、整数が宣言された範囲内にあること、パラメータの結合関係が保たれていること (order には sort が必要、Reddit の timeframe には sort=top が必要)、CSV リストがそのエントリ上限内にあることを検証します。不正な呼び出しは、往復のコストをかけずに即座に無料で失敗します。そしてエージェントは、決して成功し得ない呼び出しをループするのではなく、何を修正すべきかを正確に伝えられます。

再試行しても安全なリクエスト

socialcrawl_request に idempotencyKey（UUIDv4 を推奨）を渡すと、呼び出しを再試行しても安全になります。24 時間以内にリクエストが再送された場合、サーバーは元のレスポンスを返し、0 クレジットを差し引きます（X-Idempotent-Replay: true）。

対応プラットフォーム

プラットフォーム	利用可能なデータ
LinkedIn	プロフィール（単一のサブリソースまたは一括取得バンドル: all、complete、with-posts）と企業ページ（ドメインによる検索、also-viewed、従業員数を含む）、投稿とコメント付き投稿、リポスト、リアクション、コメントと返信、コメントとリアクション付きの Pulse 記事、人物検索（キーワードまたは検索 URL）、企業・ハッシュタグ検索、類似メンバー、プロフィールのサブリソース（職歴、学歴、スキル、職種スキル、資格、フォロー中の学校/ニュースレター/Top Voices、最終アクティビティなど）、求人（検索、企業の求人、メンバーが投稿した求人、採用チーム、詳細）、企業インサイト、グループ、完全な投稿履歴アーカイブ（投稿ごとの従量課金）、トランスクリプト、Ad Library、profile-360
Prism	クロスプラットフォームの複合データ — URL 検索、コメント収集、投稿統計/プロフィール/コメントの一括検索、最大 5,000 件の非同期バックグラウンドジョブ、ハンドル監査、名前→アカウントの解決（find-accounts）、ハンドル/リンクのメンション、不適切な投稿のスクリーニング、キャンペーンブリーフのチェック、フック/フォーマットの効果測定、用語の早期性、キーワード不要の国別トレンドボード、コメント投稿者の言語構成、コメント由来の購入リード、ブランドメンション、需要シグナル、AI 可視性、クライシスレーダー/ポストモーテム、レピュテーション、シェアオブボイス、クリエイター審査とクリエイターカード、組織レーダー、Korea gap、AI コンセンサス回答、動画/アプリ/製品インテリジェンス
Instagram	プロフィール、アカウントの透明性（profile/about）、投稿、リール、コメントとコメント返信、ハイライト、ストーリーズ、タグ付け・位置情報フィード、フォロワー/フォロー中、類似アカウント、投稿のいいねしたユーザー、リシェア統計、シェア数付きのリール/投稿フィード一括取得、エンゲージメント分析、ユニバーサル検索 + 人気投稿検索、リール/ハッシュタグ/プロフィール/位置情報/音楽検索（include=creator によるクリエイターカード付きリール検索）、画面上のテキスト（OCR）、トレンド、トランスクリプト、profile-360
TikTok	プロフィール、動画、コメントと返信、画面上のテキスト抽出、キーワード/ハッシュタグ/ユーザー/音楽検索 + サジェスト、ハッシュタグ詳細、トレンド（グローバルまたは国内の For You）、TikTok 自身の人気ハッシュタグと Top Videos ボード、オーディエンス、類似アカウント、フォロワー、いいねした動画、プレイリストとコレクション、場所フィード、エフェクト、ライブ、楽曲、トランスクリプト、Ad Library、profile-360
Facebook	ページ、グループとグループ投稿、投稿、コメントと返信、写真、リール（再生数付きの完全なリールフィードを含む）、イベントとイベント検索、Marketplace、投稿/ページ/人物/動画/グループを対象としたキーワード検索、トランスクリプト、完全な Ad Library
YouTube	チャンネル、動画、ショート、コメントと返信、スポンサー、プレイリストとその項目、コミュニティ投稿、検索（高度な検索 + オートコンプリート）、トレンド、ライブ配信、チャンネルの連絡先メール検索、メディアファイル（音声/動画/字幕/サムネイル）、トランスクリプト、動画/チャンネル/トランスクリプトの一括取得、profile-360
Web Scraping	スクレイピング、ウェブ検索、サイトマップ、LLM 抽出、ページごとのエラーフィード付きの非同期クロール/一括スクレイピング/エージェントジョブ、変更監視、インタラクティブなブラウザセッション、ドキュメント解析 — socialcrawl_manage（エリア web）で操作します
US Congress Trades	米国議会の STOCK Act 開示情報 — 取引フィード（all/48h/7d）、議員、政治家別・ティッカー別の統計と取引、州別代表団、および統計スイート一式（政党、セクター、発行体、出来高、異常な活動、買い/売り比率、遅延提出）
Klarna	商品詳細とすべてのマーチャントオファー、キーワード検索 + サジェスト、スコア概要付きのユーザーレビューとプロフェッショナルレビュー、価格履歴、商品比較、フィルター/キーワード/購入ガイド付きのカテゴリ閲覧、ストア一覧
Tripadvisor	ホテル、レストラン、アトラクション、クルーズ船 — それぞれの検索と完全な詳細、オーナー返信付きの旅行者レビュー、URL による場所検索、目的地のオートコンプリート、体験タイプ
Twitter/X	プロフィール、ツイートと返信、ツイート・ユーザー検索、ユーザーメディア、フォロワー、フォロー中、リツイートしたユーザー、コミュニティ、動画トランスクリプト、Grok による AI 検索、profile-360
Naver	韓国最大のポータル — ブログ、ニュース、百科事典、カフェ、KiN、ローカル、画像、ウェブ検索、誤り・成人向け分類器、Data Lab の検索トレンド・ショッピングインサイトシリーズ、ブリーフ
Reddit	サブレディット、投稿詳細、コメント、投稿とコメント履歴付きのユーザープロフィール、キーワード/コメント/メディア検索、サブレディット探索、トランスクリプト、omni-search VoC スイープ
GitHub	ユーザー、リポジトリ、Issue、PR、README、リリース、検索、リポジトリのドシエ、ユーザープロフィールのアクティビティ速度
Gumtree	英国のクラシファイド — 出品検索と詳細、類似出品、出品者プロフィールとその広告、検索サジェスト、トレンド検索、フィルター付きカテゴリツリー、位置情報検索
Jobs	LinkedIn、Indeed、Bing、Xing を横断した求人検索と求人詳細、LinkedIn 組織 ID の解決、職種と国別の給与レンジ
Sephora	商品詳細、レビュー、キーワード検索 + サジェスト、カテゴリツリー閲覧、ブランド一覧とブランド別商品、店舗検索、SKU 別の店舗在庫状況
Content Analysis	ウェブ横断のブランドメンション、センチメント、評価分布、フレーズ/カテゴリのトレンド
Google	ウェブ検索、Ads Transparency、ビジネスプロフィール（情報、レビュー、更新、Q&A）、Travel ホテル
AliExpress	商品詳細、キーワード検索、類似商品、レビュー、SKU 別送料、人気商品、特集プロモーション、カテゴリツリー
Apple App Store	アプリ検索、検索サジェスト、アプリ詳細、レビュー、ランキング、リスティングデータベース、参照データ
Google Play	アプリ検索、検索サジェスト、アプリ詳細、レビュー、ランキング、リスティングデータベース、参照データ
Amazon	商品検索、ASIN 詳細、レビュー、出品者、ショップページ、Best Sellers ランキング、現在のセール、出品者プロフィール — 約 13 のマーケットプレイス
Douyin	中国の TikTok — 動画検索、クリエイタープロフィールとフィード、動画詳細、コメントとコメント返信、クリエイター検索、ホットサーチボード（ほとんどが行ごとの従量課金）
Finance	銘柄のクォート、ティッカー検索、マーケット概況、銘柄ニュース、日次価格履歴、企業財務諸表、オプションチェーン
G2	ソフトウェアマーケットプレイス — 製品ページ、レビュー、カテゴリ一覧とカテゴリインデックス、ベンダープロフィールとそのカタログ、製品 URL インデックス
Quora	質問検索と詳細、回答検索、Space 投稿検索、プロフィール検索、Space/トピック検索
H&M	キーワード検索 + サジェスト、国別の店舗一覧、国/言語、カテゴリツリー、製品ごとのサプライヤー・工場の開示情報
Pinterest	ピン、ボード、ユーザーボード、検索、国別の Pinterest Trends、URL の保存数
Spotify	アーティスト、トラック、アルバム、ポッドキャスト、エピソード、検索
Threads	プロフィール、投稿、投稿コメント、キーワード検索、ユーザー検索
Utility	無料 API のセルフディスカバリー — クイックスタート、エンドポイントカタログ、エンドポイントごとの使用ガイド、横断的機能のインデックス、平易な言葉による呼び出しプランナー、LLM コンテキストペイロード。0 クレジット、ライブレジストリから提供。socialcrawl_find、socialcrawl_endpoint、socialcrawl_estimate、socialcrawl_account の背後で動作します
Xiaohongshu	RED / 小紅書 — ノート検索、ホットサーチボード、クリエイタープロフィールとそのノート、ノート詳細、トップレベルコメント（返却行ごとに 5cr）
Apple Music	カタログ検索、アーティスト、アルバム、トラック、国別ランキング（楽曲、アルバム、ミュージックビデオ、プレイリスト）
Google Shopping	商品検索、商品詳細、価格履歴、小売業者を横断したレビュー、販売者別オファー
Kohl's	キーワード検索、レビュー、製品の質問と回答、店舗検索、カテゴリツリー
Rumble	検索、チャンネル動画、動画詳細、コメント、トランスクリプト
Target	TCIN による商品詳細、レビュー、カテゴリ閲覧、完全な分類体系、店舗検索
TikTok Shop	商品、レビュー、リスティング、検索、クリエイターショーケース
Universal Search	1 つのクエリを多数のプラットフォームに展開（20cr 定額）、multi — 指定した各プラットフォームのネイティブ検索を 1 回の呼び出しで実行し、それぞれのページ価格の合計で課金、フォーラムレーン、多国間ニュースレーン（従量課金）、TikTok/Threads/Instagram を横断したクリエイターディスカバリーレーン
Walmart	商品詳細、レビュー、キーワード検索、カテゴリ閲覧、出品者オファー
Yelp	encid によるビジネスプロフィール、ビジネスレビュー、ビジネス検索（コンパクトとフルカード）、検索サジェスト
Bluesky	プロフィール、ユーザー投稿、投稿詳細、キーワード投稿検索
Etsy	ID または URL によるリスティング、ショップのカタログ、類似リスティング、検索サジェスト
Hacker News	ストーリー検索、ストーリー、コメントツリー、プロフィール
Home Depot	キーワード検索、アイテム ID または URL による商品詳細（店舗/ZIP 対応の価格）、レビュー、ZIP による店舗検索
Tavily	ウェブ検索（LLM 回答付き）、URL 抽出、サイトマップ、完全クロール
Twitch	プロフィール、クリップ、動画、スケジュール
Google Trends	時系列の関心度（explore）、上昇中/急上昇の関連クエリ、地域別の Trending Now
Kwai	プロフィール、投稿
Telegram	公開チャンネルのプロフィール、チャンネル投稿フィード、単一投稿の検索
Truth Social	プロフィール、投稿
Wayfair	商品検索、SKU による商品詳細、レビュー
eBay	落札済み/完了済みの実現価格を含むリスティング検索、リスティング詳細
Snapchat	プロフィール、Spotlight コメント
Trustpilot	ビジネス検索、企業レビュー
Google News	リアルタイムの Google News SERP 検索
Kick	クリップ
Komi	リンクページ
LinkBio	リンクページ
LinkMe	リンクページ
Linktree	リンクページ
On-Page	単一 URL のオンページ SEO 監査 — 技術面、コンテンツ、メタのチェックを 1 回の呼び出しで実行
Perplexity	引用元付きの Sonar ウェブリサーチ
Pillar	リンクページ
Polymarket	予測市場のリサーチ — マルチクエリの展開 + ランキング
Product Hunt	現在の Product Hunt ローンチ（1 ページあたり約 50 件）、任意でトピック別
socialcrawl_find をタスクなしで実行すると、すべてのプラットフォームがそのライブエンドポイント数とともに一覧表示されます。

エラーハンドリング

MCP サーバーはエラーを適切に処理し、エージェントに実行可能なガイダンスを提供します。すべての API エラーはサーバー自身の error.message をそのまま通過させ、API が理由を示す場合は reason: … を続け、request_id: req-… を独立した行に記載します（ボディから、またはボディが JSON でない場合は X-Request-Id ヘッダーから読み取ります）。問題を報告する際は request_id を引用してください。これがログとクレジット台帳で呼び出しを特定する方法です。

エラー	エージェントに表示される内容
API キーが不足	SOCIALCRAWL_API_KEY を設定するよう促し、サインアップへのリンクを表示
API キーが無効	キーの設定を確認するよう要求
クレジット不足	残高を表示し、請求ページへのリンクを提示
プラットフォーム/リソースが不正	適切なエンドポイントを見つけるためにディスカバリツールの使用を提案
パラメータが不足	不足しているものを具体例とともに正確に列挙 — 請求前にローカルで検出
パラメータ値が不正	不正な enum 値、範囲外の整数、壊れた結合、または長すぎる CSV を特定 — 請求前にローカルで検出
リソースが見つからない (404)	項目が存在しないサーバー側の理由（例: reason: video_gone）と、課金されたかどうか (BIL-01)
Idempotency-Key の競合 (409)	そのキーが別のアカウントで使用されたことをエージェントに伝え、新しいキーの生成を促す
Idempotency-Key のペイロード不一致 (422)	同じキーが異なるパラメータで再利用されたことをエージェントに伝える
メソッドが許可されていない (405)	そのルートに対して誤った HTTP メソッドであることを報告
ペイロードが大きすぎる (413)	リクエストボディが JSON サイズ上限を超過；パース前に拒否
レート制限 (429)	キーごとの 600 req/min の時間枠を超過 — 未課金；バックオフして再試行
同時実行数の制限 (429)	呼び出し元にバックオフを要求（キーあたり最大 50 同時）
キー予算の超過 (402)	アカウントにはまだクレジットがあるのに、このキー自体の支出上限を使い切った — 上限を引き上げ、補充しないこと
上流失敗 (502)	どのプラットフォームが失敗したか、返金、および再試行のタイミングについてのサーバー側の説明
プラットフォームが利用不可 (503)	サーバー側の原因（サーキットブレーカーが開いている、または上流のスロットリング）と再試行のヒント；クレジットは返金済み

リンク

• API キーを取得 — 100 クレジット無料、クレジットカード不要
• API ドキュメント — 完全なエンドポイントリファレンス、クレジット、エラーコード
• SocialCrawl ウェブサイト
• npm パッケージ
• MCP レジストリ
• はじめにガイド
• 仕組み