RoamProxy

io.github.roamproxyv0.1.1更新於 Oct 10, 2026

Fetch pages and get proxies via residential, datacenter and mobile IPs in 190+ countries.

已驗證STDIO僅桌面Web Search & ScrapingBrowser Automation

概覽

AI 產生的概覽

讓助理透過 RoamProxy 涵蓋 190 多個國家/地區的住宅、資料中心或行動 IP 抓取網頁並產生代理位址。

功能
提供四個工具：fetch_url 透過指定國家、州或城市的代理 IP 取得網址，回傳狀態碼與內容（markdown、文字或 HTML）；get_proxy 為指定地理位置產生可直接使用的 http 或 socks5 代理位址及 Playwright 設定，支援輪換或黏性工作階段；check_ip 顯示出口 IP、城市、地區與 ISP；account_status 顯示錢包餘額、每 GB 價格、近期用量與已租用的靜態 IP。地理位置選項包括國家、州、城市、工作階段與產品類型。
適用情境
適合需要以特定國家或城市視角檢視網頁、比較不同地區結果，或為 Playwright 等瀏覽器自動化取得代理位址的情境。也可用於查看帳戶剩餘餘額，以及確認地理定位是否真正生效。
執行需求
透過 npm 套件 roamproxy-mcp 以 stdio 方式在本機執行，需要 Node.js 20 或更高版本。需要 RoamProxy 帳戶，並透過環境變數 ROAM_API_TOKEN 提供 API 權杖。抓取時需要連線至 RoamProxy 閘道的網路存取。
安裝前請注意
必須提供 ROAM_API_TOKEN 密鑰，應避免寫入共用設定檔。流量依與直接使用代理相同的費率從 RoamProxy 錢包扣款，抓取會產生實際費用；該權杖本身無法加值或變更帳戶設定。請求經由第三方代理 IP 送出，請勿透過其傳輸敏感資料。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 RoamProxy，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only，透過 STDIO。 STDIO 服務會啟動本機處理程序，因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

RoamProxy MCP Server

[npm] [License: MIT]

An MCP server that lets AI agents (Claude, Cursor, VS Code, Windsurf, …) browse the web through RoamProxy residential, datacenter and mobile IPs in 190+ countries.

Ask your agent things like:

  • "Open this product page from a US residential IP in Los Angeles and summarise the price."
  • "Compare what google.de and google.fr show for 'running shoes'."
  • "Give me a sticky UK proxy for Playwright."
  • "How much balance is left on my RoamProxy account?"

Tools

ToolWhat it does
fetch_urlFetch a URL through a proxy IP in the chosen country / state / city. Returns status + body as markdown, text or HTML.
get_proxyBuild a ready-to-use http:// or socks5:// proxy URL (plus Playwright config) for any geo, rotating or sticky.
check_ipShow the exit IP, city, region and ISP for a geo/session, to verify targeting.
account_statusWallet balance, per-GB prices, last 7 days of usage, rented static IPs.

Geo options on every tool: country (us, de, jp…), state (ca, ny… or full US state names), city (Los Angeles), session (same id = same IP; omit to rotate), product (residential default, datacenter, mobile).

Setup

  1. Create an account at roamproxy.com and copy your API token from the member dashboard (Rotating residential page, API section).
  2. Add the server to your client. Requires Node.js 20+.

Claude Code

bash
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, …)

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

VS Code (.vscode/mcp.json)

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

Pricing

Traffic is billed to your RoamProxy wallet exactly as if you used the proxy directly — the MCP server itself is free and open source. Residential $2/GB (down to $1.20/GB with volume top-ups), datacenter $0.80/GB, balance never expires. See pricing.

How it works

fetch_url runs on your machine: the request goes to the RoamProxy gateway (gw.roamproxy.com:41080) and leaves from a residential IP in the location you asked for. Your token only unlocks your own proxy credentials and account info — it cannot top up, buy or change anything.

If a city has no stock the gateway falls back to the state, then the country, instead of failing; check_ip shows where you actually landed.

Development

bash
npm installnpm test                                  # offline unit testsROAM_API_TOKEN=... node test/e2e.mjs      # live check, uses a little traffic

Related

MIT © Goldkeep Digital LLC

來源：README.md，提交 43d38b3

工具

0
工具後設資料尚未被收錄。

版本歷史

1
  1. v0.1.1最新Oct 10, 2026