核心功能与定位
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% 成功率