Extrapify

Extrapify MCP

Claude Desktop、Cursor、または MCP 互換クライアント内で、あらゆる公開 Web ページから構造化 JSON を抽出できます。

スキーマを定義し、URL を指定すると、検証済みの型付き JSON が返されます。

API キーを取得 → extrapify.com

---

これは何か

MCP クライアントとホステッド版の Extrapify API をつなぐ、軽量でステートレスな MCP サーバーです。

抽出処理はこのパッケージ内では行われません。MCP サーバーはリクエストを Extrapify API に転送し、API がバックエンドでのページ取得、JavaScript を多用するページ向けの Browserless によるレンダリング、Claude を活用した抽出、スキーマ検証、クォータ管理、可観測性を担います。

• stdio 経由の MCP プロトコルサーバー
• ツールは 1 つ：extract_structured_data
• スクレイピングフレームワークではなく、本番環境向けのブリッジ
• 抽出ロジックなし、状態なし、副作用なし

---

インストール

npm install

.env.example を .env にコピーし、認証情報を入力します。

EXTRAPIFY_API_BASE_URL=https://extrapify.com
EXTRAPIFY_API_KEY=sk_live_your_key_here

サーバーを起動します。

npm run mcp:start

---

Claude Desktop の設定

このブロックを Claude Desktop の設定ファイル（claude_desktop_config.json）に追加します。

{
  "mcpServers": {
    "extrapify": {
      "command": "node",
      "args": ["/absolute/path/to/extrapify-mcp/mcp/server.mjs"],
      "env": {
        "EXTRAPIFY_API_BASE_URL": "https://extrapify.com",
        "EXTRAPIFY_API_KEY": "sk_live_your_key_here"
      }
    }
  }
}

Claude Desktop を再起動します。extract_structured_data ツールが自動的に表示されます。

---

Cursor の設定

Cursor は stdio MCP サーバーに対応しています。node とローカルの mcp/server.mjs エントリーポイントを、同じ 2 つの環境変数で指定してください。

コピーして使用できる設定例については、docs/mcp-install-examples.md を参照してください。

---

ツール：extract_structured_data

定義したスキーマを使って、あらゆる公開 Web ページから構造化 JSON を取得します。

入力：

{
  "url": "https://example.com/article",
  "mode": "auto",
  "schema": {
    "title": "string",
    "author": "string",
    "published_at": "date",
    "tags": "string[]"
  }
}

出力：

{
  "extracted": {
    "title": "How Claude Agents Are Changing Developer Workflows",
    "author": "Jane Smith",
    "published_at": "2026-04-15",
    "tags": ["AI", "agents", "developer tools"]
  },
  "type": "single",
  "count": 1,
  "confidence": 0.96,
  "tokens_used": 1820
}

対応するスキーマ型： string、number、integer、float、boolean、date、datetime、url。また、これらの型の末尾に [] を付けた配列（例：string[]）にも対応しています。

対応する mode の値：

• auto — ページ構造に基づいて Extrapify に判断させます
• single — 主な項目のみを抽出します
• list — 一致するすべての項目を配列として抽出します

---

スキーマテンプレート

一般的なユースケース（商品ページ、求人情報、記事、企業データ）向けのスタータースキーマは、docs/schema-templates.md にあります。

---

ワークフローの例

エージェントのパターンとデモ用ワークフローは、docs/demo-workflows.md にあります。

---

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

stdio トランスポートに対応する MCP クライアントであれば、このパッケージで動作します。通常、必要なのは以下の設定だけです。

• command：node
• args：mcp/server.mjs の絶対パス
• env：EXTRAPIFY_API_BASE_URL と EXTRAPIFY_API_KEY

---

トラブルシューティング

症状	対処方法
サーバーがすぐに終了する	EXTRAPIFY_API_BASE_URL が有効な絶対 URL であることを確認してください
ツール呼び出しで 401 または 403 が返される	extrapify.com/dashboard で API キーを確認してください
クライアントがツールを検出できない	stdio 経由で mcp/server.mjs を指定して node を起動していることを確認してください
リクエストがタイムアウトする	お使いのマシンから Extrapify API に接続できることを確認してください
JavaScript を多用するページでコンテンツが空になる	Extrapify が Browserless によるフォールバックを自動的に処理します。対応は不要です

---

リポジトリの構成

mcp/
  server.mjs               ← MCP stdio server entrypoint
  tool-registry.mjs        ← tool definitions
  extrapify-client.mjs     ← minimal Extrapify API client
  tools/
    extract-structured-data.mjs
  configs/
    claude-desktop.local.example.json
    claude-desktop.production.example.json
docs/
  mcp-install-examples.md
  schema-templates.md
  demo-workflows.md
  mcp-marketplace-copy.md

---

リンク

• API と料金：extrapify.com
• ドキュメント：extrapify.com/docs
• ダッシュボード：extrapify.com/dashboard