bb-browser

BadBoy Browser

你的浏览器即 API。无需密钥。无需机器人。无需爬虫。

English · 中文

---

你已经登录了 Twitter、Reddit、YouTube、知乎、Bilibili、LinkedIn、GitHub——bb-browser 让 AI Agent 可以直接使用这些登录状态。

bb-browser site twitter/search "AI agent"       # 搜索推文
bb-browser site zhihu/hot                        # 知乎热榜
bb-browser site arxiv/search "transformer"       # 搜索论文
bb-browser site eastmoney/stock "茅台"            # 实时股票行情
bb-browser site boss/search "AI engineer"        # 搜索职位
bb-browser site wikipedia/summary "Python"       # 维基百科摘要
bb-browser site youtube/transcript VIDEO_ID      # 获取视频全文转录
bb-browser site stackoverflow/search "async"     # 搜索 StackOverflow 问题

涵盖 36 个平台的 103 条命令。 全部使用你真实浏览器的登录状态。完整列表 →

设计理念

互联网是为浏览器构建的。AI Agent 一直试图通过 API 访问它，但 99% 的网站并不提供 API。

bb-browser 颠覆了这一点：与其强迫网站提供机器接口，不如让机器直接使用人类接口。 该适配器在你的浏览器标签页中运行 eval，使用你的 Cookie 调用 fetch()，或者直接调用页面自身的 Webpack 模块。网站会认为操作者是你。因为，操作者确实就是你。

	Playwright / Selenium	爬虫库	bb-browser
浏览器	无头，隔离环境	无浏览器	你真实的 Chrome
登录状态	无，需重新登录	提取 Cookie	直接使用
反爬检测	易被检测	猫鼠游戏	不可见 — 它就是用户本人
复杂认证	难以模拟	需逆向工程	页面自行处理

快速上手

安装

npm install -g bb-browser

使用

bb-browser site update        # 拉取社区适配器
bb-browser site recommend     # 查看哪些适配器符合你的浏览习惯
bb-browser site zhihu/hot     # 开始使用

OpenClaw（无需插件）

如果你使用 OpenClaw，bb-browser 可以直接通过 OpenClaw 的内置浏览器运行——无需 Chrome 插件或守护进程：

bb-browser site reddit/hot --openclaw
bb-browser site xueqiu/hot-stock 5 --openclaw --jq '.items[] | {name, changePercent}'

ClawHub 技能：bb-browser-openclaw

Chrome 插件（独立模式）

若不使用 OpenClaw（例如用于 Claude Code MCP 或独立 CLI），请按以下步骤操作：

1. 从 Releases 下载
2. 解压 → 进入 chrome://extensions/ → 开启“开发者模式” → “加载已解压的扩展程序”

MCP (Claude Code / Cursor)

{
  "mcpServers": {
    "bb-browser": {
      "command": "npx",
      "args": ["-y", "bb-browser", "--mcp"]
    }
  }
}

36 个平台，103 条命令

由社区驱动，详见 bb-sites。每个命令对应一个 JS 文件。

分类	平台	命令
搜索	Google, Baidu, Bing, DuckDuckGo, Sogou WeChat	search
社交	Twitter/X, Reddit, Weibo, 小红书, 即刻, LinkedIn, 虎扑	search, feed, thread, user, notifications, hot
新闻	BBC, Reuters, 36kr, 头条, 东方财富	headlines, search, newsflash, hot
开发	GitHub, StackOverflow, HackerNews, CSDN, cnblogs, V2EX, Dev.to, npm, PyPI, arXiv	search, issues, repo, top, thread, package
视频	YouTube, Bilibili	search, video, transcript, popular, comments, feed
娱乐	豆瓣, IMDb, Genius, 起点	movie, search, top250
金融	雪球, 东方财富, Yahoo Finance	stock, hot stocks, feed, watchlist, search
招聘	BOSS 直聘, LinkedIn	search, detail, profile
知识	Wikipedia, 知乎, Open Library	search, summary, hot, question
购物	什么值得买	search deals
工具	有道, GSMArena, Product Hunt, 携程	translate, phone specs, trending products

10 分钟添加任何网站

bb-browser guide    # 完整教程

告诉你的 AI Agent：“将 XX 网站变成 CLI”。它会读取指南，通过 network --with-body 逆向 API，编写适配器，进行测试并提交 PR。一切均可自主完成。

适配器复杂程度分为三级：

等级	认证方式	示例	时间
1	Cookie (直接 fetch)	Reddit, GitHub, V2EX	~1 分钟
2	Bearer + CSRF Token	Twitter, 知乎	~3 分钟
3	Webpack 注入 / Pinia store	Twitter 搜索, 小红书	~10 分钟

我们对此进行了测试：20 个 AI Agent 运行了...