核心用法
browser-web-search 是一款专为 AI Agent 设计的跨平台内容搜索 CLI 工具，将 55 个主流平台（头条、知乎、豆瓣、YouTube、GitHub、Reddit、Hacker News 等）的搜索能力封装为统一命令行 API，支持 91+ 个细分命令。
关键特性：
- 零配置搜索：
bws site <平台>/<命令> "关键词" --count N - 登录态复用：通过 OpenClaw 浏览器自动化，自动继承用户已登录站点的会话权限，无需 API Key
- 结构化输出：原生 JSON 格式，支持
--jq过滤，直接适配 LLM 工具调用 - 跨域覆盖：30个国内平台（微信、小红书、B站、雪球等）+ 25个国际平台（X、LinkedIn、arXiv、npm 等）
典型场景：
- 热点追踪：
bws site zhihu/hot、bws site weibo/hot - 开发者资源：
bws site github/search "llm" --sort stars - 付费内容获取：微信公众号、小红书、豆瓣等需登录站点，登录后即可抓取私信、收藏、个人资料等账户保护内容
显著优点
1. AI 原生设计：输出格式专为 LLM 优化，减少传统爬虫的清洗成本
2. 权限复用机制：利用现有浏览器登录态，绕过平台反爬和 API 配额限制
3. 域名隔离安全：按 adapter 限定访问范围，无法跨站读取数据
4. 开源可审计：adapter 脚本开源，可独立审查执行逻辑
潜在局限与风险
| 风险点 | 说明 |
|--------|------|
| **第三方代码执行** | 核心功能依赖 npm 包 `browser-web-search`，该包在页面上下文中执行 JavaScript，具备访问 DOM 和认证数据的权限 |
| **供应链安全** | 需独立审计 npm 包源码与 GitHub 仓库一致性，发布版本与源码可能存在差异 |
| **账户安全风险** | 可读取私信、订单、收藏等敏感内容，恶意代码理论上可窃取 cookies 或页面数据 |
| **平台政策风险** | 自动化访问可能违反部分平台的 ToS，存在账号限制风险 |
| **Node.js 依赖** | 要求 >=18.0.0，需全局安装 npm 包 |
适合人群
- AI Agent 开发者：需要结构化数据源构建 RAG 或搜索增强应用
- 研究员/分析师：需跨平台聚合信息，追踪热点话题
- 自动化工作流用户：希望用命令行替代手动浏览，批量获取内容
常规风险管控建议
1. 安装前强制审计：对照 GitHub 源码审查 browser-web-search npm 包内容
2. 隔离运行环境：在专用浏览器 profile 中运行 OpenClaw，与日常浏览器分离
3. 敏感账户分级：避免在高价值账户（银行、企业邮箱）登录的浏览器中使用
4. 监控网络行为：使用工具监控 CLI 的网络请求，确认无意外数据外发
5. 版本锁定：严格使用 @0.4.3 固定版本，避免自动更新引入未审计代码