TrueScrape

TrueScrape

1 つの API で、Instagram、TikTok、YouTube、X、 Facebook、LinkedIn、Reddit、Threads などのソーシャルメディア公開データを取得できます。プロフィール、投稿、動画、 コメント、文字起こし、広告ライブラリ、各種指標をすべて 1 つのスキーマで扱えます。ターミナルやスクリプトから、または Claude、Cursor、 VS Code 向けの MCP サーバーとして利用できます。

• 登録時に 1,000 クレジットを無料で付与。カード登録は不要です。ほとんどのリクエストは 1 クレジットです。
• 失敗したリクエストや結果が空のリクエストには課金されません。キャッシュヒットは 0 クレジットです。
• クレジットに有効期限はありません。 サブスクリプションは不要です。20,000 クレジットで 25 ドルからのパックをご用意しています。

$ truescrape instagram profile --handle natgeo --pretty
{
  "platform": "instagram",
  "id": "787132",
  "handle": "natgeo",
  "displayName": "National Geographic",
  …
  "verified": true,
  "followerCount": 268245801,
  "followingCount": 195,
  "postCount": 32000,
  …
}
1 credit · live fetch · 1204 ms · req_…

このリポジトリには、ツールやエージェントに接続する 3 つの方法が含まれています。

	インストール	最適な用途
CLI	npm install -g truescrape または npx truescrape …	スクリプト、cron、CI、単発の取得、jq へのパイプ
MCP サーバー	claude mcp add --transport http truescrape https://api.truescrape.com/mcp --header "x-api-key: YOUR_KEY"	Claude、Cursor、VS Code、およびエンドポイントをツールとして呼び出すあらゆる MCP クライアント
エージェントスキル	npx skills add TrueScrape/truescrape	Claude Code、Cursor、Codex、Copilot、Gemini CLI、Windsurf に API の効果的な使い方を教える

45 のプラットフォームにわたる 251 個のエンドポイント。2026-10-30 時点のライブ API から生成されています。

tiktok (28) · facebook (22) · instagram (19) · youtube (17) · deezer (11) · github (10) · reddit (9) · google (8) · linkedin (8) · mixcloud (8) · peertube (7) · spotify (7) · twitter (6) · dailymotion (5) · odysee (5) · rumble (5) · substack (5) · threads (5) · amazon (4) · apple-music (4) · bitchute (4) · mastodon (4) · pinterest (4) · redfin (4) · twitch (4) · walmart (4) · bluesky (3) · kwai (3) · snapchat (3) · soundcloud (3) · telegram (3) · truthsocial (3) · zillow (3) · ebay (2) · identity (1) · inference (1) · kick (1) · komi (1) · linkbio (1) · linkme (1) · linktree (1) · milkshake (1) · pillar (1) · solo (1) · taplink (1)

truescrape.com/dashboard でキーを取得してください。 ドキュメント：truescrape.com/docs · OpenAPI · llms.txt

計画を変える 3 つのルール

1. 失敗したリクエストや結果が空のリクエストには課金されません。 そのまま呼び出してください。
2. キャッシュヒットは 0 クレジットです。 リアルタイムデータが不要な場合は、--cache-max-age 7d（または cache_max_age=7d）を指定してください。
3. 対象が多い場合は、ループではなくバッチを使います。 1 ジョブあたり最大 500 件の対象を指定できます。

CLI

npm install -g truescrape          # or: npx truescrape <command>
truescrape auth login              # stores your key (0600) after checking it
truescrape list                    # platforms
truescrape list youtube            # endpoints for one platform
truescrape youtube channel --handle @mkbhd
truescrape youtube channel-videos --handle @mkbhd --all | jq '.items[].viewCount'
truescrape youtube channel --handle @mkbhd --cache-max-age 24h --format table
truescrape batch youtube transcript --targets ids.json --wait
truescrape download https://x.com/<handle>/status/<id> --out ./videos
truescrape balance

truescrape download <post-url> [--out <dir>] [--force] [--json] は、公開されている Instagram、Facebook、X の投稿から動画を保存します。検索には 1 クレジットがかかり、失敗した場合は費用がかかりません。ファイルはプラットフォーム独自の動画サーバーから直接取得され、HTTPS であること、リダイレクトされないこと、動画であること、150 MB 未満であることを確認します。YouTube のリンクは拒否されます。自分が作成した動画、または使用許可を得ている動画のみをダウンロードしてください。

すべてのエンドポイントは truescrape <platform> <action> --param value の形式です。各コマンドに --help を付けて実行すると、パラメーター、費用、フィールド間の制約を確認できます。

認証の優先順位は次のとおりです。1 回のリクエストに使う --api-key（シェルの履歴に表示されるため、継続的に使う場合は避けてください）、TRUESCRAPE_API_KEY 環境変数（CI やエージェントではこちらを使用してください）、truescrape auth login で保存したキーです。

出力。 データはコンパクトな JSON として stdout に出力されます。課金行（1 credit · live fetch · 412 ms · req_…）は stderr に出力されるため、パイプをクリーンに保てます。

フラグ	効果
--format json|table|csv|markdown	出力形式（デフォルトは json）
--pretty	インデント付きの JSON
--envelope	data の代わりに { data, meta, pagination } を出力
--output <path>	ファイルに書き込み、そのパスのみを出力
--all, --max-pages <n>	カーソルをたどってページを結合（デフォルトの上限は 10）
--quiet	課金行を出力しない
--verbose	リクエスト URL、ステータス、所要時間を stderr に出力
--base-url <url>	別の API オリジンを指定（TRUESCRAPE_BASE_URL も使用可能）

終了コード：0 成功 · 1 API がエラーを返した · 2 使用方法または設定のエラー · 3 API に到達できなかった。stderr がターミナルでない場合、エラーは API 独自の形式で 1 行の JSON として出力され、レスポンスヘッダーのリクエスト ID がその隣に含まれます。 {"success":false,"error":{"code":"invalid_api_key","message":"…"},"requestId":"req_…"}。 401 は常にキーの問題、402 は常に残高の問題です。CLI がこれらを混同することはありません。

MCP サーバー

API は https://api.truescrape.com/mcp でリモート MCP サーバーを提供しています。すべてのエンドポイントがツールであり、すべての呼び出しに HTTP と同じ課金ルールが適用されます。

# Claude Code
claude mcp add --transport http truescrape https://api.truescrape.com/mcp \
  --header "x-api-key: YOUR_KEY" --scope user

# Or let the CLI write the config for you
truescrape agent add claude-code
truescrape agent add cursor            # ~/.cursor/mcp.json (--project for .cursor/mcp.json)
truescrape agent add vscode            # .vscode/mcp.json
truescrape agent add claude-desktop    # claude_desktop_config.json, via the stdio bridge below

Cursor と VS Code で手動設定する場合：

{ "mcpServers": { "truescrape": { "url": "https://api.truescrape.com/mcp", "headers": { "x-api-key": "YOUR_KEY" } } } }

{ "servers": { "truescrape": { "type": "http", "url": "https://api.truescrape.com/mcp", "headers": { "x-api-key": "YOUR_KEY" } } } }

ローカルプロセスしか起動できないクライアントでも、ブリッジを通じて同じサーバーを利用できます。ブリッジは保存済みのキーを使って stdio をリモートエンドポイントに転送します。

{ "mcpServers": { "truescrape": { "command": "npx", "args": ["-y", "truescrape", "mcp"], "env": { "TRUESCRAPE_API_KEY": "YOUR_KEY" } } } }

必要なプラットフォームだけを読み込みます。 URL に ?platforms= を追加すると、エージェントには指定したツールだけが表示されるため、コンテキストを小さく保てます。CLI とブリッジでも同じリストを指定できます。

claude mcp add --transport http truescrape "https://api.truescrape.com/mcp?platforms=youtube,instagram" \
  --header "x-api-key: YOUR_KEY" --scope user
truescrape agent add cursor --platforms youtube,instagram

キーがなくてもツールの一覧を確認できるため、登録前に調べられます。ツールの呼び出しにはキーが必要です。

サーバーは https://api.truescrape.com/.well-known/mcp で URL、トランスポート、認証ヘッダーを公開しています。agent add はこれを読み取り、決めつけて設定することはありません。

エージェントスキル

truescrape は、エンドポイントの選択、料金モデル、バッチ処理、サブスクリプション、把握しておくべきプラットフォーム固有の注意点をエージェントに伝えます。エンドポイントの全一覧は、稼働中の API から生成されます。これを基盤とする 2 つのワークフロースキルもあります。

スキル	機能
video-to-content-brief	YouTube 動画のサンプルから、テーマ、フック、新しい切り口をまとめた出典リンク付きブリーフを作成します
competitor-content-audit	2～5 個の YouTube チャンネルで、同じ最近の投稿サンプルを比較します

どちらも実行前にサンプル数と費用を示し、主張ごとに出典動画へのリンクを添えます。

npx skills add TrueScrape/truescrape                 # pick from the list; Claude Code, Cursor, Codex, Copilot, Gemini CLI, Windsurf
npx skills add TrueScrape/truescrape --skill video-to-content-brief

スキルと MCP サーバーをまとめてインストールする Claude Code プラグインとして利用する場合（サーバーは TRUESCRAPE_API_KEY を読み取ります）：

claude plugin marketplace add TrueScrape/truescrape
claude plugin install truescrape@truescrape

スキルは skills/truescrape/SKILL.md にあります。AGENTS.md は、すでに CLI を利用できるエージェント向けの簡易版です。

開発

pnpm install
pnpm test           # vitest
pnpm typecheck
pnpm catalogue      # regenerate src/catalogue.json and the generated blocks from the live API
pnpm build          # dist/index.js

エンドポイントカタログは自動生成され、手動では編集しません。コミット済みのスナップショットがライブ API と異なると CI は失敗し、API にエンドポイントが追加されると、毎日のジョブがプルリクエストを作成します。付属のカタログに登録されていないコマンドを実行すると、CLI が処理を断念する前に、ライブ API を 1 回更新します。

ライセンス

MIT.