Agent-first 联邦搜索系统，支持零 API Key 基线运行与 10+ 搜索服务商聚合，提供可解释路由与结构化证据包。
说明：
## 核心用法
**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` 交叉验证 |
