Web Search Pro

核心功能与定位

Web Search Pro 是一款面向 AI Agent 的多引擎精细化网络搜索工具，作为 OpenClaw 内置 web_search（Brave/Perplexity）的专业补充，提供域名过滤、深度搜索、新闻模式、日期范围限定、内容提取等高级能力。工具支持 Tavily、Exa、Serper、SerpAPI 四大引擎，可根据查询类型和可用 API Key 自动选择最优引擎。

显著优点

1. 引擎智能调度：内置自动选择逻辑，针对不同场景（默认搜索、深度研究、新闻追踪、特定域名）自动匹配最佳引擎，无需手动决策。
2. 精细化搜索控制：支持 include-domains/exclude-domains 域名白名单/黑名单、time-range/from/to 时间范围过滤、--deep 深度模式、--news 新闻模式，满足专业研究需求。
3. 多源覆盖：Tavily（AI 优化、1000次/月免费）、Exa（语义搜索、$10 额度）、Serper（真实 Google SERP、100次/月免费）、SerpAPI（多引擎支持百度/Yandex 等、250次/月免费）。
4. 内容提取能力：支持从 URL 提取可读内容（Tavily Extract / Exa livecrawl），便于后续分析处理。
5. 输出格式友好：默认 Markdown 格式便于 AI 消费，支持 --json 程序化调用。

潜在局限与风险

1. API Key 依赖：必须配置至少一个 API Key 才能运行，免费额度用尽后需付费或更换引擎。
2. 功能碎片化：部分高级参数仅特定引擎支持，如 --days 仅 Tavily、--search-engine baidu 仅 SerpAPI，用户需理解引擎差异。
3. 深度模式成本：--deep 模式消耗双倍 API credits（Tavily 2x），高频使用成本上升。
4. 错误处理严格：缺失必要 Key 或无效参数会快速失败退出，无降级 fallback，需确保配置完整。
5. Node.js 运行时依赖：要求环境中已安装 Node.js。

适合人群

• AI Agent 开发者：需要精细化搜索能力补充内置搜索的 Agent 构建者
• 研究人员/分析师：需要域名限定、时间范围、深度模式的专业信息检索场景
• 新闻追踪者：利用 Serper Google News 覆盖或 Tavily --days 参数进行时效性监控
• 多语言/区域用户：SerpAPI 支持 Baidu、Yandex 等非英文搜索引擎

常规风险提示

• API Key 需妥善保管，避免泄露至版本控制
• 注意各引擎免费额度消耗，建议监控用量防止意外超额
• 域名过滤在 Serper/SerpAPI 上通过 site: 操作符实现，效果与原生过滤存在差异
• 内容提取功能受目标网站反爬策略影响，不保证 100% 成功率

核心用法

Web Search Pro 是面向 AI Agent 的专业级多引擎搜索工具，作为 OpenClaw 内置搜索（Brave/Perplexity）的精细化补充，提供域名过滤、深度搜索、新闻模式、日期范围和内容提取等高级功能。用户配置一个或多个 API Key 后，系统根据查询类型自动选择最优引擎：默认优先 Tavily（AI优化、最佳答案质量），深度搜索模式启用 Tavily/Exa，新闻搜索优先 Serper（Google News 覆盖最广），百度/Yandex 等则路由至 SerpAPI。

基础用法极简，一行命令即可完成智能搜索：node {baseDir}/scripts/search.mjs "query"。进阶功能包括：强制指定引擎（--engine tavily）、域名白名单/黑名单过滤（--include-domains/--exclude-domains）、绝对/相对日期范围（--from/--to 或 --time-range week）、深度研究模式（--deep）、新闻限定搜索（--news --days 7），以及 URL 内容提取（extract.mjs）。输出默认为 Markdown 格式便于 AI 消费，--json 参数支持程序化调用。

显著优点

引擎生态丰富：覆盖四大主流搜索 API，Tavily（AI优化、1000次/月免费）、Exa（语义/神经搜索、$10额度）、Serper（真实 Google SERP、100次/月）、SerpAPI（多引擎支持、250次/月），满足不同场景的成本-质量权衡。

智能路由降低决策成本：无需手动比较引擎特性，系统根据 --deep、--news、--include-domains 等参数自动选择最优引擎，兼顾结果质量与功能可用性。

企业级过滤能力：原生支持域名级白名单/黑名单（Tavily/Exa 原生实现，Serper/SerpAPI 通过 site: 运算符模拟），支持绝对日期范围与相对时间窗口（day/week/month/year），这是大多数内置搜索不具备的精细化控制。

零依赖轻量实现：纯 Node.js 编写，零第三方依赖，仅使用原生 fetch API，消除供应链攻击风险，部署简单。

潜在缺点与局限性

API Key 配置门槛：必须至少配置一个 API Key 才能使用，推荐 Tavily 作为主要入口。多引擎场景下用户需管理 1-4 个不同服务商的账户，增加初期配置复杂度。

功能与引擎强绑定：部分高级功能仅限特定引擎：--deep 仅 Tavily/Exa 支持，--days 仅 Tavily 新闻模式支持，百度/Yandex 仅 SerpAPI 支持。若目标引擎 Key 缺失，命令直接报错退出，无降级 fallback。

成本与额度管理：免费额度有限（Tavily 1000/月、Serper 100/月、SerpAPI 250/月），深度搜索模式消耗更多积分（Tavily 2x）。高频使用场景需密切关注用量，避免服务中断。

来源可信度一般：来自 GitHub 个人开发者账号（zjianru），T3 级别，仓库 2026-03-14 发布较新，长期维护稳定性有待观察。

适合人群

• 需要超越基础搜索的 AI Agent 开发者与研究型用户
• 对搜索结果有域名限定、时间范围、新闻专项等精细化需求的场景
• 希望灵活切换多家搜索 API 以优化成本/质量比的技术团队
• 能接受 API Key 管理开销，追求功能完备性的专业用户

常规风险

1. API Key 泄露风险：Key 存储于环境变量，需避免提交至版本控制或在命令行历史中暴露，建议统一存放于 ~/.openclaw/.env。
2. 查询隐私暴露：用户搜索内容发送至第三方 API（Tavily/Exa/Serper/SerpAPI），虽经 HTTPS 加密，但敏感信息不应出现在搜索词中。
3. 外部服务依赖：4 家上游 API 的可用性、定价策略变更直接影响 Skill 功能，建议关注服务状态并考虑本地缓存策略。