# OAuth対応のWebスクレイピングMCPサーバー | QuantumProxies.io

Claude、Cursor など任意の MCP クライアントで使える Webスクレイピング MCP サーバー。OAuth 2.1 でサインインすれば API キーは不要。scrape・search など 29 ツールを提供。

## Webスクレイピングと AI エージェントのための MCP サーバー

QuantumProxies.io の MCP サーバーは、Claude、Cursor など任意の MCP クライアントに、レジデンシャルプロキシ経由でライブな Web を scrape・search・map・crawl する 29 のツールを提供します。OAuth サインインに対応したクライアントに https://api.quantumproxies.io/mcp を追加し、アカウントにサインインして「Allow access」をクリックするだけ。API キーをコピーする必要はありません。

- OAuth 2.1 サインイン
- 無料、支払いは API 利用分のみ
- 29 ツール
- 任意の MCP クライアント

## 4 ステップで OAuth 接続

MCP 仕様で定義された認可フロー、OAuth サインインに対応した MCP クライアント向けです。

1. **サーバー URL を追加**: https://api.quantumproxies.io/mcp をクライアントに貼り付けます。Claude ならカスタムコネクタとして追加します。
2. **サインイン**: クライアントが QuantumProxies.io のサインインページを開きます。ログインするか、無料アカウントを作成してください。
3. **アクセスを許可**: 同意画面で確認を求められます。「Allow access」をクリックすれば接続完了です。
4. **エージェントに依頼**: 29 のツールがすぐに使えます。利用料は通常の API キーと同じくアカウント残高から差し引かれます。

接続ごとに専用の API キーが発行され、ダッシュボードの API キーページに MCP · \<client name> という名前で表示されます。そのキーを削除すると、クライアントの接続は解除されます。

## OAuth と API キー、どちらを使うか

どちらも同じエンドポイント、同じ 29 ツールにアクセスします。

### OAuth サインイン

チャットアプリやデスクトップクライアント向け。コピーや保管は不要です。クライアントは有効期間の短いトークンを保持し、接続ごとに削除可能な個別のキーとして表示されます。

### API キー

スクリプト、CI、ヘッドレスエージェント、ローカルの npx パッケージ向け。ホスト型エンドポイントには qp_live_ キーを Authorization: Bearer または X-Api-Key で送信し、ローカルサーバーでは QUANTUMPROXIES_API_KEY を設定します。

## AIエージェント向けスキル

5つのSKILL.mdファイルが、Claude Code、Claude.ai、Codex、Cursor、Gemini CLI、そしてオープンなAgent Skills形式を読める任意のエージェントに、QuantumProxies.ioの正しい使い方を教えます。一度インストールすれば、タスクに応じてエージェントが必要なスキルを読み込みます。

コマンド1つでインストール: `npx skills add https://quantumproxies.io`. 70以上のエージェントでskills CLIから利用できます。Claude Codeは~/.claude/skillsにコピーしたスキルフォルダも読み込み、Codex、Cursor、Gemini CLIは~/.agents/skillsを読みます。

- [`use-data-api`](https://quantumproxies.io/.well-known/agent-skills/use-data-api/SKILL.md): REST Data APIの呼び出し：認証、レスポンスのエンベロープ、非同期ジョブ、リファレンス
- [`use-mcp-server`](https://quantumproxies.io/.well-known/agent-skills/use-mcp-server/SKILL.md): 任意のMCPクライアントの接続：ホスト型OAuthエンドポイントまたはローカルnpmパッケージ、ツールプリセット
- [`scrape-to-markdown`](https://quantumproxies.io/.well-known/agent-skills/scrape-to-markdown/SKILL.md): 1つのURLからクリーンなMarkdownや構造化フィールドへ。多数のページにはbatch、map、crawl
- [`generate-proxies`](https://quantumproxies.io/.well-known/agent-skills/generate-proxies/SKILL.md): 契約プランからのプロキシ文字列：地域ターゲティング、スティッキーセッション、IPホワイトリスト
- [`find-business-leads`](https://quantumproxies.io/.well-known/agent-skills/find-business-leads/SKILL.md): 企業リストとデータセット：Collectors、AI Places Finder、データセットビルダー

[ディスカバリーインデックス（/.well-known/agent-skills/）](https://quantumproxies.io/.well-known/agent-skills/index.json) · [GitHubのソースとClaude Codeプラグイン](https://github.com/quantumproxies/quantumproxies-skills)

ホスト型エンドポイントは MCP 仕様の認可に関する規定に準拠しています。OAuth 2.1 の保護リソースであり、認証情報のないリクエストには、クライアントにサインイン先を伝える 401 レスポンスを返します。同じ URL でキーも引き続き使えるため、既存の設定が壊れることはありません。

## リモート MCP サーバーの URL とディスカバリー

ホスト型サーバーは https://api.quantumproxies.io/mcp で稼働し、Streamable HTTP で通信します。OAuth 保護リソースメタデータ（RFC 9728）を https://api.quantumproxies.io/.well-known/oauth-protected-resource/mcp で公開しており、認可サーバーとして https://app.quantumproxies.io を指定しています。認可サーバーは自身のメタデータ（RFC 8414）を /.well-known/oauth-authorization-server で公開しています。MCP の認可を実装したクライアントは、401 レスポンスを起点にこれらをすべて自動で見つけます。

## OAuth 2.1 サインインのセキュリティ

すべての認可で S256 方式の PKCE が必須です。クライアントは Dynamic Client Registration（RFC 7591）で登録するか、Client ID Metadata Document で自身を識別できます。アクセストークンの有効期間は 1 時間、リフレッシュトークンは 30 日間で、使用のたびにローテーションされます。トークンはリソースインジケーター（RFC 8707）で MCP エンドポイントに紐付けられ、他のサービスに転送されることはありません。

## クライアントの管理と接続解除

許可したクライアントごとに専用の API キーが発行され、ダッシュボードの API キーページに MCP · \<client name> という名前で表示されます。利用料は他の API キーと同じくアカウント残高から差し引かれます。キーを削除するとそのクライアントの接続は解除され、他のクライアントやキーはそのまま動作します。

## API キーで接続する場合

API キーは同じエンドポイントで引き続き使えます。qp_live_ キーを Authorization: Bearer または X-Api-Key ヘッダーで送信してください。ローカルパッケージ npx -y quantumproxies-mcp はお使いのマシン上で stdio で動作し、キーを環境変数 QUANTUMPROXIES_API_KEY から読み込みます。スクリプト、CI、ヘッドレスエージェントなど、サインインに使うブラウザがない環境ではキーを使ってください。

## エージェントが使える 29 のツール

ライブな Web を検索・読み取り・crawl し、出典付きのコンテキストや検証済みの行データに変換します。長時間の処理には status 呼び出しがあり、同じデータを二度ダウンロードせずにポーリングできます。

- `scrape`: 実在ブラウザの TLS フィンガープリントを持つレジデンシャルプロキシ経由で、1 つの URL をクリーンな Markdown、HTML、テキストに変換。CSS セレクタまたは AI 抽出による構造化 JSON にも対応します。
- `search`: Google、Bing、DuckDuckGo の構造化された検索結果。エンジン固有のバーティカル、リッチブロック、ページネーションのメタデータを含みます。
- `search_and_read`: ライブな Web を検索して上位の情報源を取得し、エージェントのトークン予算に収まる引用可能なコンテキストを返します。
- `read_video`: YouTube 動画を 1 本のタイムラインとして読み取ります。メタデータ、チャプター、実際に話されている言語の文字起こし、そして話者が画面を指す場面、価格を口にした場面、チャプターの始まりに置かれた小さなフレームを返します。
- `map`: サイトマップとトップページのリンクからサイトの URL を数秒で洗い出します。フル crawl をせずに、scrape すべきページを特定できます。
- `crawl` + `crawl_status`: シード URL からの非同期 crawl。全ページを Markdown に変換します。対象・除外フィルタ、深さの制御、crawl_status による進捗確認に対応。
- `batch` + `batch_status`: 最大 1,000 件の URL を共通オプションで非同期に scrape し、URL ごとの結果を順次ポーリングできます。
- `search_bulk` + `search_bulk_status`: 複数の SERP ページを非同期で収集。1 ページ目の付加情報を保持し、重複するオーガニック結果を統合します。
- `unlock`: ツールとしての Web Unlocker：任意の HTTP リクエスト（メソッド、ヘッダー、ボディ）をレジデンシャル出口経由で再送し、新しい IP で再試行、ブロックされた GET は実ブラウザへ引き上げます。なおブロックされたページはフラグ付きで返り、黙って 200 を返すことはありません。
- `create_dataset` + `dataset_status`: 自然言語のリクエストを検証済みのデータセットに変換。行は順次追加され、署名付きの CSV/JSON ダウンロードを提供します。
- `seo_audit`: ページの JS なし表示とレンダリング後の SEO を比較。メタデータ、canonical、見出し、コンテンツ、構造化データの差分を確認できます。
- `ai_visibility`: ChatGPT、Claude、Perplexity、Google AI Overview、Bing Copilot はそのページを読んで引用できるか？ 柱ごとにスコア化したオンページ監査（ブロッカーと修正案つき）に、各エンジンへ実際に問い合わせる引用パネルをオプションで追加できます。
- `generate_parser` + `save_parser_preset` + `list_parser_presets` + `parser_preset_stats` + `heal_parser_preset`: LLM でページレイアウトの CSS セレクタを一度だけ学習し、以降は無料の決定的な抽出として再利用。5 つのツールでパーサーの生成・保存・一覧・評価を行い、サイト変更時には自己修復します。
- `list_collectors` + `run_collector` + `collector_run_status`: list_collectors、run_collector、collector_run_status：URL ではなくキーワードや地域といった意味的な入力で動作します。Amazon、Google Maps、LinkedIn の求人、アプリストアのほか、さらに 70 種類に対応し、納品された行数で課金されます。
- `list_proxies` + `generate_proxies` + `proxy_locations` + `whitelist_ip`: list_proxies、generate_proxies、proxy_locations、whitelist_ip により、エージェントはあらゆる種類のプロキシエンドポイントをすぐに利用でき、都市、ISP、ASN 単位までのジオターゲティングが可能です。
- `report`: エージェント内からチームへフィードバックを送信：バグ、足りない機能やコレクター、質問。API キーなしで動作します。

## よくある質問

### QuantumProxies.io の MCP サーバーとは？

QuantumProxies.io の Scraper API を Claude、Cursor など任意の MCP クライアントに接続する、無料の Model Context Protocol サーバーです。エージェントは実在ブラウザの TLS フィンガープリントを持つレジデンシャルプロキシ経由で、Web を scrape・search・map・crawl する 29 のツールを使えます。OAuth サインインでホスト型エンドポイントを使うことも、npx パッケージをローカルで実行することもできます。

### MCP サーバーは OAuth に対応していますか？

はい。ホスト型エンドポイント https://api.quantumproxies.io/mcp は、MCP 認可仕様で定義された OAuth 2.1 サインインに対応しています。OAuth サインインに対応したクライアントに URL を追加し、QuantumProxies.io にログインして「Allow access」をクリックします。PKCE は必須で、アクセストークンの有効期間は 1 時間、リフレッシュトークンはローテーションされます。

### Claude に MCP サーバーを接続するには？

Claude では https://api.quantumproxies.io/mcp をカスタムコネクタとして追加し、QuantumProxies.io のページが開いたらサインインします。Claude Code では claude mcp add --transport http quantumproxies https://api.quantumproxies.io/mcp を実行し、/mcp でサインインします。Claude Desktop では API キーを使ってローカルの npx パッケージを実行することもできます。

### クライアントの接続を解除するには？

ダッシュボードの API キーページを開きます。OAuth で接続したクライアントにはそれぞれ MCP · \<client name> という名前のキーがあります。そのキーを削除するとクライアントはアクセスできなくなり、他のクライアントや API キーには影響しません。再接続するには、サーバー URL を追加してもう一度サインインします。

### API キーは引き続き使えますか？

はい。qp_live_ キーを Authorization: Bearer または X-Api-Key で https://api.quantumproxies.io/mcp に送信するか、npx -y quantumproxies-mcp と環境変数 QUANTUMPROXIES_API_KEY でローカルパッケージを実行します。サインイン用のブラウザがないスクリプト、CI、ヘッドレスエージェントでは、キーのほうが手軽です。

### 料金はいくらですか？

MCP サーバー自体は無料です。支払いは MCP サーバーが行う API 呼び出しに対する標準の従量課金のみで、Scraper API を直接呼び出す場合と同じ料金です。OAuth とキーのどちらで接続しても、アカウント残高から差し引かれます。新規アカウントにはテスト用の無料クレジットがあり、クレジットカードは不要です。

### リモート MCP サーバーはありますか？ローカルパッケージだけですか？

両方あります。ホスト型エンドポイント https://api.quantumproxies.io/mcp は、URL での接続を好むクライアント向けに Streamable HTTP で通信し、OAuth サインインまたは API キーで同じ 29 のツールを提供します。npx パッケージはお使いのマシン上で stdio で動作し、API キーで認証します。

### どこで動作しますか？データは見られますか？

ローカルパッケージは npx でお使いのマシン上で動作し、ご自身の qp_live_ キーで QuantumProxies.io の公開 API と通信します。パッケージに内部シークレットはなく、余分な中継もありません。ホスト型エンドポイントは、接続に紐付いたキーで同じ API 呼び出しを行います。OAuth トークンが他のサービスに転送されることはありません。

### 対応している MCP クライアントは？

Model Context Protocol に対応したクライアントならすべて使えます。Streamable HTTP でリモートサーバーに接続し OAuth サインインに対応したクライアントはホスト型 URL を使います。Claude Desktop、Claude Code、Cursor、Windsurf、VS Code、Zed などの stdio クライアントは、同じ 5 行の JSON でローカルパッケージを実行できます。

### エージェントが使えるツールは？

29 のツールです。scrape、unlock、seo_audit、ai_visibility、search、search_and_read、read_video、map、ステータスのポーリング付きの crawl と batch、それぞれのステータスツールを伴う search_bulk と create_dataset、自己修復型プリセットの 4 ツールを伴う generate_parser、既製スクレイパーを扱う 3 つの Collector ツール、エンドポイント、ジオターゲティング、IP ホワイトリスト用の 4 つのプロキシツール、そしてチームにフィードバックを送る report です。

### エージェント自身にページを取得させればよいのでは？

エージェントからの素の HTTP 取得は、まさに読む価値のあるページでアンチボットにブロックされます。MCP サーバーはすべてのリクエストを、ブラウザ水準の TLS フィンガープリントを持つレジデンシャル IP 経由で送り、ブロック時の自動リトライとステルスブラウザへのフォールバックを行います。そのためエージェントは CAPTCHA ではなく実際のページを読めます。

## 関連製品

- [Extract API：あらゆるページを Markdown や JSON に](https://quantumproxies.io/ja/extract-api)
- [LLM と RAG のための Web データ](https://quantumproxies.io/ja/web-data-for-llms)
- [Google、Bing、DuckDuckGo 対応の SERP API](https://quantumproxies.io/ja/serp-api)
- [ボット対策のあるサイト向け Web Unlocker](https://quantumproxies.io/ja/web-unlocker)
- [レジデンシャルプロキシ](https://quantumproxies.io/ja/residential-proxies)

## Sources

- [What is the Model Context Protocol (MCP)?](https://modelcontextprotocol.io/docs/2026-07-28/getting-started/intro)
- [Model Context Protocol Specification](https://modelcontextprotocol.io/specification/2025-06-18)
- [Introducing the Model Context Protocol (Anthropic)](https://www.anthropic.com/news/model-context-protocol)
- [modelcontextprotocol/modelcontextprotocol (GitHub)](https://github.com/modelcontextprotocol/modelcontextprotocol)
- [Model Context Protocol (Wikipedia)](https://en.wikipedia.org/wiki/Model_Context_Protocol)
