前言¶

Agent 要完成调研、查文档、抓站点这类任务时，通常有两条路：要么自己写脚本调搜索接口，要么让模型”凭记忆”回答。前者要处理 API key、限流、多来源聚合，后者在时效性上必然失真。Web Search Pro 想做第三条路：把搜索、抓取、站点地图、深度调研打包成一个 Node 运行时 Skill，基线无需任何 API key 就能跑通第一次成功搜索，之后按需接付费 provider 提升覆盖率。

这是什么¶

Web Search Pro 是发布者 zjianru 在 ClawHub（OpenClaw 生态）上架的代码后端 Skill，坐标 @clawhub_zjianru/web-search-pro，当前版本 2.1.4，协议 MIT-0。上游仓库为 https://clawhub.ai/zjianru/web-search-pro ，SkillHub 页面地址为 https://api.skillhub.cn/user_eba395de/web-search-pro 。

定位是 Agent-first 的网页搜索与检索：支持实时网页搜索、新闻搜索、文档查询、代码查询、公司调研、网站爬取、网站地图，以及结构化证据包。它不是纯指令包（instruction-only），而是带 Node 运行时代码的 skill pack，脚本在本地执行，搜索结果以 JSON 返回给模型。

核心功能¶

下面列出的能力均来自官方页面与 SKILL.md 说明。

1、无 key 基线：首次运行不需要任何 API key。基线搜索走 ddg（尽力而为的无 key 搜索），页面提取、爬取、站点地图走内置 fetch 回退；出站请求优先使用 curl，不可用时回落到 Node 内置 fetch。

2、多 provider 联邦搜索：可按需接入 Tavily、Exa、Querit、Serper、Brave、SerpAPI、You.com、SearXNG，以及 Perplexity / Sonar（经 Perplexity 官方 API、OpenRouter 或兼容 OpenAI 的自定义网关）。联邦的价值不只是”多一个来源”，而是返回紧凑的收益指标，让 Agent 看到 fanout 实际带来了什么：

{
  "federated": {
    "providersUsed": ["..."],
    "value": {
      "additionalProvidersUsed": 2,
      "resultsRecoveredByFanout": 5,
      "resultsCorroboratedByFanout": 3,
      "duplicateSavings": 7
    }
  }
}

3、按任务分命令：search.mjs（搜索）、extract.mjs（单页提取）、crawl.mjs（站点爬取）、map.mjs（站点地图）、research.mjs（深度调研）、doctor.mjs 与 bootstrap.mjs（环境检查与初始化）、capabilities.mjs、review.mjs、cache.mjs、health.mjs。

4、可解释路由：每次搜索返回 selectedProvider、routingSummary（含置信度与联邦摘要）。加 --explain-routing 或 --plan 可拿到完整的 routing.diagnostics，以及面向模型的 topicType、topicSignals、researchAxes 结构化规划字段。

5、缓存与本地状态：本地状态目录为 .cache/web-search-pro，返回 cached / cache 字段供 Agent 判断命中与 TTL。

安装与启用¶

通过 ClawHub 的 OpenClaw CLI 安装，命令如下：

openclaw skills install @zjianru/web-search-pro

唯一硬性运行时要求是 Node.js。基线路径没有远程安装器、curl-to-shell 引导或 Python 辅助传输。

可选配置文件（不是必需项）通过环境变量指向：

{
  "env": {
    "WEB_SEARCH_PRO_CONFIG": "./config.json"
  }
}

接入付费 provider 时按需导出对应凭据即可，基线不受影响。下面给出 Perplexity / Sonar 几种接入方式的变量示例：

# 官方 API
PERPLEXITY_API_KEY=xxxxx
# 或经 OpenRouter
OPENROUTER_API_KEY=xxxxx
OPENROUTER_BASE_URL=https://openrouter.ai/api/v1
KILOCODE_API_KEY=xxxxx
# 或自定义 OpenAI 兼容网关
PERPLEXITY_GATEWAY_API_KEY=xxxxx
PERPLEXITY_BASE_URL=https://gateway.example.com/v1
PERPLEXITY_MODEL=perplexity/sonar-pro

其余 provider 对应 TAVILY_API_KEY、EXA_API_KEY、QUERIT_API_KEY、SERPER_API_KEY、BRAVE_API_KEY、SERPAPI_API_KEY、YOU_API_KEY、SEARXNG_INSTANCE_URL。

说明：官方资料只给出了 OpenClaw CLI 的安装方式。Cursor、Codex CLI、Claude Code 等其他环境是否支持，未见官方说明，这里不做推断。

典型用法¶

以下示例均来自官方 SKILL.md，可直接复现。脚本路径统一写作 {baseDir}/scripts/...，安装后替换为实际目录。

最短成功路径分两步：先做环境检查与初始化，再跑第一次搜索。

node {baseDir}/scripts/doctor.mjs --json
node {baseDir}/scripts/bootstrap.mjs --json
node {baseDir}/scripts/search.mjs "OpenAI Responses API docs" --json

如果只想先接一个付费 provider，官方建议从 Tavily 开始：

export TAVILY_API_KEY=tvly-xxxxx
node {baseDir}/scripts/doctor.mjs --json
node {baseDir}/scripts/search.mjs "latest OpenAI news" --type news --json

常规搜索的几个变体：

node {baseDir}/scripts/search.mjs "OpenClaw web search" --json
node {baseDir}/scripts/search.mjs "OpenAI Responses API docs" --preset docs --plan --json
node {baseDir}/scripts/extract.mjs "https://platform.openai.com/docs" --json

文档、新闻与调研的进阶用法：

node {baseDir}/scripts/search.mjs "OpenAI Responses API docs" --preset docs --json
node {baseDir}/scripts/search.mjs "latest OpenAI news" --type news --json
node {baseDir}/scripts/research.mjs "OpenClaw search skill landscape" --plan --json

诊断与自检：

node {baseDir}/scripts/capabilities.mjs --json
node {baseDir}/scripts/review.mjs --json
node {baseDir}/scripts/health.mjs

适用场景与注意¶

适合这几类调用者：需要实时网页或新闻搜索的 Agent；需要文档、API 文档、代码检索的 Agent；需要在搜索之后继续做提取、爬取、站点地图或深度调研的 Agent；需要可解释路由与可见联邦收益指标的 Agent；以及第一次运行不想配任何 key 的场景。

需要注意的几点：

1、基线搜索的 ddg 是”尽力而为”，结果质量和稳定性不及付费 provider；需要高覆盖率或回答型（answer-first）路由时，至少接入一个付费 provider。

2、Skill 页面给出的搜索关键词提示（web search、docs search、company research、site crawl 等）用于描述意图匹配，不是额外功能承诺。

3、本地缓存目录会随使用增长，长期跑批任务建议关注 cache.mjs 与 health.mjs 的输出。

4、官方 SkillHub 页面显示该 Skill 分类为 data-analysis，标签为 requires_api_key=false，与”无 key 基线”的设计一致。

5、网页抓取要注意目标站点的服务条款与 robots 约定，Skill 本身不承担合规判断。

结尾¶

Web Search Pro 的价值在于把”搜索 + 提取 + 爬取 + 站点地图 + 调研”收敛到一个无 key 起步、可逐步升级 provider 的 Node 运行时包里，路由过程对 Agent 可见。如果你的场景是让 Agent 做联网检索与资料收集，可以从无 key 基线跑通后再按需加 provider。

官方地址：https://api.skillhub.cn/user_eba395de/web-search-pro
上游仓库：https://clawhub.ai/zjianru/web-search-pro