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