Zero-API-Key Web Search for OpenClaw

此技能为 OpenClaw 提供实用的验证工作流：

• zero-search：获取实时搜索结果（通过 Bright Data 调用 7 个引擎）
• zero-search providers：查看可用提供者列表
• zero-browse：读取网页内容（自动解锁被屏蔽的内容）
• zero-verify：对声明进行支持/冲突分类
• zero-report：生成带引用的摘要报告，并附上下一步建议
• zero-setup：交互式提供者配置工具

安装

pip install zero-api-key-web-search

最小化验证流程

zero-search "OpenAI API 定价" --type news --timelimit w
zero-search providers
zero-browse "https://docs.python.org/3/whatsnew/"
zero-verify "Python 3.13 是最新的稳定版本" --deep --max-pages 2 --json
zero-report "Python 3.13 稳定版发布" --claim "Python 3.13 是最新的稳定版本" --deep --json

提供者路径配置

推荐使用流程

1. 对事实性或近期问题，运行 zero-search 获取搜索结果。
2. 当摘要信息不足时，使用 zero-browse 读取最相关网页。
3. 当需要判断某个具体声明是否成立时，使用 zero-verify 进行支持/冲突分析。
4. 当希望生成一份包含引用和后续步骤的紧凑证据包时，使用 zero-report。
5. 若声明重要性较高，建议使用 --deep 参数进行页面级深度验证。
6. 在最终回答中引用返回的网址。
7. brightdata 为可选提供者，仅在已配置或明确请求时使用。

多引擎搜索（Bright Data）

zero-search "人工智能监管" --provider brightdata --engine google --region us-en --json
zero-search "人工智能监管" --provider brightdata --engine bing --region gb-en --json
zero-search "新闻" --provider brightdata --engine yandex --region ru-ru --json

支持的引擎：google, bing, duckduckgo, yandex, baidu, yahoo, naver。

Web Unlocker（解锁被屏蔽页面）

# 自动降级（默认行为）——先尝试直接获取，若遇 403/429 错误则调用解锁器
zero-browse "https://protected-site.com/article"

# 强制使用 Web Unlocker
zero-browse "https://protected-site.com/article" --use-unlocker always

可选的 Bright Data 提供者配置

# 启动交互式设置向导
zero-setup

# 或手动设置环境变量
export ZERO_SEARCH_BRIGHTDATA_API_KEY="..."
export ZERO_SEARCH_BRIGHTDATA_ZONE="serp_api1"
export ZERO_SEARCH_BRIGHTDATA_UNLOCKER_ZONE="web_unlocker1"

新用户可前往 https://get.brightdata.com/h21j9xz4uxgd 注册 Bright Data 账号。

成功的标准表现

• 判定结论清晰明确
• 结果包含支持与冲突评分
• page_aware 字段为 true 表示执行了深度验证
• 推荐的免费路径为 ddgs + 自建 searxng
• 可选的生产路径为 brightdata + web_unlocker，需通过 ZERO_SEARCH_BRIGHTDATA_API_KEY 配置
• 返回的源链接可直接用于引用

使用限制

• zero-verify 为启发式判断且基于证据，非形式化证明引擎。
• 默认提供者路径为 ddgs。
• 推荐的免费升级路径为自建 searxng，通过 ZERO_SEARCH_SEARXNG_URL 配置。
• Bright Data 为可选组件，未配置或未明确请求前不应发送查询。
• 冲突来源会被识别并列出，但不会自动合并或解决。

许可证

MIT License