QuantumProxies — Residential, Mobile & Datacenter Proxy MCP Server

QuantumProxies MCP Server

QuantumProxies を Claude、Cursor、その他のあらゆる MCP クライアントに接続します。住宅用プロキシを経由し、実際のブラウザーの TLS フィンガープリントを使って、AI エージェントにライブの Web アクセスを提供します。スクレイピング、検索、マッピング、クロールができるため、通常のボットをブロックするページも問題なく取得できます。また、有効なプランに含まれるあらゆる種類（住宅用、モバイル、データセンター、ISP、IPv6）の生のプロキシエンドポイントをエージェントに渡せるので、任意の HTTP クライアントですぐに利用できます。

独自の qp_live_ キーを使って QuantumProxies Scraper API の公開版を呼び出すため、内部シークレットは不要で、ローカルで実行できます。

ツール

ツール	機能
scrape	1 つの URL をスクレイピングし、Markdown／HTML／テキストに変換します。PDF／Office 文書にも対応しています。複数形式での出力、絶対リンクの収集、JSON-LD メタデータ、CSS による構造化抽出、AI プロンプト／JSON スキーマによる抽出、mode: summary に対応しています。
unlock	Web Unlocker：あらゆる HTTP リクエスト（メソッド、ヘッダー、本文）を、実際のブラウザーの TLS フィンガープリントを使って住宅用出口経由で再送します。新しい IP で再試行し、ブロックされた GET リクエストは実際のブラウザーにエスカレーションします。生のレスポンス（ステータス、ヘッダー、本文）を返します。ページが引き続きブロックされている場合は、その旨を示すフラグ（blocked、blockClass、vendor）が付き、何も示さずに 200 を返すことはありません。インタラクティブ CAPTCHA は解決しません（blockClass: "captcha"）。
seo_audit	URL を JavaScript なしのボットとして取得し、さらに完全にレンダリングして、両方の SEO 表示と差分（JavaScript のみのコンテンツ、変更されたタイトル／説明、canonical の欠落）、およびボット向けメタデータ（robots、OG、JSON-LD）を返します。
ai_visibility	ChatGPT、Claude、Perplexity、Google AI Overview、Bing Copilot はページを読み取り、引用できるでしょうか？ ページ内を監査します（robots.txt 内の 24 種類の AI クローラー、Content-Signal、GPTBot としての取得、noindex／nosnippet／noai、JavaScript なしのテキスト、JSON-LD エンティティ、回答形式のコピー、経過期間を含む日付、著者、出典）。各評価軸を、ブロッカー、根拠、修正方法とともに採点します。さらに、オプションの引用パネルでは各エンジンに問い合わせ、引用／言及／順位、シェア・オブ・ボイス、そしてあなたが不在の質問でどのサイトが勝っているかを報告します。
search	構造化された Google／Bing／DuckDuckGo の検索結果を返します。render: true を設定すると、Google AI Overview、PAA、Knowledge Graph など、JavaScript による拡張情報も取得できます。
search_and_read	SERP → 上位ページを取得 → 番号付きの引用用ソースと、AI プロンプトですぐに使えるトークン数制限付きのコンテキスト文字列を返します。
search_bulk / search_bulk_status	オーガニック検索結果を統合し、1 ページ目の AI／ゼロクリック拡張情報も含めて、複数ページを非同期でページネーションします。
map	URL をすばやく検出します（サイトマップ＋ホームページのリンク）。サイト全体をクロールしません。デフォルトではコンパクトに表示され、最大 limit 件（100 件）の URL に加えて、サイト全体の total とセクションごとの summary を返します。パスのツリーを表示するには group_by: path を指定します。
crawl / crawl_status	BFS 方式でサイトを非同期クロールし、ページごとに Markdown を返します。進行状況を確認できます。
batch / batch_status	複数の URL を非同期でスクレイピングします。メタデータのみの項目には mode: summary を指定します。since カーソルを使って差分をポーリングできます。ページのコンテンツを取得するには include_content を指定します。
create_dataset / dataset_status	プロンプトで指定した構造化データセットを、予算と行数の上限を設定して収集します。
list_collectors / run_collector / collector_run_status	すぐに使える Collector：URL ではなく、セマンティックな入力（キーワード＋場所、場所 ID、商品 ID、ドメインなど）を使って、バージョン管理されたスクレイパーを実行します。Google Maps の場所、場所のレビュー、Google Jobs／News／Shopping、商品オファー、ホテル、地域の見込み顧客、サイトの連絡先、企業プロフィールに対応しています。料金は配信された行数に応じて発生します。非同期実行は run_id でポーリングでき、行データは CSV としてエクスポートできます。
list_proxies	あらゆる種類のプロキシサービス（Residential Basic／Premium／Private、Mobile、Mobile V2、Datacenter、ISP、IPv6）を一覧表示します。残りの帯域幅、有効期限、生成に使用した orderId も確認できます。
generate_proxies	有効なプランからすぐに使えるプロキシ文字列（認証情報を含む）を生成します。地域ターゲティング（国／州／市／ISP／ASN）、ローテーションまたは固定セッション、HTTP または SOCKS5、複数の出力形式に対応しています。
proxy_locations	プランの種類ごとに有効な地域ターゲティング値（国、州、市、ASN、ISP コードを含む完全なロケーションツリー）を返します。
whitelist_ip	IP 認証のホワイトリスト（追加／一覧表示／削除）を管理します。対応するプランと Mobile V2 の IP 認証プロキシリストが対象です。
report	エージェント内からチームにフィードバックを送信します。不具合（誤った結果／空の結果、エラー、ブロックされたページ）、不足している機能や Collector、質問を報告できます。API キーなしで利用できます。

クイックスタート

インストールは不要です。npx が必要に応じて quantumproxies-mcp を取得します（Node.js 18 以上）。

Claude Code（コマンド 1 つ）：

claude mcp add quantumproxies \
  -e QUANTUMPROXIES_API_KEY=qp_live_your_key_here \
  -- npx -y quantumproxies-mcp

Claude Desktop / Cursor / 任意の MCP クライアント（claude_desktop_config.json、.cursor/mcp.json、または .mcp.json）：

{
  "mcpServers": {
    "quantumproxies": {
      "command": "npx",
      "args": ["-y", "quantumproxies-mcp"],
      "env": { "QUANTUMPROXIES_API_KEY": "qp_live_your_key_here" }
    }
  }
}

ホステッドエンドポイント（リモート MCP）

同じサーバーは、ローカルパッケージではなく URL を使いたいクライアント向けに、ホステッド Streamable HTTP エンドポイントとしても動作します。

https://api.quantumproxies.io/mcp

OAuth で接続する（キーのコピー不要）

このエンドポイントは MCP 認可仕様（OAuth 2.1）に対応しています。対応クライアントで、上記の URL をリモートサーバーとして追加するだけです。

1. クライアントが QuantumProxies.io のサインインページを開きます。
2. サインイン（または無料アカウントを作成）して、アクセスを許可をクリックします。
3. クライアントが接続されます。ダッシュボードの API キーページに MCP · <client> という名前のキーが表示されます。クライアントの接続を解除するには、そのキーを削除します。

内部では、認可サーバーメタデータは https://app.quantumproxies.io/.well-known/oauth-authorization-server、 保護対象リソースのメタデータは https://api.quantumproxies.io/.well-known/oauth-protected-resource/mcp にあります。動的クライアント登録（RFC 7591）と Client ID Metadata Documents に対応し、PKCE（S256）が必須です。アクセストークンの有効期間は 1 時間で、リフレッシュトークンはローテーションされます。トークンはこのエンドポイントにバインドされます（RFC 8707）。使用量は他のキーと同様に残高から課金されます。

または API キーを送信する

ベアラートークンに対応したクライアントは、OAuth を省略できます。キーは各リクエストの Authorization ヘッダー（または X-Api-Key）で送信され、サーバー側には保存されません。

curl -X POST https://api.quantumproxies.io/mcp \
  -H "Authorization: Bearer qp_live_your_key_here" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

トークンもキーも指定せずにリクエストすると、上記のメタデータを参照する WWW-Authenticate ヘッダーとともに 401 が返されます。これにより、OAuth 対応クライアントでサインインが開始されます。

エンドポイントをセルフホストするには、この同じパッケージに含まれる 2 つ目のバイナリを使います。QUANTUMPROXIES_API_KEY を設定すると、認証情報を送らない呼び出し元に対し、そのアカウントを使ってサービスを提供します。

QUANTUMPROXIES_API_KEY=qp_live_… PORT=9310 npx -y quantumproxies-mcp-remote

ソースから実行する（開発）

npm install
npm run build

次に、npx の代わりにローカルビルドを使うようクライアントを設定します。

{
  "mcpServers": {
    "quantumproxies": {
      "command": "node",
      "args": ["/absolute/path/to/scraper-mcp/dist/index.js"],
      "env": {
        "QUANTUMPROXIES_API_KEY": "qp_live_your_key_here"
      }
    }
  }
}

環境変数

変数	デフォルト	備考
QUANTUMPROXIES_API_KEY	—	必須。 お使いの qp_live_ キーです。
QUANTUMPROXIES_API_BASE	https://app.quantumproxies.io/api/v1	ステージング／セルフホスト用の上書き設定です。
QUANTUMPROXIES_TOOLS	すべての 28 個	一部のツールのみを読み込みます。名前（search,scrape）またはプリセット（lite、web、research、collectors、proxies）を指定します。下記を参照してください。

セルフホスト型リモートエンドポイントのみ（quantumproxies-mcp-remote）、任意：

変数	デフォルト	備考
MCP_OAUTH_RESOURCE	https://api.quantumproxies.io/mcp	OAuth リソースとしてのこのエンドポイントです。
MCP_OAUTH_ISSUER	https://app.quantumproxies.io	リソースメタデータで公開される認可サーバーです。
MCP_OAUTH_INTROSPECT_URL	http://127.0.0.1:3090/api/v1/internal/oauth/introspect	OAuth アクセストークンの確認先です。
MCP_INTERNAL_TOKEN	—	トークンイントロスペクション呼び出し用のシークレットです。未設定の場合、API キーのみが受け付けられます。

ローカルモデル（Ollama、LM Studio、Qwen、Open WebUI）

28 個のツール定義は約 14,000 トークンです。Ollama のデフォルトである 4K コンテキストでは収まりません。また、32K コンテキストでも最初のページを表示する前に容量のほぼ半分を消費します。読み込むツールを減らしてください。

プリセット	ツール	定義トークン数
lite	search_and_read	約 360
web	search, search_and_read, scrape	約 4,200
research	web + map, batch, batch_status	約 5,100
collectors	list_collectors, run_collector, collector_run_status	約 830
proxies	list_proxies, generate_proxies, proxy_locations, whitelist_ip	約 1,800

stdio では QUANTUMPROXIES_TOOLS=web を設定します。ホステッドエンドポイントでは URL に ?tools=web を追加し、API キーを Bearer ヘッダーで送信します。 https://api.quantumproxies.io/mcp?tools=web。名前は組み合わせて指定できます：?tools=lite,collectors。

プロンプトの例

• 「example.com の料金ページをスクレイピングして、プランと価格を教えてください。」
• 「米国の Google ショッピングで「nintendo switch oled」を検索し、最も安いものを5つ挙げてください。」
• 「docs.example.com のマップを作成し、/guides/ ページだけをクロールして要約してください。」
• 「プロキシプランを一覧表示し、米国のスティッキーなレジデンシャルプロキシを socks5 URL として5つ生成してください。」
• 「ドイツのローテーション式モバイルプロキシを取得し、サーバーの IP 203.0.113.7 をホワイトリストに登録してください。」

プライバシーポリシー

ポリシー全文：https://quantumproxies.io/privacy

このサーバーが送信する情報。 サーバーはお使いのマシン上で実行され、ユーザー自身の qp_live_ キーで認証して、公開されている QuantumProxies API（https://app.quantumproxies.io/api/v1）とのみ通信します。各呼び出しには、ユーザー（またはエージェント）が渡した引数（対象 URL または検索クエリ、および抽出プロンプト）が含まれます。お使いのマシン上のその他の情報が読み取られたり送信されたりすることはありません。このサーバーには、ファイルシステム、シェル、クリップボードへのアクセス権はありません。

収集する情報。 ユーザーから提供されるアカウントデータ（氏名、メールアドレス、請求情報）と、請求、不正利用防止、サポートのために保存するリクエストログ（対象 URL または検索クエリ、タイムスタンプ、レスポンスステータス、転送バイト数、使用した API キー）です。スクレイピングしたページのコンテンツは、結果を返すために必要な範囲を超えて保持しません。

サービスを通じて収集するデータ。 収集する公開ウェブデータはユーザーが決定し、そのデータの管理者はユーザーです。当社は、ユーザーに代わってリクエストを履行するためにのみデータを処理します。サービスを合法的に利用すること、アクセスするサイトの利用規約を遵守すること、そしてサービスを通じて収集する個人データについては、ユーザーが責任を負います。

共有。 個人データを販売することはありません。サービスを運営する処理業者（決済プロバイダー、メール配信、ホスティング、CDN、分析）とのみ共有します。これらの処理業者とは、データの保護を義務付ける契約を締結しています。また、ユーザーのトラフィックを経由させる上流のプロキシネットワークとも共有します（接続メタデータのみで、アカウント情報は共有しません）。法律で義務付けられる場合、データを開示することがあります。

保持期間。 アカウントデータはアカウントが存在する限り保持します。リクエストログは、請求および不正利用の調査のため、一定期間に限って保持します。いつでも削除を請求できます。

ユーザーのキー。 Claude Desktop は OS のキーチェーンにキーを保存し、環境変数としてこのサーバーに渡します。キーがバンドルに書き込まれることはなく、QuantumProxies API 以外に送信されることもありません。キーの取り消しまたはローテーションは、https://app.quantumproxies.io/api-keys で行ってください。

お問い合わせ。 [email protected]