用途：当答案依赖训练数据之外的当前信息时使用，例如最新发布、当日新闻、某厂商截至本周的 API、库的真实用法、安全公告等。语法类已知问题或代码库内查找文件则不建议用它。
主要能力：支持在单个或多个搜索服务商间运行查询，输出可被 rg、jq 等管道处理的 JSON 文件。可用 --provider 指定单一服务商，--providers a,b,c 并行运行子集，--all 并行运行全部已配置服务商。配置 fallback 后可顺序回退，某个服务商报错或返回 0 结果时继续尝试下一个。结果保存到 <TMP_ROOT>/<run-id>/，默认 /tmp/web-search（macOS/Linux）。--print-path-only 只输出 combined.json 路径，--json 输出完整清单供 jq 使用，--no-preview 跳过人类预览。支持 --include 与 --exclude 做域名过滤，--max-results 限制每个服务商结果数。DuckDuckGo 与 MWMBL 无需密钥；其他服务商需要凭据。配置可放在 ~/.config/web-search/config.json、%APPDATA%\web-search\config.json、./web-search.json 或由 $WEBSEARCH_CONFIG 指向；也可设置对应环境变量。每个服务商支持 baseUrl 覆盖，用于自建代理、区域镜像或企业网关。无 Python 时可按 references/curl-recipes.md 直接调用。
用法：常用命令为 python3 scripts/web-search "<query>"。指定服务商示例：python3 scripts/web-search --provider tavily "<query>"。并行多服务商：python3 scripts/web-search --providers tavily,brave,perplexity "<query>" 或 --all。检查配置：python3 scripts/web-search --check 和 --list-providers。Windows 下需显式调用 python。
适用场景：需要核对时效信息、寻找真实示例、查阅权威参考或厂商近期公告时。限制：模型介导的服务商按调用和 token 计费，可设置 maxUses 或 max_tool_calls 限制循环；部分服务商提示词域名过滤有更严格上限；失败时原始响应保存为 <provider>-raw.json 以便排查；429 表示限流，可降低并行度或更换服务商。