bb-browser

“互联网是为浏览器构建的，而不是为 API。”

这是 bb-browser 的核心理念。在 AI Agent 爆发的今天，99% 的网站没有公开 API，或者 API 权限受限。传统的爬虫方案（Playwright/Selenium）需要无头浏览器、复杂的 Cookie 维护，且极易被反爬系统识别。

bb-browser 彻底翻转了这个逻辑：不让网站适配机器，而是让机器直接使用人的界面。 它让你的 AI Agent 直接接管你已经登录的真实 Chrome 浏览器，利用你现有的 Cookie 和会话，以“真实用户”的身份访问任何网站。

核心优势：为什么它是 AI Agent 的终极武器？

极速体验：36 个平台，103+ 命令

无需写代码，只需一条命令，即可让 AI 获取结构化数据：

# 社交媒体
bb-browser site twitter/search "AI agent"       # 搜索推文 (带登录态)
bb-browser site zhihu/hot                        # 知乎热榜
bb-browser site reddit/hot                       # Reddit 热门
bb-browser site xiaohongshu/feed                 # 小红书推荐流

# 技术与学术
bb-browser site github/search "llm-framework"    # 搜 GitHub 仓库
bb-browser site arxiv/search "transformer"       # 搜论文
bb-browser site stackoverflow/search "async"     # 搜技术问答

# 财经与求职
bb-browser site eastmoney/stock "茅台"            # 实时股票行情
bb-browser site xueqiu/hot-stock 5               # 雪球热门股票
bb-browser site boss/search "AI 工程师"           # 搜职位

# 视频与百科
bb-browser site youtube/transcript VIDEO_ID      # 获取 YouTube 字幕全文
bb-browser site wikipedia/summary "Python"       # 维基百科摘要
bb-browser site bilibili/popular                 # B 站热门

输出即结构化 JSON，支持 --jq 进行内联过滤：

bb-browser site xueqiu/hot-stock 5 --jq '.items[] | {name, changePercent}'
# 输出: {"name":"云天化","changePercent":"2.08%"} ...

工作原理：Adapter 机制

bb-browser 不模拟浏览器，它注入到你的浏览器中。

1. Daemon 运行：在本地启动一个守护进程，监听你的 Chrome。
2. Extension 注入：通过 Chrome 扩展（或 OpenClaw 内置能力），获得 chrome.debugger (CDP) 权限。
3. Adapter 执行：针对每个网站编写的轻量级 JS 适配器（Adapter），直接在页面的上下文中运行 eval()。
   • 它可以调用页面内部的 fetch()（带着你的 Cookie）。
   • 它可以访问 Webpack 模块、Pinia/Vuex 状态树。
   • 网站完全感知不到机器存在，因为代码就是在“你”的浏览器里跑的。

🛠️ 快速开始

1. 安装 CLI

npm install -g bb-browser

2. 模式 A：OpenClaw 用户 (最简)

如果你使用 OpenClaw，无需安装扩展，直接利用其内置浏览器能力：

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

需安装 ClawHub Skill: bb-browser-openclaw

3. 模式 B：独立使用 / Claude Code / Cursor

需要安装 Chrome 扩展以建立连接：

1. 从 Releases 下载 zip 包。
2. Chrome 地址栏输入 chrome://extensions/ -> 开启“开发者模式”。
3. “加载已解压的扩展程序”，选择解压后的文件夹。
4. 启动 Daemon：

   bb-browser daemon
   

5. MCP 配置 (用于 Claude Code/Cursor)：

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

🤖 对 AI Agent 的意义：从“孤岛”到“全域”

没有 bb-browser，AI Agent 的能力边界仅限于：文件系统 + 终端 + 少数有 API Key 的服务。
有了 bb-browser，AI Agent 的能力边界 = 整个互联网。

场景示例：跨平台深度调研
告诉你的 Agent：“帮我调研 RAG (检索增强生成) 的最新动态。”
Agent 可在一分钟内自动执行：

1. bb-browser site arxiv/search "retrieval augmented generation" (最新论文)
2. bb-browser site twitter/search "RAG" (业界讨论)
3. bb-browser site github/search rag-framework (开源实现)
4. bb-browser site stackoverflow/search "RAG implementation" (实战问题)
5. bb-browser site zhihu/search "RAG" (中文社区观点)
6. bb-browser site 36kr/newsflash (行业新闻)

结果：六个维度、结构化数据、实时内容。比任何人类研究员都快、都广。

🛠️ 进阶：CLI 化任何网站 (10 分钟)

如果社区还没有你需要的网站适配器？没关系，让 AI 帮你写！

1. 运行 bb-browser guide 查看开发文档。
2. 告诉 AI Agent：“帮我把 XX 网站 CLI 化。”
3. Agent 会自动：
   • 使用 bb-browser network --with-body 抓包分析。
   • 逆向出关键的 API 端点或内部函数。
   • 编写 Adapter JS 文件。
   • 测试并生成 PR 提交到社区仓库 (bb-sites)。

边际成本趋近于零：实测 20 个 Agent 并发，可同时逆向 20 个不同网站。

📊 支持的适配器复杂度

🔒 安全与隐私

• 数据不出本地：所有处理都在你的本地浏览器完成，数据不经过第三方服务器。
• 权限可控：扩展仅在你运行命令时激活，平时处于休眠状态。
• 透明执行：你可以看到浏览器标签页的真实操作过程，随时可以人工干预。