proxy4agents-mcp

Novada Proxy

面向 Agent 的住宅代理 MCP——兼容任何提供商。

通过 200 多万台真实家庭设备（Android 手机、Windows PC 和 Mac）转发任何 HTTP 请求，绕过反机器人系统、按国家或城市定位地理位置，并在多步骤工作流中保持粘性会话。由 Novada 提供支持。

为什么选择 · 安装 · 工具 · 提示词 · 资源 · 提供商 · 面向 Agent 的设计

兼容 Claude Code、Cursor、Windsurf、Cline、Continue 以及任何兼容 MCP 的 AI Agent。

提示

提供免费套餐——在 novada.com 注册，无需信用卡。免费使用 Scraper API、Web Unblocker 和住宅代理，立即开始构建。

开始使用

1. 创建免费账户：novada.com——无需信用卡
2. 获取凭据：前往 Dashboard → Residential Proxies → Endpoint Generator，复制用户名和密码
3. 安装并运行：

# Claude Code
claude mcp add novada-proxy-mcp \
  -e NOVADA_PROXY_USER=your_username \
  -e NOVADA_PROXY_PASS=your_password \
  -- npx -y novada-proxy-mcp

# Or use the CLI directly
npx novada-proxy-mcp status
npx novada-proxy fetch https://example.com

面向 Agent

说明

**Agent：**请告知用户完成上述步骤 1–2。设置好环境变量中的凭据后，即可立即使用全部 10 个工具。无需轮换 API 密钥，也无需刷新令牌——代理凭据是持久有效的。

Required env vars:
  NOVADA_PROXY_USER   — from novada.com dashboard
  NOVADA_PROXY_PASS   — from novada.com dashboard

Optional (for extra features):
  NOVADA_API_KEY      — enables novada_proxy_search (Google search)
  NOVADA_BROWSER_WS   — enables novada_proxy_render (JS rendering)
  NOVADA_PROXY_ZONE   — "res" (default), "isp", or "dcp"

**需要帮助？**请联系 [email protected]

为什么选择 Novada Proxy

AI Agent 在 60–70% 的商业网站上会被拦截。Cloudflare、Akamai、DataDome 和 PerimeterX 会检测并拒绝标准 HTTP 请求。Novada Proxy 会通过真实的住宅 IP 路由 Agent，使其看起来与真人浏览器无异。

10 个工具一览

快速选择指南

何时使用哪个工具

Goal: "Scrape a single URL"
  └─ Static HTML page?          → novada_proxy_fetch
  └─ Need specific fields?      → novada_proxy_extract (fields or schema mode)
  └─ React/Vue SPA / blank page? → novada_proxy_render

Goal: "Scrape multiple URLs"
  └─ You have the URLs already  → novada_proxy_batch_fetch
  └─ You need links from one page → novada_proxy_map → novada_proxy_batch_fetch
  └─ You need to crawl a whole site → novada_proxy_crawl → novada_proxy_batch_fetch

Goal: "Research a topic"        → novada_proxy_research (search + fetch + findings in one call)

Goal: "Search the web"          → novada_proxy_search → novada_proxy_batch_fetch

Goal: "Login + multi-page flow" → novada_proxy_session (same session_id)

Goal: "Check if proxy works"    → novada_proxy_status

5 个提示词

预构建的 Agent 工作流，可将多个工具串联起来。从任意 MCP 客户端调用，即可一步执行常见模式。

说明

提示词会自动编排多工具工作流。例如，research_topic 会依次运行 novada_proxy_search 和 novada_proxy_batch_fetch，Agent 无需自行确定流程。

5 个资源

随时可读取的参考数据，Agent 可在任何时候访问，无需调用代理。

快速安装

核心功能——通过住宅代理获取任意 URL：

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

仅搜索：

claude mcp add novada-proxy-mcp \
  -e NOVADA_API_KEY=your_key \
  -- npx -y novada-proxy-mcp

所有工具（代理 + 搜索 + 浏览器渲染）：

claude mcp add novada-proxy-mcp \
  -e NOVADA_PROXY_USER=your_username \
  -e NOVADA_PROXY_PASS=your_password \
  -e NOVADA_API_KEY=your_key \
  -e NOVADA_BROWSER_WS=your_browser_ws_url \
  -- npx -y novada-proxy-mcp

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

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

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

服务提供商

Novada Proxy 可与任何 HTTP 代理服务提供商配合使用。Novada 是内置默认服务，集成最深入。

优先级： Novada -> BrightData -> Smartproxy -> Oxylabs -> Generic。优先使用第一个已配置的服务提供商。

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

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

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

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

面向 Agent 的设计

说明

Novada Proxy 是唯一专为自主 AI Agent 设计的代理 MCP。每条响应、错误和描述都针对机器处理进行了优化。

工具

novada_proxy_fetch

通过住宅代理获取任意 URL。返回包含内容、状态码和元数据的结构化 JSON。网络错误时自动重试。缓存重复调用（默认 TTL 为 300s——meta.cache_hit: true 表示未使用代理积分）。

响应：

{
  "ok": true,
  "tool": "novada_proxy_fetch",
  "data": { "url": "...", "status_code": 200, "content": "...", "size_bytes": 34000 },
  "meta": { "latency_ms": 1800, "cache_hit": false, "quota": { "credits_estimated": 1 } }
}

novada_proxy_batch_fetch

通过住宅代理并发获取 2–20 个 URL。速度最高可达顺序获取的 5 倍。每个 URL 的错误会单独捕获——即使部分 URL 获取失败，批次本身仍会成功。已获取过的 URL 会复用响应缓存。

响应：

{
  "ok": true,
  "tool": "novada_proxy_batch_fetch",
  "data": {
    "requested": 3,
    "succeeded": 3,
    "failed": 0,
    "results": [
      { "url": "https://...", "ok": true, "content": "...", "cache_hit": false, "latency_ms": 1200 },
      { "url": "https://...", "ok": true, "content": "...", "cache_hit": true,  "latency_ms": 0 },
      { "url": "https://...", "ok": false, "error": { "code": "TLS_ERROR", "message": "..." } }
    ]
  },
  "meta": { "latency_ms": 4100, "quota": { "credits_estimated": 3 } }
}

novada_proxy_extract

使用启发式模式匹配（meta 标签、Open Graph、JSON-LD、Schema.org）从任意 URL 提取结构化字段。轻量级，无需大模型。设置 render_fallback: true，即可在代理获取失败时自动通过真实 Chromium 重试。

响应：

{
  "ok": true,
  "tool": "novada_proxy_extract",
  "data": {
    "url": "https://books.toscrape.com/...",
    "fields": { "title": "A Light in the Attic", "price": "£51.77", "description": null },
    "extracted_via": "proxy_fetch"
  },
  "meta": { "latency_ms": 2100, "quota": { "credits_estimated": 1 } }
}

novada_proxy_map

爬取 URL 并将所有内部链接作为结构化 JSON 数组返回。可作为使用 novada_proxy_batch_fetch 爬取整个网站前的发现步骤，无需猜测 URL。

响应：

{
  "ok": true,
  "tool": "novada_proxy_map",
  "data": {
    "domain": "books.toscrape.com",
    "internal_url_count": 20,
    "internal_urls": ["https://books.toscrape.com/catalogue/...", "..."],
    "sitemap_hint": "https://books.toscrape.com/sitemap.xml (check manually)"
  },
  "meta": { "latency_ms": 3800, "quota": { "credits_estimated": 1 } }
}

novada_proxy_session

粘性会话抓取 — 使用相同 session_id 的每次调用都会使用同一个住宅 IP。对于登录流程、分页抓取和价格监控至关重要。支持 verify_sticky: true，可在依赖 IP 一致性之前进行确认。

novada_proxy_search

通过 Novada Scraper API 进行结构化 Google 搜索。以干净的 JSON 返回标题、URL 和摘要 — 无需解析 HTML。

novada_proxy_render [BETA]

使用 Novada 的 Browser API 渲染 JavaScript 密集型页面（真实 Chromium，完整执行 JS）。适用于 SPA、React/Vue 应用，以及通过标准 HTTP 抓取时返回空白的页面。

需要： NOVADA_BROWSER_WS — 从 Dashboard -> Browser API -> Playground 复制 Puppeteer URL

每次调用约消耗 5 个代理积分，而 novada_proxy_fetch 仅消耗 1 个。需要时，可通过 novada_proxy_extract 配合 render_fallback: true 自动升级处理。

novada_proxy_crawl

通过 BFS 遍历递归抓取网站。从一个 URL 开始，发现每个深度层级的链接，并返回包含元数据的完整 URL 树。

适用场景： 全站抓取、生成站点地图、内容索引 — 当你需要的不止是单个页面时。

以下情况请改用 novada_proxy_map： 只需获取一个页面的链接（仅深入一层）。对于单页链接发现，Map 更快且成本更低。

链式调用： 使用 novada_proxy_batch_fetch 抓取 URL 树中的指定页面。

示例：

{
  "url": "https://example.com",
  "depth": 2,
  "limit": 50,
  "include_content": false
}

响应： data.pages[]（url、depth、status_code、total_links）、data.urls[]（可用于链式传入 novada_proxy_batch_fetch 的扁平数组）

novada_proxy_research

一次性研究工具 — 搜索网页、获取排名靠前的结果，并返回包含来源预览的结构化发现。Agent 可以分析这些发现，进行更深入的综合分析。

需要： NOVADA_API_KEY（用于 Google 搜索）+ Proxy 凭据（用于获取来源）

适用场景： 研究问题、主题调查、竞争分析、事实查证 — 需要一次调用从多个来源获取内容时。

如果只需要搜索结果 URL，而不需要完整页面内容： 改用 novada_proxy_search。

后续调用： 对特定的 urls[] 使用 novada_proxy_fetch，以深入阅读单个来源。

注意： findings_summary 是多个来源的拼接预览 — Agent 应分析 findings[]，以进行实际的综合分析。

示例：

{
  "query": "best residential proxy providers 2026",
  "depth": "standard"
}

响应： data.findings[]（包含标题、URL、摘要、内容预览）、data.urls[]（用于后续调用）、data.findings_summary

novada_proxy_extract — Schema 模式

除了 fields（启发式提取）之外，novada_proxy_extract 还支持 schema 参数，可通过 Agent 的大模型提取任意字段 — 不产生额外的 API 费用。

Schema 模式（LLM 提取）

传入 schema 而不是 fields，即可提取任意字段。工具会返回清理后的页面内容和提取提示词 — 由 Agent 执行提取（不产生额外的 API 费用）。

示例：

{
  "url": "https://example.com/product",
  "schema": {
    "product_name": "The full product name",
    "price": "Current price with currency",
    "warranty": "Warranty terms and duration",
    "return_policy": "Return policy summary"
  }
}

响应： data.mode = "llm_extract"、data.content（清理后的 Markdown）、data.extraction_prompt（供 Agent 遵循并提取字段的说明）

安全性： Schema 键必须由字母数字字符和下划线组成（a-z、0-9、_），长度最多为 50 个字符。值的长度最多为 200 个字符。

novada_proxy_status

检查代理网络连接和版本。执行实时代理调用以确认连接正常。无需凭据。

Agent 工作流

网站爬取流水线（map -> batch）

# Agent task: "Read all products on this catalogue"
1. novada_proxy_map(url="https://books.toscrape.com", limit=50)
   → returns 20–50 internal URLs in 4s, 1 credit

2. novada_proxy_batch_fetch(urls=[...20 URLs], concurrency=5)
   → fetches all 20 pages in parallel, ~4s wall time, 20 credits
   (vs ~60s sequential = 15x speedup)

研究流水线（search -> batch）

# Agent task: "Find and read top 5 pages about X"
1. novada_proxy_search(query="residential proxy MCP", num=5)
   → structured JSON: titles, URLs, snippets

2. novada_proxy_batch_fetch(urls=[...5 URLs], format="markdown")
   → full content of all 5 pages in parallel

粘性会话 — 登录 + 多页面抓取

# Same IP across all calls
novada_proxy_session(session_id="job_001", url="https://example.com/login")
novada_proxy_session(session_id="job_001", url="https://example.com/dashboard")
novada_proxy_session(session_id="job_001", url="https://example.com/data/page/1")
novada_proxy_session(session_id="job_001", url="https://example.com/data/page/2")

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

novada_proxy_fetch(url="https://amazon.com/dp/B0BSHF7WHW", country="US")
novada_proxy_fetch(url="https://amazon.com/dp/B0BSHF7WHW", country="DE")
novada_proxy_fetch(url="https://amazon.com/dp/B0BSHF7WHW", country="JP")
# Second call per URL is a cache hit (0ms, 0 credits) if within 300s TTL

提取结构化数据

# Agent task: "Get product details without parsing HTML"
novada_proxy_extract(
  url="https://books.toscrape.com/catalogue/a-light-in-the-attic_1000/index.html",
  fields=["title", "price", "description", "rating"],
  render_fallback=true  # auto-retry via Chromium if proxy gets blocked
)

响应缓存

所有 novada_proxy_fetch 和 novada_proxy_batch_fetch 调用都会在进程内缓存。在 TTL 时间窗口内，重复抓取相同 URL 不会消耗 任何代理额度。

读取响应中的缓存状态：

"meta": {
  "cache_hit": true,          // served from cache — no proxy credit used
  "cache_age_seconds": 12,    // seconds since the entry was stored
  "latency_ms": 0             // ~0ms for cache hits
}

类型化错误代码

每个错误响应都包含类型化的 error.code、recoverable 标志，以及提供正确后续步骤的 agent_instruction。Agent 无需解析错误消息。

错误响应格式：

{
  "ok": false,
  "error": {
    "code": "BOT_DETECTION_SUSPECTED",
    "message": "HTTP 403 — request blocked by target",
    "recoverable": true,
    "agent_instruction": "Try novada_proxy_render (real browser). Or retry with a different country/session_id."
  }
}

地理覆盖范围

覆盖 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 TW HK NZ + 更多 148 个

城市级定向： newyork · losangeles · chicago · london · paris · berlin · tokyo · seoul · sydney · toronto · singapore · dubai · mumbai · saopaulo

兼容

网络

已确认可用

电商： Amazon、eBay、Walmart、Etsy、Shopify 商店
专业平台： LinkedIn
受反机器人保护的网站： Cloudflare、Akamai、DataDome
新闻与内容： HackerNews、Reddit、BBC、CNN、NYTimes
科技： GitHub、Wikipedia、Stack Overflow、IMDB

真实场景测试结果

使用 3 种 Novada 代理类型进行了 33 项真实场景测试（2026-04-28）：

成功率：94%（31/33 通过）。失败源于代理类型的限制（数据中心代理用于受反机器人保护的网站），而非代码缺陷。

代理类型指南

Known Limitations

Feedback & Support

• Email: [email protected]
• GitHub Issues: github.com/NovadaLabs/Novada-proxy/issues
• Website: novada.com

License

MIT © Novada — see LICENSE

Novada Proxy（中文文档）

AI 智能体专属住宅代理 MCP — 支持任意供应商。

通过 200 万+ 真实家庭设备（Android 手机、Windows 电脑、Mac）路由 HTTP 请求，绕过反机器人系统，按国家/城市精准定位，跨请求保持同一 IP。

工具 · 提示词 · 资源 · 安装 · 智能体优先 · 供应商

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

提示

免费套餐 — 在 novada.com 注册，无需信用卡。免费使用 Scraper API、Web Unblocker 和住宅代理。

10 个工具

novada_proxy_fetch       → 通过住宅代理抓取任意 URL
novada_proxy_batch_fetch → 并发抓取 2-20 个 URL（最高 5 倍加速）
novada_proxy_extract     → 从页面提取结构化字段（标题、价格、评分…）
novada_proxy_map         → 爬取页面，返回所有内部链接 JSON 数组
novada_proxy_crawl       → 递归爬取站点（BFS，深度 1-5），自动发现 URL
novada_proxy_session     → 粘性会话 — 同一 session_id 始终同一 IP
novada_proxy_search      → Google 搜索，返回结构化 JSON（无需解析 HTML）
novada_proxy_render      → 真实 Chromium 渲染 JS 页面 [BETA]
novada_proxy_research    → 一键深度研究 — 搜索 + 抓取 + 综合分析
novada_proxy_status      → 检查代理网络健康状态

5 个提示词

预构建的智能体工作流，将多个工具链式组合。

5 个资源

智能体可随时读取的参考数据，无需消耗代理额度。

快速决策指南

工具选择决策树

目标：抓取单个 URL
  ├─ 静态 HTML 页面？                    → novada_proxy_fetch
  ├─ 需要特定字段（价格/标题）？          → novada_proxy_extract（fields 或 schema 模式）
  └─ React/Vue SPA / 内容为空？          → novada_proxy_render

目标：批量抓取多个 URL
  ├─ 已有 URL 列表？                     → novada_proxy_batch_fetch
  ├─ 需要获取单页链接？                  → novada_proxy_map → novada_proxy_batch_fetch
  └─ 需要爬取整个站点？                  → novada_proxy_crawl → novada_proxy_batch_fetch

目标：研究某个主题                       → novada_proxy_research（一次调用搜索 + 抓取 + 分析）

目标：网页搜索                          → novada_proxy_search → novada_proxy_batch_fetch

目标：登录 + 多步骤流程                  → novada_proxy_session（相同 session_id）

目标：验证代理是否正常工作               → novada_proxy_status

三大流水线模式

全站爬取流水线（推荐）

novada_proxy_map(url, limit=50)
        │
        ▼
  返回 20-50 个内部链接（1 credit，4 秒）
        │
        ▼
novada_proxy_batch_fetch(urls, concurrency=5)
        │
        ▼
  并发抓取所有页面（N credits，~4 秒，比串行快 15x）

搜索研究流水线

novada_proxy_search(query, num=10)
        │
        ▼
  结构化 JSON：标题 + URL + 摘要
        │
        ▼
novada_proxy_batch_fetch(urls, format="markdown")
        │
        ▼
  全部页面内容并行返回

粘性会话 — 登录 + 多页抓取

session_id = "job_001"

novada_proxy_session(session_id, url="/login")    → 同一 IP
novada_proxy_session(session_id, url="/dashboard") → 同一 IP
novada_proxy_session(session_id, url="/data/1")    → 同一 IP
novada_proxy_session(session_id, url="/data/2")    → 同一 IP

智能体优先设计

说明

Novada Proxy 是唯一专为自主 AI 智能体设计的代理 MCP。每个响应、错误和描述都为机器消费而优化。

核心特性

1. 住宅 IP 网络

• 200 万+ 真实设备：Android 手机、Windows 电脑、Mac
• 7,000+ 活跃节点，99.9% 在线率
• 真实家庭 IP 指纹，绕过 Cloudflare、Akamai、DataDome 检测

2. 地理定向

• 195+ 国家，两字母 ISO 代码（US、DE、JP、BR...）
• 城市级定位：newyork、london、tokyo、singapore...
• 同一 URL 不同国家 = 独立缓存键，互不干扰

3. 响应缓存

重复抓取相同 URL 不消耗代理额度：

// 第一次调用（live fetch）
"meta": { "cache_hit": false, "latency_ms": 1800, "quota": { "credits_estimated": 1 } }

// 第二次调用（cache hit）
"meta": { "cache_hit": true, "cache_age_seconds": 5, "latency_ms": 0 }

4. 智能体优先的 JSON 输出

所有工具返回统一结构：

{
  "ok": true / false,
  "tool": "工具名称",
  "data": { ... },
  "meta": {
    "latency_ms": 1800,
    "cache_hit": false,
    "quota": { "credits_estimated": 1 }
  }
}

5. 类型化错误码 + 恢复指令

每个错误都包含 code（枚举）、recoverable（布尔）、agent_instruction（下一步操作）：

{
  "ok": false,
  "error": {
    "code": "BOT_DETECTION_SUSPECTED",
    "recoverable": true,
    "agent_instruction": "Try novada_proxy_render (real browser). Or retry with a different country/session_id."
  }
}

6. 批量并发抓取

novada_proxy_batch_fetch 内置信号量并发控制：

// 10 个 URL，concurrency=5，wall time = ~8.8s（串行估计 ~50s）
{
  "data": {
    "results": [
      { "url": "...", "ok": true, "cache_hit": false, "latency_ms": 1200 },
      { "url": "...", "ok": true, "cache_hit": true,  "latency_ms": 0 },
      { "url": "...", "ok": false, "error": { "code": "TLS_ERROR" } }
    ]
  },
  "meta": { "latency_ms": 8800, "quota": { "credits_estimated": 10 } }
}

7. 多供应商支持

8. 渐进式降级（render_fallback）

novada_proxy_extract 支持自动升级到浏览器渲染：

代理抓取失败（TLS / Bot检测）
        │
        ▼ render_fallback=true
novada_proxy_render（真实 Chromium）
        │
        ▼
data.extracted_via = "render"  （agent 知道走了哪条路径）
data.fetch_warning = "Proxy fetch failed... escalated to render"

快速安装

# 核心（住宅代理抓取）
claude mcp add novada-proxy-mcp \
  -e NOVADA_PROXY_USER=你的用户名 \
  -e NOVADA_PROXY_PASS=你的密码 \
  -- npx -y novada-proxy-mcp

# 仅搜索
claude mcp add novada-proxy-mcp \
  -e NOVADA_API_KEY=你的_API_Key \
  -- npx -y novada-proxy-mcp

# 全功能（代理 + 搜索 + 浏览器渲染）
claude mcp add novada-proxy-mcp \
  -e NOVADA_PROXY_USER=你的用户名 \
  -e NOVADA_PROXY_PASS=你的密码 \
  -e NOVADA_API_KEY=你的_API_Key \
  -e NOVADA_BROWSER_WS=你的_Browser_WS_URL \
  -- npx -y novada-proxy-mcp

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

Cursor / Windsurf / Cline 配置：

{
  "mcpServers": {
    "novada-proxy-mcp": {
      "command": "npx",
      "args": ["-y", "novada-proxy-mcp"],
      "env": {
        "NOVADA_PROXY_USER": "你的用户名",
        "NOVADA_PROXY_PASS": "你的密码"
      }
    }
  }
}

工具参数速查

novada_proxy_fetch

novada_proxy_batch_fetch

novada_proxy_extract

novada_proxy_map

novada_proxy_session

novada_proxy_search

novada_proxy_render [BETA]

novada_proxy_crawl

递归 BFS 爬取站点，从起始 URL 出发，按深度逐层发现链接，返回完整 URL 树及元数据。

适用场景： 全站抓取、站点地图生成、内容索引 — 需要抓取多个页面时使用。

改用 novada_proxy_map 的情况： 只需要单页链接（一层深度）。Map 更快、更省额度。

组合使用： 将 data.urls[] 传入 novada_proxy_batch_fetch 并发抓取。

请求示例：

{
  "url": "https://example.com",
  "depth": 2,
  "limit": 50,
  "include_content": false
}

响应： data.pages[]（url、depth、status_code、total_links），data.urls[]（扁平数组，可直接传给 novada_proxy_batch_fetch）

novada_proxy_research

一键深度研究工具 — 搜索网络、抓取排名靠前的结果，返回含来源预览的结构化分析。智能体可对 findings 进行进一步综合分析。

需要： NOVADA_API_KEY（Google 搜索）+ 代理凭证（抓取来源页面）

适用场景： 研究问题、主题调研、竞品分析、事实核查 — 需要一次调用获取多个来源内容时。

改用 novada_proxy_search 的情况： 只需要搜索结果 URL，不需要完整页面内容。

组合使用： 对 data.urls[] 中的特定 URL 调用 novada_proxy_fetch 进行深度阅读。

注意： findings_summary 是各来源内容的拼接预览 — 智能体应分析 findings[] 进行实质性综合。

请求示例：

{
  "query": "2026年最佳住宅代理服务商",
  "depth": "standard"
}

响应： data.findings[]（title、url、snippet、content_preview），data.urls[]（可链式传给其他工具），data.findings_summary

novada_proxy_extract — Schema 模式（LLM 提取）

除 fields（启发式提取）外，novada_proxy_extract 还支持 schema 参数，通过智能体自身的 LLM 提取任意字段 — 零额外 API 费用。

传入 schema 替代 fields，工具返回清洗后的页面内容 + 提取提示词 — 由你的智能体完成提取。

请求示例：

{
  "url": "https://example.com/product",
  "schema": {
    "product_name": "完整的产品名称",
    "price": "当前价格（含货币符号）",
    "warranty": "保修条款和期限",
    "return_policy": "退货政策摘要"
  }
}

响应： data.mode = "llm_extract"，data.content（清洗后的 Markdown 内容），data.extraction_prompt（供智能体遵循并提取字段的指令）

安全限制： Schema 键名只能包含字母、数字、下划线（a-z、0-9、_），最多 50 字符；值最多 200 字符。

使用场景

AI 智能体需要：

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

开发者构建：

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

已验证可用

电商： Amazon、eBay、Walmart、Etsy、Shopify
职业网络： LinkedIn
反机器人保护： Cloudflare 站点、Akamai、DataDome
新闻内容： HackerNews、Reddit、BBC、CNN、NYTimes
科技： GitHub、Wikipedia、Stack Overflow、IMDB

反馈与支持

• 邮箱： [email protected]
• GitHub Issues： github.com/NovadaLabs/Novada-proxy/issues
• 官网： novada.com

许可证

MIT © Novada