mcpField
R
RoamProxy

RoamProxy

本地服务
roamproxy.com浏览器自动化03 周前更新
代码仓库访问官网

关于 RoamProxy

RoamProxy 是供 AI Agent 使用的 MCP 服务，可通过 RoamProxy IP 抓取网页并提供代理信息。请求可指定国家、州或城市，并选择住宅、数据中心或移动代理。

主要功能

  1. 01通过指定地区的代理抓取 URL
  2. 02生成轮换或粘性代理 URL
  3. 03查看代理出口 IP 和位置
  4. 04查看账户余额、价格和用量

适用场景

  1. 01查看本地化商品页面和价格
  2. 02比较不同国家的搜索结果
  3. 03为 Playwright 创建地理定位代理
  4. 04检查代理账户用量和余额

MCP 相关

该 MCP 服务提供抓取 URL、生成代理、检查出口 IP 和查看账户信息的工具。MCP 客户端通过 RoamProxy API token 配置连接。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
  "mcpServers": {
    "roamproxy-roamproxy": {
      "command": "npx",
      "args": [
        "-y",
        "roamproxy-mcp"
      ],
      "env": {
        "ROAM_API_TOKEN": "<ROAM_API_TOKEN>"
      }
    }
  }
}
启动命令npx -y roamproxy-mcp
需要配置的环境变量
ROAM_API_TOKEN密钥Your RoamProxy API token (member dashboard > Rotating residential > API)

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包
npmroamproxy-mcp0.1.1

工具

4

收录的工具列表 · 更新于 2 周前

参数类型必填说明
urlstring是要获取的 http(s) URL
bodystring否POST 请求正文
citystring否城市名称，例如 'Los Angeles'。需要提供 country 和 state。如果该城市无可用库存，网关会回退到州/地区，再回退到国家/地区；check_ip 会显示实际使用的位置。
statestring否州/地区代码，例如 'ca'、'ny'、'tx'（也接受美国州名全称，如 'California'）。需要提供 country。
formatenum否HTML 页面的返回格式。默认值为 markdown。markdown | text | html
methodenum否默认值为 GETGET | POST | HEAD
countrystring否ISO 3166-1 alpha-2 国家/地区代码，例如 'us'、'de'、'jp'。省略则不限国家/地区。
headersobject否额外请求头
productenum否代理 IP 池。默认值为 residential。residential | datacenter | mobile
sessionstring否粘性会话 ID（字母/数字）。相同 ID = 一段时间内使用相同出口 IP。省略则每次请求轮换 IP。
max_charsinteger否将正文截断为此字符数。默认值为 20000。

详细介绍

RoamProxy MCP 服务

npm License: MIT

一个 MCP 服务，让 AI Agent（Claude、Cursor、VS Code、Windsurf，等等）可以通过 RoamProxy 的住宅、数据中心和移动 IP，在 190 多个国家/地区浏览网页。

可以向你的 Agent 提出以下请求：

  • “通过洛杉矶的美国住宅 IP 打开这个商品页面，并总结价格。”
  • “比较 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 token。
  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 服务本身免费且开源。住宅代理每 GB $2（充值量大时可低至每 GB $1.20），数据中心代理每 GB $0.80，余额永不过期。请参阅定价。

工作原理

fetch_url 在你的计算机上运行：请求会发送到 RoamProxy 网关（gw.roamproxy.com:41080），再通过你指定位置的住宅 IP 发出。你的 token 只能解锁你自己的代理凭据和账户信息，无法用于充值、购买或更改任何内容。

如果某个城市没有可用库存，网关会依次回退到该州和该国家/地区，而不会直接失败；check_ip 会显示请求实际从哪里发出。

开发

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

相关项目

MIT © Goldkeep Digital LLC

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。