核心用法
Web Search Pro 是一款面向 AI Agent 的联邦搜索与检索工具，核心设计遵循「Agent-first」理念。用户可通过 Node 运行时直接调用，无需任何 API Key 即可完成基础搜索（基于 DuckDuckGo 无 Key 搜索）。
主要命令：
search.mjs：实时网页/新闻搜索，支持--preset docs/news定向检索extract.mjs：单页内容提取crawl.mjs：站点深度爬取map.mjs：站点地图生成research.mjs：多轴研究计划与执行doctor.mjs/capabilities.mjs：环境诊断与能力自检
路由与联邦机制：
selectedProvider：主选路由routingSummary：紧凑路由解释含置信度federated.*：多服务商结果聚合指标（新增覆盖率、结果恢复量、交叉验证、去重节省）
服务商矩阵（可选）：
| 服务商 | 特性 |
|--------|------|
| Tavily | 深度搜索、新闻、内容提取 |
| Exa | 语义搜索与提取 |
| Querit | 多语言原生地理/语言过滤 |
| Serper | 类 Google 搜索与新闻 |
| Brave | 结构化搜索，OpenClaw 兼容 |
| SerpAPI | 多引擎含百度 |
| You.com | LLM-ready 搜索，时效性/本地化 |
| Perplexity/Sonar | 原生答案优先搜索 |
| SearXNG | 自托管隐私元搜索 |
显著优点
1. 零门槛基线：Node 唯一硬依赖，无 Key 即可运行，适合快速验证与隐私敏感场景
2. 可解释路由：--explain-routing / --plan 暴露完整决策链路，便于 Agent 审计
3. 联邦增益量化：federated.value.* 指标让多服务商策略的价值可测量
4. 多模态输出：JSON 结构化响应兼容自动化流水线，缓存命中与 TTL 透明
5. 弹性部署：支持原生 API、OpenRouter/Kilo 网关、自定义 OpenAI-compatible 代理
潜在局限
- 基线质量波动：DuckDuckGo 无 Key 搜索受反爬策略影响，复杂查询可能降级
- 服务商成本分散：高级功能需管理多组 API Key，配置复杂度随覆盖需求上升
- Node 运行时绑定：非 Node 环境需额外适配层
- 实时性边界：缓存机制（
.cache/web-search-pro）可能滞后于极速变化的信息源
适合人群
- AI Agent 开发者：需要可解释、可审计的搜索中间件
- 自动化工作流构建者：追求结构化 JSON 输出与缓存优化
- 隐私优先用户：SearXNG 自托管 + 无 Key 基线满足合规需求
- 多语言/多地域研究者：Querit 原生过滤 + 百度覆盖
常规风险
| 风险类型 | 说明 | 缓解 |
|----------|------|------|
| API Key 泄露 | 多服务商配置增加暴露面 | 使用 env 注入，避免硬编码 |
| 数据隐私 | 第三方服务商可能记录查询 | 敏感场景优先 SearXNG 自托管 |
| 服务可用性 | 单一服务商故障影响深度功能 | 联邦设计天然冗余，基线保底 |
| 结果可信度 | 聚合来源质量参差 | 利用 `resultsCorroboratedByFanout` 交叉验证 |