前言¶
做 Agent 或自动化调研时，常见做法是各自对接站点开放 API，或手写爬虫维护 Cookie。国内很多内容站没有稳定、免费的 API，登录态又往往绑在浏览器里，Agent 很难直接复用。Browser Web Search 把多平台搜索收成统一 CLI，在 OpenClaw 已打开的浏览器标签页里执行适配脚本，结果以 JSON 返回，便于工具调用与后续分析。
这是什么¶
Browser Web Search（SkillHub 坐标 @user_2c495456/browser-web-search）是社区来源（community）的 Agent Skill，当前页面标注版本 1.3.3，分类为 data-analysis，由 user_2c495456（SkillHub 页面显示作者为 PingAI 品智）发布。标签标明 requires_api_key=false。
官方简介：一行命令搜遍全网 — 55 个平台、91+ 个命令，覆盖头条、知乎、豆瓣、YouTube、GitHub、Reddit、Hacker News 等；专为 OpenClaw 设计，复用浏览器登录态，返回结构化 JSON，面向 AI Agent 工具调用。
Skill 本体遵循通用 SKILL.md 格式；关联仓库为 browser-web-search-skill，底层通过 npm 包 browser-web-search 提供 bws 命令，并在 OpenClaw 控制的浏览器中访问目标站点。
核心功能¶
以下能力均来自 SkillHub 页面简介及公开 SKILL.md 说明，可与官方描述交叉核对。
- 统一命令面：用
bws site <平台>/<子命令>访问多站点能力（如搜索、热榜、Feed 等），可用bws site list查看全部命令。 - 结构化输出：默认 JSON；支持
--jq做字段过滤，方便 Agent 解析。 - 复用登录态：通过 OpenClaw 在已认证浏览器标签页中执行 JavaScript（按 adapter 域名隔离），无需为每个站单独配置 API Key；敏感能力另有环境变量与确认开关（见下文注意项）。
- 平台规模：文档写明内置 55 个平台、91+ 条命令，国内含今日头条、知乎、B 站、微博、豆瓣等，国际含 Google、GitHub、Hacker News、Reddit、YouTube 等。
SkillHub 页面统计（以抓取资料为准）：评分 100000，下载 4909，安装 48。
安装与启用¶
安装分两步：先把 Skill 装进当前 Agent 的 skills 目录，再安装 bws 运行时（Skill 文档要求 Node.js >= 18）。
1. 安装 SkillHub CLI（若尚未安装）¶
按 SkillHub 安装说明 检查或安装 CLI：
command -v skillhub && skillhub --version
未安装时可执行完整安装脚本（需联网）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
2. 安装 Browser Web Search Skill¶
必须用 --dir 指向当前 Agent 识别的 skills 目录，否则默认落在 ./skills/ 可能不会被加载。常见路径示例：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或项目下.agents/skills/
安装命令：
skillhub install @user_2c495456/browser-web-search --dir <你的 skills 目录>
也可让 AI 按 SkillHub 页面提示，参照 https://skillhub.cn/install/skillhub.md 完成同一坐标安装。
3. 安装 bws CLI¶
Skill 元数据中的安装步骤为全局安装固定版本的 npm 包（安装前文档建议审计源码与发布一致性）：
npm install -g browser-web-search@0.4.3
验证：
bws --version
bws site list
OpenClaw 环境需已具备 openclaw CLI，供浏览器自动化使用。具体 Gateway / 浏览器连接方式以你本地的 OpenClaw 文档为准；本 Skill 不替代 OpenClaw 本身的部署。
典型用法¶
下列示例来自公开 SKILL.md 的快速开始，可在装好 bws 且 OpenClaw 浏览器可用后复现。
查看全部站点与子命令：
bws site list
多平台搜索示例：
bws site toutiao/search "ai search"
bws site zhihu/search "ai agent" --count 5
bws site hn/search "llm" --sort date
bws site github/search "ai search" --sort stars
bws site reddit/search "ai search" --sort new
bws site youtube/search "ai agent tutorial"
用 jq 风格过滤（--jq）缩小返回字段，例如只取知乎结果 URL 列表时，可按文档在对应命令后追加 --jq 表达式。
架构上，Agent 读取 Skill 指令 → Skill 包装层调用 bws → OpenClaw 驱动浏览器访问目标站 → 返回 JSON 给 Agent。
适用场景与注意¶
适合谁
- 已在用 OpenClaw（或兼容其 skills 目录的变体），需要 Agent 拉取知乎、GitHub、HN 等多源信息并做竞品、舆情或技术调研。
- 希望输出已是 JSON，减少 HTML 解析与各站 API 申请成本的数据分析 / 抓取类工作流。
限制与风险（务必阅读 Skill 元数据）
- 第三方 npm 包：实际页面脚本由
browser-web-search在浏览器上下文执行，Skill 文档将其标为需审批的中等安装风险；使用前建议审查 GitHub 仓库 与 npm 发布版本。 - 敏感能力门禁：默认敏感档（需登录的个人数据等）有多层环境变量与 CLI 开关，例如
BWS_PUBLIC_ONLY、BWS_ENABLE_SENSITIVE_TIER、BWS_ALLOW_SENSITIVE、--i-understand-sensitive、--accept-platform-consent等；未显式放开时不应假设能访问私信、收藏等账户页。 - 版本线：SkillHub 展示 Skill 版本 1.3.3，与 npm 包文档中 pin 的 0.4.3 属于不同坐标；升级时分别关注 SkillHub 与
browser-web-search的变更说明。 - 合规：各平台服务条款、 robots 与数据使用政策由使用者自行遵守；Skill 提供技术能力，不保证站点长期可用性。
结尾¶
Browser Web Search 把多平台搜索收敛为 bws site … 与 JSON 输出，并依托 OpenClaw 复用浏览器登录态，适合需要「Agent 可调用的全网检索」而非单站 API 集成的场景。安装与详情以 SkillHub 为准：
