web-search-plus

核心用法

web-search-plus 是一款统一搜索聚合技能，通过智能自动路由机制在 Serper（Google）、Tavily（研究）、Exa（神经）、You.com（RAG/实时）和 SearXNG（隐私/自托管）五大提供商之间自动选择。用户只需执行 python3 scripts/search.py -q "查询内容"，系统即通过多信号分析（意图分类、语言模式、URL/品牌识别）自动匹配最佳提供商，无需手动选择。

配置流程极简：运行交互式向导 python3 scripts/setup.py 或复制 config.example.json 手动配置，仅需一个 API 密钥即可启动。支持环境变量与本地 JSON 双模式存储，SearXNG 更提供完全免费的自托管选项。

显著优点

智能路由降低决策成本：购物查询自动导向 Serper 获取价格信息，研究问题路由至 Tavily 获取深度解释，相似性搜索触发 Exa 神经引擎，实时资讯调用 You.com，隐私需求无缝切换 SearXNG。

零依赖架构保障安全：仅使用 Python 标准库（urllib、json、pathlib 等），彻底消除第三方包供应链攻击风险。代码结构清晰，约 1000 行主脚本实现路由、缓存、提供商处理、输出格式化全链路。

弹性容错与成本控制：单点故障自动回退至备用提供商，免费额度叠加可达 4500+ 次/月（Serper 2500 + Tavily 1000 + Exa 1000），SearXNG 自托管实现零边际成本。

开发者友好设计：JSON 结构化输出含路由置信度评分，支持 --explain-routing 调试路由逻辑，-p provider 强制覆盖，30 秒超时防止资源耗尽，本地缓存（默认 1 小时 TTL）提升响应速度。

潜在缺点与局限性

路由误判可能性：模糊查询（如 "apple" 可能指水果或公司）可能导致路由偏差，需手动覆盖。多语言查询的意图识别准确度依赖训练信号质量。

提供商依赖风险：Serper/Tavily/Exa 非 OpenClaw 核心提供商，服务条款变更或 API 调整可能影响功能。免费额度耗尽后需付费或切换至 SearXNG。

SearXNG 自托管门槛：完全隐私需自行部署 Docker 实例（约 5 美元/月 VPS 成本），技术门槛高于托管服务。公共实例的隐私政策依赖运营方。

缓存隐私权衡：本地缓存提升性能但留存查询历史，敏感场景需定期 --clear-cache 或缩短 TTL。

适合的目标群体

• 全栈开发者：需要统一接口集成多源搜索，避免维护多个 SDK
• AI/LLM 应用构建者：RAG 场景需 Tavily/You.com 的上下文优化结果
• 隐私敏感用户：通过 SearXNG 实现零追踪搜索
• 初创团队/个人开发者：免费额度覆盖原型验证阶段，渐进式付费扩展
• 学术研究者：Exa 的论文语义搜索与 Tavily 的深度研究模式

使用风险

性能风险：网络超时（默认 30 秒）或提供商限流可能导致延迟，自动回退机制虽保障可用性但增加响应时间。建议生产环境配置多提供商冗余。

配置安全风险：config.json 默认 gitignored 但文件权限不当（非 600）可能导致 API 密钥泄露。建议优先使用环境变量，并设置严格文件权限。

数据残留风险：缓存目录（可自定义 WSP_CACHE_DIR）含搜索历史，共享环境需配置独立缓存路径或禁用缓存。

合规风险：向第三方搜索提供商传输查询内容需符合数据出境及隐私法规，企业用户应审查各提供商数据处理协议（DPA）。