Proxy Veil

Proxy4Agent

**面向 AI Agent 的住宅代理 MCP 服务。**通过 200 多万个真实家庭设备——Android 手机、Windows 电脑和 Mac——转发任意 HTTP 请求，绕过反机器人系统，按国家或城市定位，并在多步工作流中保持粘性会话。

兼容 Claude Code、Cursor、Windsurf、Cline、Continue 以及任何兼容 MCP 的 AI Agent。由 Novada 提供支持。

---

为什么选择 Proxy4Agent

AI Agent 在 60–70% 的商业网站上会遭到拦截。Cloudflare、Akamai、DataDome、PerimeterX 等系统会检测并拒绝标准 HTTP 请求。Proxy4Agent 通过真实住宅 IP 转发 Agent 的请求，让其看起来与真人浏览器毫无区别。

问题	Proxy4Agent
Amazon、LinkedIn 拦截 Agent	使用真实家庭设备的住宅 IP
Cloudflare / Akamai 机器人验证	借助真实设备指纹绕过验证
JS 渲染的页面返回空白	浏览器 API 运行真实 Chromium
地理限制或本地化内容	覆盖 195+ 个国家/地区，支持城市级定位
多步工作流中会话丢失	粘性会话——多次调用使用同一 IP
需要结构化搜索结果	内置 Google 搜索，输出整洁的 JSON

---

提供商

Proxy4Agent 适用于任何 HTTP 代理。Novada 是内置默认选项，集成最深入。BrightData、Smartproxy 和 Oxylabs 提供专用适配器，支持完整的自动定位。其他任何提供商都可通过通用适配器使用。

**优先级：**Novada → BrightData → Smartproxy → Oxylabs → Generic。优先使用第一个已配置的提供商。

Novada（默认 — 推荐）

完整集成：自动地理定位、城市级定位、粘性会话，覆盖 195+ 个国家/地区。

claude mcp add bestproxy4agents \
  -e NOVADA_PROXY_USER=your_username \
  -e NOVADA_PROXY_PASS=your_password \
  -- npx -y bestproxy4agents

获取凭据：novada.com → Dashboard → Residential Proxies → Endpoint Generator

BrightData

完整集成：通过 BrightData 的用户名后缀格式，自动定位国家、城市和会话。

claude mcp add bestproxy4agents \
  -e BRIGHTDATA_USER="brd-customer-abc123-zone-residential" \
  -e BRIGHTDATA_PASS=your_password \
  -- npx -y bestproxy4agents

获取凭据：brightdata.com → Proxies & Scraping → Residential → Access Parameters

BRIGHTDATA_USER 是包含 zone 的完整用户名（例如 brd-customer-abc123-zone-residential）。可选：BRIGHTDATA_HOST（默认值：zproxy.lum-superproxy.io）、BRIGHTDATA_PORT（默认值：22225）。

Smartproxy

完整集成：自动定位国家、城市和会话。

claude mcp add bestproxy4agents \
  -e SMARTPROXY_USER=your_username \
  -e SMARTPROXY_PASS=your_password \
  -- npx -y bestproxy4agents

获取凭据：smartproxy.com → Dashboard → Residential → Endpoint Generator

可选：SMARTPROXY_HOST（默认值：gate.smartproxy.com）、SMARTPROXY_PORT（默认值：10001）。

Oxylabs

完整集成：自动定位国家、城市和会话。

claude mcp add bestproxy4agents \
  -e OXYLABS_USER=your_username \
  -e OXYLABS_PASS=your_password \
  -- npx -y bestproxy4agents

获取凭据：oxylabs.io → Dashboard → Residential Proxies → Access Details

可选：OXYLABS_HOST（默认值：pr.oxylabs.io）、OXYLABS_PORT（默认值：7777）。

通用 HTTP 代理——其他任意提供商

设置 PROXY_URL，即可使用 IPRoyal、自有基础设施或任何标准 HTTP 代理。

# IPRoyal
claude mcp add bestproxy4agents \
  -e PROXY_URL="http://username:[email protected]:12321" \
  -- npx -y bestproxy4agents

# Any HTTP proxy
claude mcp add bestproxy4agents \
  -e PROXY_URL="http://user:pass@your-proxy-host:port" \
  -- npx -y bestproxy4agents

注意： 使用通用适配器时，请按照提供商的格式，直接在代理 URL 中设置国家／城市／会话定位参数。工具参数 country、city 和 session_id 会作为警告记录，不会转发。

功能	Novada	BrightData	Smartproxy	Oxylabs	通用 HTTP
自动定位国家	✓	✓	✓	✓	手动
自动定位城市	✓	✓	✓	✓	手动
粘性会话	✓	✓	✓	✓	手动
内置搜索 API	✓	—	—	—	—
浏览器 API（JS 渲染）	✓	—	—	—	—

---

获取凭据

在 novada.com 注册——只需 30 秒，无需信用卡。

工具	必需的环境变量	获取位置
agentproxy_fetch	NOVADA_PROXY_USER + NOVADA_PROXY_PASS	控制面板 → Residential Proxies → Endpoint Generator
agentproxy_session	NOVADA_PROXY_USER + NOVADA_PROXY_PASS	控制面板 → Residential Proxies → Endpoint Generator
agentproxy_search	NOVADA_API_KEY	控制面板 → API Keys
agentproxy_render [BETA]	NOVADA_BROWSER_WS	控制面板 → Browser API → Playground → 复制 Puppeteer URL
agentproxy_status	(无)	—

你只需要为要使用的工具配置凭据。

---

安装

Fetch + Session（核心功能——建议从这里开始）：

claude mcp add bestproxy4agents \
  -e NOVADA_PROXY_USER=your_username \
  -e NOVADA_PROXY_PASS=your_password \
  -e NOVADA_PROXY_HOST=your_account_host \
  -- npx -y bestproxy4agents

仅安装搜索：

claude mcp add bestproxy4agents \
  -e NOVADA_API_KEY=your_key \
  -- npx -y bestproxy4agents

安装所有工具：

claude mcp add bestproxy4agents \
  -e NOVADA_PROXY_USER=your_username \
  -e NOVADA_PROXY_PASS=your_password \
  -e NOVADA_PROXY_HOST=your_account_host \
  -e NOVADA_API_KEY=your_key \
  -- npx -y bestproxy4agents

NOVADA_PROXY_HOST——从 Endpoint Generator 获取的账户专属代理主机（例如 abc123.vtv.na.novada.pro）。要确保粘性会话可靠运行，此项为必填。若省略，则默认使用共享负载均衡器。

---

兼容性

Proxy4Agent 兼容任何 MCP 客户端：

客户端	安装方法
Claude Code	claude mcp add bestproxy4agents -e ... -- npx -y bestproxy4agents
Cursor	设置 → MCP → 添加服务 → npx -y bestproxy4agents
Windsurf	MCP 配置 → npx -y bestproxy4agents
Cline	MCP 设置 → 命令：npx，参数：["-y", "bestproxy4agents"]
Continue	.continue/config.json → mcpServers
Smithery	smithery.ai/server/proxy4agent
任何 MCP 客户端	stdio 传输，npx -y bestproxy4agents

Claude Code 示例（可直接复制粘贴）：

claude mcp add bestproxy4agents \
  -e NOVADA_PROXY_USER=your_username \
  -e NOVADA_PROXY_PASS=your_password \
  -- npx -y bestproxy4agents

Cursor / Windsurf / Cline——添加到 MCP 配置中：

{
  "mcpServers": {
    "bestproxy4agents": {
      "command": "npx",
      "args": ["-y", "bestproxy4agents"],
      "env": {
        "NOVADA_PROXY_USER": "your_username",
        "NOVADA_PROXY_PASS": "your_password"
      }
    }
  }
}

---

工具

agentproxy_fetch

通过住宅代理获取任意 URL。适用于 Amazon、LinkedIn、Cloudflare 保护的页面，以及大多数受反机器人机制保护的网站。

需要： 任意代理提供商——Novada（NOVADA_PROXY_USER + NOVADA_PROXY_PASS）、BrightData、Smartproxy、Oxylabs 或 PROXY_URL

参数	类型	默认值	说明
url	string	必填	目标 URL（http:// 或 https://）
country	string	—	2 位 ISO 代码：US、DE、JP、GB、BR、IN、FR、CA、AU……（195 个以上的国家）
city	string	—	城市级定位：newyork、london、tokyo、paris、berlin……
session_id	string	—	重用相同 ID 以保持 IP 不变（仅限字母、数字和下划线，最多 64 个字符）
format	string	markdown	markdown 会剥离 HTML 标签；raw 会返回完整 HTML
timeout	number	60	超时时间，单位为秒（1–120）

---

agentproxy_session

粘性会话抓取 — 使用相同 session_id 的每次调用都会使用同一个住宅 IP。对于登录流程、分页抓取以及跨页面价格监控至关重要。

需要： 任意代理提供商 — Novada（NOVADA_PROXY_USER + NOVADA_PROXY_PASS）、BrightData、Smartproxy、Oxylabs 或 PROXY_URL

参数	类型	默认值	描述
session_id	string	必填	唯一 ID — 重复使用以保持相同 IP（不能包含连字符，最多 64 个字符）
url	string	必填	目标 URL
country	string	—	2 个字母的国家/地区代码
city	string	—	按城市定位：newyork、london、tokyo……
format	string	markdown	markdown 或 raw
timeout	number	60	超时时间，单位为秒（1–120）

---

agentproxy_search

通过 Novada 执行结构化 Google 搜索。返回标题、URL 和描述 — 无需解析 HTML。最适合发现和研究任务。

需要： NOVADA_API_KEY

参数	类型	默认值	描述
query	string	必填	搜索查询
num	number	10	结果数量（1–20）
country	string	—	本地化结果：us、uk、de、jp、fr……
language	string	—	语言：en、zh、de、ja、fr……

---

agentproxy_render [BETA]

使用 Novada 的 Browser API 渲染 JavaScript 内容较多的页面（真实 Chromium，完整执行 JS）。适用于 SPA、React/Vue 应用，以及在没有真实浏览器时会返回空白的页面。

需要： NOVADA_BROWSER_WS（从 Dashboard → Browser API → Playground 复制 Puppeteer URL）

参数	类型	默认值	描述
url	string	必填	目标 URL
format	string	markdown	markdown · html · text
wait_for	string	—	提取内容前等待的 CSS 选择器（例如 .product-title）
timeout	number	60	超时时间，单位为秒（5–120）

---

agentproxy_status

检查 Novada 代理网络的运行状况 — 实时节点数量、设备类型和服务状态。无需凭据。

---

真实场景结果

实际 API 调用的实时输出 — 并非编造。

地理定位：相同 URL，不同出口国家/地区

agentproxy_fetch(url="https://httpbin.org/ip", country="US", format="raw")
→ { "origin": "200.50.235.236" }   ← US residential IP

agentproxy_fetch(url="https://httpbin.org/ip", country="JP", format="raw")
→ { "origin": "60.85.57.175" }     ← Japan residential IP

粘性会话：已确认两次请求使用相同 IP

agentproxy_session(session_id="job001", url="https://httpbin.org/ip", format="raw")
→ { "origin": "103.135.135.168" }

agentproxy_session(session_id="job001", url="https://httpbin.org/ip", format="raw")
→ { "origin": "103.135.135.168" }  ← same IP, confirmed ✓

Amazon — 1.6 MB 商品页面，未被拦截

agentproxy_fetch(url="https://www.amazon.com/dp/B0BSHF7WHW", country="US")
→ [URL: https://www.amazon.com/dp/B0BSHF7WHW | Status: 200 | Size: 1637 KB | Country: US]

  Apple 2023 MacBook Pro — M2 Pro chip, 16-inch, 16GB, 1TB
  Full product page: price, reviews, specs, related items

HackerNews — 30 条新闻，格式整洁的 Markdown

agentproxy_fetch(url="https://news.ycombinator.com")
→ [URL: https://news.ycombinator.com | Status: 200 | Size: 34 KB]

  1. LittleSnitch for Linux — 752 points, 243 comments
  2. I ported Mac OS X to the Nintendo Wii — 1590 points, 281 comments
  3. Git commands I run before reading any code — 2054 points, 445 comments
  ...

Google 搜索 — 结构化输出，无需解析 HTML

agentproxy_search(query="residential proxy for AI agents", num=3)
→ Search: "residential proxy for AI agents" via GOOGLE — 3 results

  1. Residential Proxies Trusted by Fortune 500 Companies
     https://brightdata.com/proxy-types/residential-proxies
     Access 400M+ residential proxies from 195 countries...

  2. Proxies for AI Web Agents: The Complete Guide
     https://netnut.io/proxies-for-ai-web-agents/
     Real-user IPs that bypass even the toughest anti-bot systems...

浏览器渲染 — React SPA，完整执行 JS

agentproxy_render(url="https://react.dev", format="markdown")
→ [URL: https://react.dev | Title: React | Size: 266 KB | Rendered: yes (Browser API)]

  React v19.2

  The library for web and native user interfaces

  ## Create user interfaces from components
  React lets you build user interfaces out of individual pieces called components.
  Create your own React components like Thumbnail, LikeButton, and Video.
  Then combine them into entire screens, pages, and apps.
  ...

浏览器渲染 — 在 HackerNews 上使用 wait_for 选择器

agentproxy_render(url="https://news.ycombinator.com", wait_for=".athing")
→ [URL: https://news.ycombinator.com | Title: Hacker News | Size: 34 KB | Rendered: yes (Browser API)]

  1. LittleSnitch for Linux — 834 points, 285 comments
  2. Help Keep Thunderbird Alive — 138 points, 77 comments
  3. I ported Mac OS X to the Nintendo Wii — 1638 points
  ...

---

工作流示例

价格监控 — 同一商品，三个市场

agentproxy_fetch(url="https://amazon.com/dp/B0BSHF7WHW", country="US")
agentproxy_fetch(url="https://amazon.com/dp/B0BSHF7WHW", country="DE")
agentproxy_fetch(url="https://amazon.com/dp/B0BSHF7WHW", country="JP")

登录 + 使用相同 IP 抓取多个页面

agentproxy_session(session_id="workflow01", url="https://example.com/login")
agentproxy_session(session_id="workflow01", url="https://example.com/dashboard")
agentproxy_session(session_id="workflow01", url="https://example.com/data/page/1")
agentproxy_session(session_id="workflow01", url="https://example.com/data/page/2")

研究工作流

# 1. Find relevant pages
agentproxy_search(query="Claude MCP proxy tools", num=10)

# 2. Fetch each result through residential proxy
agentproxy_fetch(url="https://found-result.com/article", country="US")

# 3. Render JS-heavy dashboard (requires Browser API)
agentproxy_render(url="https://app.example.com/dashboard", wait_for=".data-table")

---

地理覆盖范围

195+ 个国家/地区，包括：

US GB DE FR JP CA AU BR IN KR SG NL IT ES MX RU PL SE NO DK FI CH AT BE PT CZ HU RO UA TR IL ZA NG EG AR CL CO PE VN TH ID MY PH PK BD TW HK NZ + 另外 188 个

按城市定位（部分）：newyork · losangeles · chicago · london · paris · berlin · tokyo · seoul · sydney · toronto · singapore · dubai · mumbai · saopaulo

---

网络

指标	数值
住宅 IP	2,000,000+
实时节点	7,000+
国家/地区	195+
设备类型	Android、Windows、Mac
正常运行时间	99.9%

---

已确认可用

电子商务： Amazon、eBay、Walmart、Etsy、Shopify 商店
专业社交网络： LinkedIn
受反机器人机制保护： Cloudflare 网站、受 Akamai 保护的页面、受 DataDome 保护的网站
新闻与内容： HackerNews、Reddit、BBC、CNN、NYTimes
科技： GitHub、Wikipedia、Stack Overflow
娱乐： IMDB、Rotten Tomatoes

---

依赖项

Package	Version	Purpose
@modelcontextprotocol/sdk	^1.26	MCP 协议 — stdio 传输、工具定义、请求处理
axios	^1.7	HTTP 客户端 — 处理重定向、压缩和流式传输
https-proxy-agent	^9.0	HTTPS 代理路由 — 为安全目标建立 CONNECT 隧道和 TLS 连接
http-proxy-agent	^7.0	HTTP 代理路由 — 通过代理访问纯 HTTP 目标
puppeteer-core	^22.15	浏览器 API — 通过 WebSocket 连接到 Novada 的真实 Chromium 云服务

轻量核心。软件包大小：约 52 KB（不含 node_modules）。puppeteer-core 是最大的依赖项，但不捆绑浏览器 — 它会连接到 Novada 的远程 Chromium。

---

使用场景

适用于需要以下能力的 AI Agent：

• 抓取电商网站（Amazon、eBay、Walmart、Shopify），避免被封锁
• 监控不同国家和市场的价格
• 访问来自 195+ 个国家/地区的地理限制内容
• 对受 Cloudflare/Akamai 保护的网站进行竞争情报分析
• 执行多步骤登录流程并保持 IP 不变（粘性会话）
• 渲染没有真实浏览器就会返回空白的 JavaScript 密集型 SPA
• 以编程方式搜索 Google，并获取简洁的结构化结果
• 收集不同地区的本地化搜索结果
• 访问受反机器人系统保护的专业社交网络（LinkedIn）

适用于构建以下项目的开发者：

• AI 驱动的网络研究工具
• 价格比较 Agent
• 内容聚合管道
• SEO 监控仪表板
• 市场研究自动化工具
• 潜在客户生成工作流

---

反馈与支持

欢迎与我们联系 — 提交功能请求、错误报告，或分享你如何使用 proxy4agent：

• 电子邮件： [email protected]
• GitHub 问题： github.com/Goldentrii/proxy4agent/issues
• 网站： novada.com

你的反馈将推动我们的路线图。每一份错误报告和功能请求，都有助于让 proxy4agent 更好地服务所有 Agent 和开发者。

---

已知限制

• 需要完整 JS 执行的网站 → 使用 agentproxy_render
• agentproxy_render 需要单独订阅 Novada Browser API，并设置 NOVADA_BROWSER_WS
• 会话 ID 不得包含连字符（Novada 使用 - 作为身份验证分隔符）
• 如需可靠的粘性会话，请将 NOVADA_PROXY_HOST 设置为你的账户专属主机

---

许可证

MIT © Novada

特此免费授予任何获得本软件及相关文档文件（以下简称“软件”）副本的人不受限制地处理本软件的权利，包括但不限于使用、复制、修改、合并、发布、分发、再许可和／或销售本软件副本，并允许获得本软件的人这样做，但须满足以下条件：上述版权声明和本许可声明应包含在本软件的所有副本或实质性部分中。

本软件按“原样”提供，不提供任何形式的担保。

完整文本请参阅 LICENSE。

---

---

Proxy4Agent（中文文档）

面向 AI Agent 的住宅代理 MCP 服务。 通过 200 万+ 台真实家庭设备路由 HTTP 请求，绕过反机器人系统，按国家/城市定位，并在不同请求间保持同一 IP。

支持 Claude Code、Cursor、Windsurf、Cline、Continue 及所有兼容 MCP 的 Agent。由 Novada 提供支持。

---

为什么选择 Proxy4Agent

AI Agent 在 60-70% 的商业网站上会被封锁。标准 HTTP 请求会被 Cloudflare、Akamai、DataDome 等系统检测并拒绝。Proxy4Agent 通过真实住宅 IP 路由请求 — 与人类浏览器无法区分。

问题	Proxy4Agent
Amazon、LinkedIn 封锁你的 Agent	来自真实家庭设备的住宅 IP
Cloudflare / Akamai 机器人检测	通过真实设备指纹绕过检测
JS 渲染页面返回空白	浏览器 API 运行真实 Chromium
地区限制或本地化内容	195+ 个国家/地区，城市级定位
多步骤工作流丢失会话	粘性会话 — 不同请求间保持同一 IP
需要结构化搜索结果	内置 Google 搜索，输出 JSON

---

支持的代理提供商

优先级：Novada → BrightData → Smartproxy → Oxylabs → 通用 HTTP。首个配置的提供商生效。

功能	Novada	BrightData	Smartproxy	Oxylabs	通用 HTTP
自动国家定位	✓	✓	✓	✓	手动
自动城市定位	✓	✓	✓	✓	手动
粘性会话	✓	✓	✓	✓	手动
搜索 API	✓	—	—	—	—
浏览器 API (JS 渲染)	✓	—	—	—	—

---

快速开始

# Novada（推荐）
claude mcp add bestproxy4agents \
  -e NOVADA_PROXY_USER=你的用户名 \
  -e NOVADA_PROXY_PASS=你的密码 \
  -- npx -y bestproxy4agents

# BrightData
claude mcp add bestproxy4agents \
  -e BRIGHTDATA_USER="brd-customer-abc123-zone-residential" \
  -e BRIGHTDATA_PASS=你的密码 \
  -- npx -y bestproxy4agents

# 任意 HTTP 代理
claude mcp add bestproxy4agents \
  -e PROXY_URL="http://user:pass@host:port" \
  -- npx -y bestproxy4agents

获取 Novada 凭证：novada.com → 仪表盘 → 住宅代理 → 端点生成器

---

5 个 MCP 工具

工具	功能
agentproxy_fetch	通过住宅代理获取任何 URL。支持国家/城市/会话定位。
agentproxy_session	粘性会话 — 同一 session_id 使用同一 IP。用于登录流程、分页抓取。
agentproxy_search	Google 搜索，返回标题、URL、描述。无需 HTML 解析。
agentproxy_render	用真实 Chromium 渲染 JS 页面（SPA、React/Vue 应用）。
agentproxy_status	检查代理网络健康状态。无需凭证。

---

使用场景

AI 智能体需要：

• 抓取电商网站（Amazon、eBay、Walmart、Shopify）不被封锁
• 跨国家监控价格
• 访问 195+ 国家的地区限制内容
• 对 Cloudflare/Akamai 保护的站点进行竞争情报收集
• 执行多步登录流程并保持同一 IP
• 渲染无真实浏览器就返回空白的 JS 页面
• 获取不同地区的本地化搜索结果

开发者构建：

• AI 驱动的网页研究工具
• 价格比较智能体
• 内容聚合管道
• SEO 监控仪表盘
• 市场调研自动化

---

反馈与支持

• 邮箱： [email protected]
• GitHub Issues： github.com/Goldentrii/proxy4agent/issues
• 网站： novada.com

---

许可证

MIT © Novada