核心功能
web-search-pro 是一款专为 AI Agent 设计的多引擎精细化搜索工具，作为 OpenClaw 内置 web_search（Brave/Perplexity）的功能补充，提供了更专业的搜索控制能力。
支持的搜索引擎：
- Tavily（推荐）：AI 优化搜索，最佳答案质量，原生支持全参数过滤 + 内容提取，免费 1000 次/月
- Exa：语义/神经网络搜索，适合深度研究，$10 免费额度
- Serper：真实 Google SERP，新闻覆盖最广，免费 100 次/月
- SerpAPI：多引擎支持（Google/Bing/百度/Yandex/DuckDuckGo），中文搜索首选，免费 250 次/月
核心用法：
# 基础搜索（自动选引擎） node scripts/search.mjs "query" # 域名过滤：仅搜索 GitHub/Stack Overflow node scripts/search.mjs "query" --include-domains "github.com,stackoverflow.com" # 日期范围 + 深度搜索 node scripts/search.mjs "query" --from 2024-01-01 --to 2024-12-31 --deep # 新闻模式 node scripts/search.mjs "query" --news --days 7 # 内容提取 node scripts/extract.mjs "https://example.com/article"
显著优点：
1. 智能引擎选择：根据查询类型自动匹配最优引擎（深度搜索→Tavily/Exa、新闻→Serper、中文→百度）
2. 全参数控制：域名白名单/黑名单、绝对日期/相对时间范围、结果数量、国家/语言定位
3. 双模式输出：默认 Markdown 格式便于 AI 消费，--json 支持程序化调用
4. 内容提取：支持 Tavily Extract 和 Exa livecrawl，直接获取网页正文
潜在局限：
1. API 成本：深度搜索消耗更多额度（Tavily 2x 倍），高频使用需关注配额
2. 配置门槛：必须至少配置一个 API Key，国内用户获取 Tavily/Exa 可能需境外支付方式
3. 引擎差异：Serper/SerpAPI 的域名过滤通过 site: 操作符模拟，非原生支持，精准度略逊于 Tavily/Exa
4. 提取限制：内容提取仅支持 Tavily 和 Exa，Serper/SerpAPI 无法使用此功能
适合人群：
- 需要超越基础搜索的 AI 开发者（精准溯源、学术调研、竞品监控）
- 中文搜索场景用户（SerpAPI 百度支持）
- 需要域名白名单构建可信知识库的场景（如仅搜索 .edu/.gov 站点）
常规风险：
- API Key 泄露风险（需妥善保管环境变量）
- 搜索结果质量依赖第三方引擎，存在时效性偏差或信息茧房
- 深度搜索的高消耗可能导致免费额度快速耗尽