bb-browser sites — 将网页变为命令行工具

支持 36 个平台，提供 103 个命令。利用你的当前登录状态，从任意网站提取结构化数据（单行命令即可完成）。

所有命令均需使用 --openclaw 参数，通过 OpenClaw 的浏览器执行。无需安装 Chrome 扩展或后台守护进程。

快速开始

# 首次使用：拉取社区适配器
bb-browser site update

# 查看当前可用的适配器
bb-browser site list

# 查看与你浏览习惯匹配的适配器推荐
bb-browser site recommend

# 通过 OpenClaw 浏览器运行任意适配器
bb-browser site reddit/hot --openclaw
bb-browser site hackernews/top 5 --openclaw
bb-browser site v2ex/hot --openclaw

重要提示：务必始终使用 --openclaw

每个 bb-browser site 命令都必须包含 --openclaw，以启用 OpenClaw 的浏览器执行模式：

# 正确用法
bb-browser site twitter/search "AI agent" --openclaw
bb-browser site zhihu/hot 10 --openclaw --json
bb-browser site xueqiu/hot-stock 5 --openclaw --jq '.items[] | {name, changePercent}'

# 错误用法（需额外安装 Chrome 扩展）
bb-browser site twitter/search "AI agent"

数据提取（最常用场景）

# 社交媒体
bb-browser site twitter/search "OpenClaw" --openclaw
bb-browser site twitter/thread  --openclaw
bb-browser site reddit/thread  --openclaw
bb-browser site weibo/hot --openclaw
bb-browser site xiaohongshu/search "query" --openclaw

# 开发者相关
bb-browser site github/repo owner/repo --openclaw
bb-browser site github/issues owner/repo --openclaw
bb-browser site hackernews/top 10 --openclaw
bb-browser site stackoverflow/search "async await" --openclaw
bb-browser site arxiv/search "transformer" --openclaw

# 金融
bb-browser site xueqiu/stock SH600519 --openclaw
bb-browser site xueqiu/hot-stock 5 --openclaw
bb-browser site eastmoney/stock "茅台" --openclaw

# 新闻与知识
bb-browser site zhihu/hot --openclaw
bb-browser site 36kr/newsflash --openclaw
bb-browser site wikipedia/summary "Python" --openclaw

# 视频
bb-browser site youtube/transcript VIDEO_ID --openclaw
bb-browser site bilibili/search "query" --openclaw

使用 --jq 进行结果过滤

使用 --jq 提取特定字段（无需显式指定 --json，该选项已隐式启用）：

# 仅获取股票名称
bb-browser site xueqiu/hot-stock 5 --openclaw --jq '.items[].name'

# 提取指定字段并组织为对象
bb-browser site xueqiu/hot-stock 5 --openclaw --jq '.items[] | {name, changePercent, heat}'

# 过滤 Reddit 热帖并只保留标题和评分
bb-browser site reddit/hot --openclaw --jq '.posts[] | {title, score}'

查看适配器详情

# 查看某适配器所需的参数
bb-browser site info xueqiu/stock

# 按关键词搜索适配器
bb-browser site search reddit

登录状态说明

适配器在 OpenClaw 的浏览器标签页中运行。若目标网站需要登录：

1. 适配器将返回类似如下错误：{"error": "HTTP 401", "hint": "Not logged in?"}
2. 在 OpenClaw 浏览器中打开该网站并手动登录：

   openclaw browser open https://twitter.com
   

3. 在弹出的浏览器窗口中完成登录操作
4. 重试原命令

创建新适配器

将任意网站封装为 CLI 命令：

# 阅读开发指南
bb-browser guide

# 或直接告诉我：“把 notion.so 封装成一个 bb-browser 适配器”
# 我将逆向分析其 API、编写适配器、测试并通过 PR 提交。

全部 36 个平台列表