InsightSocial

insightsocial

InsightSocial API の公式 CLI および MCP サーバーです。1 つのキーで、22 プラットフォームの公開データをリアルタイムに取得できます。TikTok、LinkedIn、YouTube、X、Reddit、 Pinterest、Bluesky、Truth Social、Snapchat、Telegram、Twitch、Kick、 Rumble、Kwai、Douyin、Xiaohongshu（RedNote）、Quora、TikTok Shop、Weibo、Zhihu、Substack、Nextdoor に対応しています。

• 230 以上のエンドポイント：プロフィール、公開メールアドレス、投稿、動画、コメント、フォロワー、いいねしたユーザー、ハッシュタグ、 検索、企業ページ、求人、広告、文字起こし、ショップの商品、地域の事業者情報に対応しています。
• すべてのプラットフォームで共通のスキーマ：TikTok の動画も YouTube の動画も、同じフィールド（post.url、post.kind、post.engagement.likes、post.language）で返されます。また、レスポンスで取得できなかったフィールドは unavailable に一覧表示されます。CLI と MCP サーバーは、すべての呼び出しで schema 2 を要求します。
• エンドポイントごとに価格が設定され、呼び出しごとに課金されます。 結果が空の場合、呼び出しが失敗した場合、冪等性のある再実行は無料です。
• エージェント向けに構築されています。 すべての結果が完全な形で保存され、jq を使ってローカルで無料で再抽出できます。そのため、50 KB のページ全体がコンテキストに入ることはありません。

クイックスタート

npx -y insightsocial init              # sign in through your browser, install the agent skill, show MCP setup
npx -y insightsocial search tiktok followers
npx -y insightsocial run /v1/tiktok/profile -p handle=natgeo
npx -y insightsocial view --last --jq '.data.author | {username, followers}'

init と login を実行すると、ブラウザー経由でサインインできます。サインインページが開き、短いコードが表示されるので、そのページでコードを入力して「Allow」をクリックします。すると、このマシンの名前が付いたキーが保存されます。CLI はサインインしたアカウントも表示します。すでに持っているキーを使うには、--api-key を渡してください。新規アカウントには無料の呼び出し分が含まれています。

AI エージェントから使う

Claude Code プラグイン

/plugin marketplace add insightsocial/skills
/plugin install insightsocial@insightsocial

insightsocial/skills から、スキルと MCP サーバーをまとめてインストールします。サーバーがキーを見つけられるように、npx -y insightsocial login を一度実行してください。

MCP サーバー（すべてのクライアントに対応）

claude mcp add insightsocial --scope user -- npx -y insightsocial mcp

{
  "mcpServers": {
    "insightsocial": { "command": "npx", "args": ["-y", "insightsocial", "mcp"] }
  }
}

サーバーは insightsocial login で保存されたキーを読み込むため、設定にシークレットを含める必要はありません。env で INSIGHTSOCIAL_API_KEY を渡すこともできます。キーがなくても、検索と詳細情報の取得は利用できます。

インストールは不要です。同じツールが https://api.insightsocial.app/mcp でホストされています。Claude、 ChatGPT など、OAuth に対応するクライアントは OAuth でサインインします。それ以外のクライアントは、キーを Authorization: Bearer として送信します。MCP ドキュメントを参照してください。

ツール	機能
search_endpoints	キーワードとプラットフォームでエンドポイントを検索します。無料です。
describe_endpoint	1 つのエンドポイントの入力項目、使用可能な値、例、料金を確認できます。無料です。
call_endpoint	データを取得します。完全なレスポンスを保存し、result_id と、項目を絞り込んだ表示（デフォルトは 10 件）、次のページを取得するための next_call を返します。
read_result	保存した結果を jq、フィールド、max_items、またはサイズ付きの概要で再抽出します。無料です。
get_credits	残高、プラン、利用状況を確認できます。無料です。

insightsocial init --yes を実行すると、MCP エントリーが Claude Code、Codex、Cursor に書き込まれます。

コマンド

コマンド
init [--yes] [--no-skills]	キーを保存し、検出されたエージェントにスキルをインストールして、MCP 設定を表示または書き込みます。
login [--api-key k] [--no-browser] / logout	ブラウザーからサインインする（または指定したキーを保存する）／キーを削除します。
search <words> [--platform p]	エンドポイントを検索します。無料です。
list [--platform p]	すべてのエンドポイントとその料金を表示します。無料です。
describe <path>	入力項目、例、料金を表示します。無料です。
run <path> -p name=value …	エンドポイントを呼び出します。./.insightsocial/ に保存します。オプション：--input <json>、-i file、--idempotency-key、--fresh、--max-credits N、-o file、--json、および以下の整形フラグ。
view [file] [--last [endpoint]]	保存済みの結果を整形し直します。ネットワーク通信はなく、料金もかかりません。
credits	残高と使用状況を表示します。無料です。
mcp	標準入出力経由で MCP サーバーを起動します。

整形フラグ（run および view）は表示内容のみを絞り込みます。保存されるファイルは常に完全な内容です。

• --jq <expr>：保存済みのレスポンスに対して実際の jq を実行します（同梱されているため、インストール不要です）。パスは .data から始まります。
• --fields a,b.c：各項目でこれらのキーのみを保持します。ドット区切りのパスで階層をたどります。
• --max-items N：表示する項目を最大 N 件に制限します。
• --summary：バイトサイズを含む構造を表示するため、取得する前にサイズの大きい部分を確認できます。

ページング：次のページがある場合、run は正確な next コマンドを表示します。各ページは個別に課金される呼び出しです。

呼び出し前の料金確認：任意のエンドポイントで -p dry_run=1（または true）を指定すると、見積もりが返され、課金されません。通常はプラットフォームから提供されるフィールドをレスポンスで埋められなかった場合、run はその項目を missing の下に表示します。この場合の null は不明を意味し、ゼロではありません。

設定

キー	--api-key、次に INSIGHTSOCIAL_API_KEY、次に ~/.insightsocial/config.json（モード 600）
INSIGHTSOCIAL_BASE_URL	デフォルトは https://api.insightsocial.app です
INSIGHTSOCIAL_HOME	デフォルトは ~/.insightsocial（設定、カタログキャッシュ、MCP の結果）です

開発

npm install
npm run check      # build + unit tests, no network and no key needed

ライセンス

MIT