基于 CDP 的 CLI + MCP Server,让 AI 代理复用用户真实 Chrome 登录态控制浏览器,支持 36 个平台社区适配器。
bb-browser 是一个面向 AI 代理的浏览器控制工具,通过 Chrome DevTools Protocol (CDP) WebSocket 连接用户本地已登录的 Chrome 浏览器,完整复用 Cookie 和登录态,无需额外认证。它同时提供 CLI 独立使用与 MCP Server 两种模式,可被 Claude Code、Cursor 等 AI IDE 直接调用。
核心特性包括:通用浏览器自动化命令(open、snapshot、click、fill、eval、fetch、network、screenshot)、社区驱动的站点适配器系统 bb-sites(已覆盖 36 个平台、103 条命令,采用三级复杂度模型便于贡献)、JSON 输出与 jq 内联过滤、多标签页并发操作、Daemon 后台守护进程模式,以及 OpenClaw 集成支持。
适配器系统采用三级复杂度模型:Tier 1 为 Cookie fetch(如 Reddit、GitHub,约 1 分钟编写);Tier 2 为 Bearer + CSRF token(如 Twitter、知乎,约 3 分钟);Tier 3 为 Webpack 注入 / Pinia store(如 Twitter 搜索、小红书,约 10 分钟)。
典型应用场景涵盖跨平台信息聚合研究(arXiv、Twitter、GitHub、知乎等)、实时金融数据获取(雪球、东方财富)、社交媒体监控、视频内容提取(YouTube、Bilibili 字幕/转录)、招聘信息搜索,以及作为通用浏览器自动化测试工具。
项目基于 TypeScript 构建,采用 pnpm monorepo(Turborepo)管理,运行需要 Node.js ≥ 18 和 Chrome 浏览器。
安装与使用:
npm install -g bb-browser
bb-browser site update
bb-browser site zhihu/hot
bb-browser site twitter/search "AI agent"
MCP 集成:
{
"mcpServers": {
"bb-browser": {
"command": "npx",
"args": ["-y", "bb-browser", "--mcp"]
}
}
}
待确认信息:作者/团队背景(package.json 中 author 为空)、独立官网(未发现)、Chrome 扩展安装方式(README 未详述)、OpenClaw 集成细节、PRIVACY.md 内容、LICENSE 年份标注为 2026(可能为笔误)、通用浏览器命令的完整调用语法、Daemon 与 Chrome 扩展的启动优先级关系。