Extracto

extracto-mcp

Extracto 用の Model Context Protocol サーバーです。Claude、Cursor、Claude Code、およびあらゆる MCP クライアントで、URL とスキーマから、検証済みの型付き JSON を生成できます。プロンプトエンジニアリングも HTML の解析も不要で、存在しないフィールドが作り出されることもありません（不足しているデータは null で返されます）。

クイックスタート

Extracto API キーが必要です。app.getextracto.dev/keys で取得してください。

このサーバーは stdio 経由で動作し、npm で公開されているため、ほとんどのクライアントではこの設定ブロックを追加するだけで使えます。

Claude Desktop

claude_desktop_config.json を編集します（設定 → 開発者 → 設定を編集）。

{
  "mcpServers": {
    "extracto": {
      "command": "npx",
      "args": ["-y", "extracto-mcp"],
      "env": { "EXTRACTO_API_KEY": "exa_live_your_key_here" }
    }
  }
}

Cursor

同じ設定ブロックを ~/.cursor/mcp.json（またはプロジェクトの .cursor/mcp.json）に追加します。

Claude Code

claude mcp add extracto -e EXTRACTO_API_KEY=exa_live_your_key_here -- npx -y extracto-mcp

クライアントを再起動して、抽出したい内容を尋ねます。たとえば、「extracto を使って github.com/facebook/react からタイトル、言語、スター数を取得して。」 と尋ねます。

ツール

ツール	説明
extract	単一の URL から同期的に抽出します（最大約 90 秒）。{ data, meta } を返します。
extract_async	負荷の高いページやボット対策が施されたページのために、非同期ジョブを送信します。ジョブ ID をすぐに返します。
get_job	非同期ジョブのステータスと結果をポーリングします。
list_jobs	最近の非同期ジョブを一覧表示します。

schema 引数

スキーマは、フィールド名を型に対応付けるオブジェクトです。型は次のとおりです。

• リテラル："string"、"number"、"boolean"、"array"、"object"
• リストを表す要素数 1 の配列：["string"]、または [{ "title": "string" }]
• ネストされたオブジェクト：{ "author": { "name": "string" } }

{
  "title": "string",
  "price": "number",
  "tags": ["string"],
  "reviews": [{ "user": "string", "stars": "number" }]
}

実際にページ上で見つかったフィールドのみが返されます。不足しているフィールドは推測されず、null になります。

設定

すべての設定は、MCP クライアントから渡す環境変数で行います。

変数	必須	説明
EXTRACTO_API_KEY	はい	app.getextracto.dev/keys で取得したキーです。
EXTRACTO_BASE_URL	いいえ	API ホストを上書きします（デフォルトは https://app.getextracto.dev）。
EXTRACTO_TIMEOUT_MS	いいえ	リクエストごとのタイムアウト（ミリ秒、デフォルトは 90000）です。

開発

npm install
npm run dev        # run from source with tsx
npm run typecheck
npm run build      # bundle to dist/ with tsup

関連項目

• extracto — 公式の TypeScript/JavaScript SDK です。
• getextracto.dev — ドキュメントと API リファレンスです。

ライセンス

MIT