RoamProxy

RoamProxy MCP サーバー

AI エージェント（Claude、Cursor、VS Code、Windsurf、…）がRoamProxyの住宅用、データセンター用、モバイル用 IP を通じて、190 か国以上からウェブを閲覧できるMCPサーバーです。

エージェントに次のようなことを依頼できます。

• 「ロサンゼルスの米国住宅用 IP からこの商品ページを開き、価格を要約してください。」
• 「『running shoes』について、google.de と google.fr の表示内容を比較してください。」
• 「Playwright 用の固定英国プロキシを用意してください。」
• 「RoamProxy アカウントの残高はいくらですか？」

ツール

ツール	機能
fetch_url	選択した国／州／都市のプロキシ IP を通じて URL を取得します。ステータスと本文を Markdown、テキスト、または HTML で返します。
get_proxy	任意の地域向けに、ローテーションまたは固定の、すぐに使える http:// または socks5:// プロキシ URL（および Playwright 設定）を作成します。
check_ip	地域／セッションの出口 IP、都市、地域、ISP を表示し、ターゲティングを確認できます。
account_status	ウォレット残高、GB あたりの料金、過去 7 日間の使用状況、レンタル中の固定 IP を表示します。

すべてのツールで利用できる地域オプション：country（us、de、jp…）、state（ca、ny…または米国の州名の正式表記）、city（Los Angeles）、session（同じ ID なら同じ IP。省略するとローテーション）、product（デフォルトは residential。datacenter、mobile も指定可能）。

セットアップ

1. roamproxy.comでアカウントを作成し、メンバーダッシュボードのRotating residentialページにある API セクションからAPI トークンをコピーします。
2. サーバーをクライアントに追加します。Node.js 20 以降が必要です。

Claude Code

claude mcp add roamproxy -e ROAM_API_TOKEN=your_token -- npx -y roamproxy-mcp

Claude Desktop / Cursor / Windsurf（claude_desktop_config.json、~/.cursor/mcp.json、…）

{
  "mcpServers": {
    "roamproxy": {
      "command": "npx",
      "args": ["-y", "roamproxy-mcp"],
      "env": { "ROAM_API_TOKEN": "your_token" }
    }
  }
}

VS Code（.vscode/mcp.json）

{
  "servers": {
    "roamproxy": {
      "command": "npx",
      "args": ["-y", "roamproxy-mcp"],
      "env": { "ROAM_API_TOKEN": "your_token" }
    }
  }
}

料金

通信量はプロキシを直接利用した場合と同じように RoamProxy ウォレットに請求されます。MCP サーバー自体は無料のオープンソースです。住宅用は 1 GB あたり $2（まとめてチャージすると 1 GB あたり $1.20 まで割引）、データセンター用は 1 GB あたり $0.80 で、残高に有効期限はありません。料金をご覧ください。

仕組み

fetch_url はお使いのマシン上で実行されます。リクエストは RoamProxy ゲートウェイ（gw.roamproxy.com:41080）に送られ、指定した場所の住宅用 IP から送信されます。トークンによって利用できるのは、ご自身のプロキシ認証情報とアカウント情報のみです。チャージ、購入、その他の変更はできません。

都市に在庫がない場合、ゲートウェイはエラーにせず、州、次に国へとフォールバックします。実際に接続された場所は check_ip で確認できます。

開発

npm install
npm test                                  # offline unit tests
ROAM_API_TOKEN=... node test/e2e.mjs      # live check, uses a little traffic

関連項目

• proxy-examples — Python、Node、Go、curl のコードサンプル
• roamproxy-python — Python SDK
• proxyprobe — プロキシチェッカー CLI

MIT © Goldkeep Digital LLC