前言¶
做 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 爲準：
