Scrapeer

Scrapeer MCP サーバー

Claude Code、Codex、Cursor、VS Code Copilot から Scrapeer のビジュアルなウェブスクレイピングフローを実行できます。

Scrapeer は、スクレイパーを一から書きたくない人向けの、ビジュアルなブラウザー自動化およびウェブスクレイピングプラットフォームです。ドラッグ＆ドロップエディターで決定論的なスクレイピングワークフローを構築し、ブラウザーがステップごとに実行する様子を確認してから、同じフローをローカルまたは Scrapeer のクラウドで実行できます。

この MCP サーバーは AI エージェントを Scrapeer に接続し、次のことを可能にします。

• 保存済みのスクレイピングフローを実行し、構造化された結果を取得する
• フロー定義、ブロック設定、実行ステップ、実行履歴を調べる
• Scrapeer のブロックカタログと検証 API を使ってフローを作成または修正する
• アカウントのクレジットを確認し、実行中のクラウド実行をキャンセルする

これにより、役割を効果的に分担できます。人間は Scrapeer で信頼性の高いブラウザーワークフローを設計し、エージェントは MCP を通じてそれらのワークフローを実行、監視、デバッグ、拡張できます。

Scrapeer を選ぶ理由

Scrapeer は、スクレイピングの処理をすべて可視化することを目指して設計されています。スクレイパーの動作を正確に確認し、各ブロックの出力を調べ、サイトが変更されたときにワークフローを修正できます。毎回エージェントにブラウザー操作を即興で行わせるのではなく、Scrapeer なら、保存済みで検証済みの信頼できるワークフローを用意し、必要に応じてエージェントが実行できます。

クイックスタート

https://app.scrapeer.com/settings#security で Scrapeer API キーを作成し、MCP クライアントにサーバーを追加します。以下の例では npx を使うため、パッケージをグローバルにインストールする必要はありません。

Claude Code（.mcp.json）

プロジェクト単位の Claude Code 設定にするには、プロジェクトのルートに .mcp.json を作成します。

{
  "mcpServers": {
    "scrapeer": {
      "command": "npx",
      "args": ["-y", "@scrapeer/mcp-server"],
      "env": { "SCRAPEER_API_KEY": "sk_..." }
    }
  }
}

個人用のプライベート設定にするには、claude mcp add --scope user --env SCRAPEER_API_KEY=sk_... scrapeer -- npx -y @scrapeer/mcp-server を実行します。これにより、Claude が使用しているマシンに適した ~/.claude.json のエントリを書き込みます。

Codex CLI および IDE 拡張機能（~/.codex/config.toml）

[mcp_servers.scrapeer]
command = "npx"
args = ["-y", "@scrapeer/mcp-server"]

[mcp_servers.scrapeer.env]
SCRAPEER_API_KEY = "sk_..."

Cursor（~/.cursor/mcp.json または .cursor/mcp.json）

{
  "mcpServers": {
    "scrapeer": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@scrapeer/mcp-server"],
      "env": { "SCRAPEER_API_KEY": "sk_..." }
    }
  }
}

VS Code Copilot（.vscode/mcp.json）

{
  "servers": {
    "scrapeer": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@scrapeer/mcp-server"],
      "env": { "SCRAPEER_API_KEY": "sk_..." }
    }
  }
}

利用可能なツール

読み取り

ツール	説明
scrapeer_list_flows	保存済みのスクレイピングフローを一覧表示します
scrapeer_get_flow	特定のフローの詳細を取得します
scrapeer_get_block_catalog	フローで使用できるブロックの種類と、各ブロックのカスタムフィールドスキーマを一覧表示します。作成、更新、パッチ適用の前に必ず呼び出してください。種類や設定キーを推測すると、検証に失敗します
scrapeer_validate_flow	フロー JSON を保存せずにドライラン検証します
scrapeer_get_account	アカウント情報：クレジット残高、サブスクリプションプラン、クラウド実行の利用可否

実行

ツール	説明
scrapeer_run_flow	クラウド実行を開始し、実行 ID をすぐに返します
scrapeer_run_flow_and_wait	フローを実行し、結果が用意されるまでポーリングします（推奨）
scrapeer_get_run_status	実行中または完了した実行のステータスを確認します
scrapeer_get_run_results	完了した実行から構造化された出力データを取得します
scrapeer_get_run_steps	ブロックごとの実行内容を取得します（失敗のデバッグに便利です）
scrapeer_list_runs	ステータスまたはフローによる任意のフィルタリングを指定して、実行履歴を一覧表示します
scrapeer_cancel_run	実行中のクラウド実行をキャンセルします

変更

ツール	説明
scrapeer_create_flow	指定したタイトルで新しい（空の）フローを作成します
scrapeer_update_flow	フローの定義全体を置き換えます（フロー全体の上書き）。段階的な編集には scrapeer_patch_flow を推奨します
scrapeer_patch_flow	詳細なパッチ操作を適用します：add_block、update_block_custom、remove_block、add_edge、remove_edge

フローの構築：推奨される手順

変更ツールは楽観的同時実行制御を適用します。保存のたびに、呼び出し元が最後に読み取ったバージョンスタンプが送信され、ゲートウェイは古い書き込みを 409 で拒否します。そのため、エディター上の人間による編集と MCP 経由の LLM による編集が、互いの変更を気づかないまま上書きすることはありません。MCP サーバーは同一セッション内の呼び出し間でこのバージョンスタンプを自動的に追跡するため、LLM が手動で管理する必要はありません。

一般的な手順：

新規作成：

scrapeer_get_block_catalog       -> learn valid block types
scrapeer_create_flow             -> returns flow_id (event_id cached)
scrapeer_patch_flow flow_id [...] -> add_block ops; cache -> baseProjectEventID

既存のフローを変更：

scrapeer_get_block_catalog       -> learn valid block types
scrapeer_get_flow flow_id        -> caches the current event_id
scrapeer_validate_flow {...}     -> optional dry-run before commit
scrapeer_patch_flow flow_id [...] -> uses cached event_id automatically

409 が発生すると、キャッシュされた event_id は自動的に無効化されます。scrapeer_get_flow を再度呼び出してから、変更を再試行してください。

設定

変数	必須	デフォルト	説明
SCRAPEER_API_KEY	はい	-	app.scrapeer.com/settings で取得する API キー

開発

pnpm install
pnpm test
pnpm run build

テストでは msw を使って Scrapeer API をモックします。実際の認証情報は必要ありません。