Agent 联邦搜索：零 Key 启动，多源聚合

Agent-first 联邦搜索系统，支持零 API Key 基线运行与 10+ 搜索服务商聚合，提供可解释路由与结构化证据包。

基本信息

• 技能名称?Web Search Pro
• 中文名称?Agent 联邦搜索：零 Key 启动，多源聚合
• 作者?zjianru
• 分类?专业技能
• 版本?2.1.4
• 标签?web-search, news-search, agent-tool, federated-search, no-key-baseline, tavily, perplexity, searxng, research-automation, docs-lookup, code-search

使用方法

使用说明
核心用法
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 交叉验证 |