bb-sites – 把网站变成 CLI 命令

bb-browser 的社区网站适配器 — 把网站变成 CLI 命令。

每个适配器是一个 JS 函数，通过 bb-browser eval 在你的浏览器里运行。浏览器已经登录了 — 不需要 API key，不需要偷 Cookie，不需要反爬。

95 个适配器，覆盖 35 个平台 — 持续增长中。

快速开始

# 安装/更新适配器
bb-browser site update

# 列出所有命令
bb-browser site list

# 运行命令
bb-browser site reddit/me

# 带参数运行
bb-browser site reddit/thread <url>

支持的平台

搜索引擎

新闻资讯

社交媒体

技术平台

开发工具

视频影音

求职招聘

财经股票

生活服务

知识百科

翻译旅游

社交社区

所有小红书适配器使用 Pinia Store Actions — 调用页面自己的 Vue store 函数，走完整的签名 + 拦截器链路。零逆向。

使用示例

搜索

bb-browser site google/search "bb-browser"
bb-browser site duckduckgo/search "Claude Code"

社交媒体

bb-browser site twitter/search "claude code"
bb-browser site twitter/tweets plantegg
bb-browser site reddit/thread https://reddit.com/r/programming/comments/...
bb-browser site weibo/hot

技术调研

bb-browser site github/repo epiral/bb-browser
bb-browser site hackernews/top 10
bb-browser site stackoverflow/search "python async await"
bb-browser site arxiv/search "large language model"
bb-browser site npm/search "react state management"

影音娱乐

bb-browser site youtube/transcript dQw4w9WgXcQ
bb-browser site bilibili/search 编程
bb-browser site douban/top250

财经股票

bb-browser site yahoo-finance/quote AAPL
bb-browser site eastmoney/stock 贵州茅台

求职

bb-browser site boss/search "AI agent"
bb-browser site linkedin/search "AI agent"

翻译

bb-browser site youdao/translate hello

开发适配器

运行 bb-browser guide 查看完整开发流程，或阅读 SKILL.md。

适配器模板

/* @meta
{
  "name": "platform/command",
  "description": "这个适配器做什么",
  "domain": "www.example.com",
  "args": {
    "query": {"required": true, "description": "搜索关键词"}
  },
  "readOnly": true,
  "example": "bb-browser site platform/command value1"
}
*/

async function(args) {
  if (!args.query) return {error: 'Missing argument: query'};
  const resp = await fetch('/api/search?q=' + encodeURIComponent(args.query), {credentials: 'include'});
  if (!resp.ok) return {error: 'HTTP ' + resp.status, hint: 'Not logged in?'};
  return await resp.json();
}

贡献方式

方式 A：使用 gh CLI

gh repo fork epiral/bb-sites --clone
cd bb-sites && git checkout -b feat-mysite
# 添加适配器文件
git push -u origin feat-mysite
gh pr create

方式 B：使用 bb-browser（不需要 gh）

bb-browser site github/fork epiral/bb-sites
git clone https://github.com/你的用户名/bb-sites && cd bb-sites
git checkout -b feat-mysite
# 添加适配器文件
git push -u origin feat-mysite
bb-browser site github/pr-create epiral/bb-sites --title "feat(mysite): 添加适配器" --head "你的用户名:feat-mysite"

私有适配器

私有适配器放在 ~/.bb-browser/sites/，同名时优先于社区适配器。

~/.bb-browser/
├── sites/ # 私有适配器（优先）
│   └── internal/
│       └── deploy.js
└── bb-sites/ # 本仓库（bb-browser site update）
    ├── reddit/
    ├── twitter/
    ├── github/
    ├── youtube/
    ├── bilibili/
    ├── zhihu/
    ├── weibo/
    ├── douban/
    ├── xiaohongshu/
    ├── google/
    ├── ... # 35 个平台目录
    └── qidian/

原文来源：https://github.com/epiral/bb-sites/blob/main/README.zh-CN.md