bb-browser AI代理接管浏览器神器

一句话介绍： bb-browser 是一个让 AI代理（Agent）直接调用你真实浏览器、无需任何 API密钥的开源 CLI工具。你已登录的微博、知乎、GitHub、Twitter——AI 立刻就能用。

📦 bb-browser 是什么？

bb-browser（BadBoy Browser / “坏孩子浏览器”）是一个创新型浏览器自动化工具，核心理念是 “Your browser is the API”——你的浏览器本身就是 API。

它的核心逻辑是：互联网本就是为浏览器设计的，但 99% 的网站没有开放API。bb-browser 不做模拟，而是直接寄生在你已有的 Chrome 浏览器里，让 AI Agent 像真正的用户一样浏览、搜索、提取数据——无需 API Key，无需重新登录，无需对抗反爬虫。

核心定位

• 对 AI Agent：用你的身份接入了整个互联网，而不只是少数有开放 API 的网站。
• 对开发者：将任何网站转换为可被程序调度的“CLI 化”命令。
• 对普通用户：一个超强的浏览器自动化工具，支持点击、填表、eval、截图、网络抓包等全部能力。

🔧 技术原理：为什么网站看不出是 AI 在操作？

bb-browser 的架构分为三层：

AI Agent（Claude Code / Cursor 等）
    ↓ CLI 或 MCP 协议
bb-browser CLI ──HTTP──▶ 本地 Daemon（端口 19824）
    ↓ CDP WebSocket 连接
你的真实 Chrome 浏览器（已登录账号）
    ↓
目标网站（看到的就是一个真实登录用户）

架构示意图源自官方文档及社区分析。

关键突破在于 v0.11.0（2026年4月发布）彻底移除了 Chrome Extension 依赖，daemon 直接通过 CDP WebSocket 连接 Chrome，统一了 daemon / cdp-monitor / CLI 直连三条路径，安装复杂度大幅降低。

bb-browser 通过三层机制操作网页：

• eval：在页面上下文中执行任意 JavaScript；
• fetch：在页面内发起 HTTP 请求，自动携带当前域名的 Cookie、Session 和 CSRF Token；
• Accessibility Tree：通过 CDP 获取页面的无障碍树，提取可交互元素并编号。

对于目标网站而言，所有请求来自你的真实浏览器，带的是你的真实 Cookie 和指纹——它无法区分是 AI 在操作，还是你自己在操作。

🚀 快速开始（2026 最新版）

1. 安装 bb-browser

⚠️ 重要提示：不同安装方式对应不同的使用模式，请根据你的使用场景选择。

方式一：全局安装（推荐 CLI 方式）

# 安装
npm install -g bb-browser

# 验证版本
bb-browser --version

# 拉取社区适配器（首次务必执行）
bb-browser site update

方式二：MCP 模式（Claude Code / Cursor）

在 MCP 配置文件中添加：

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

2. 连接 Chrome 浏览器

如果使用 v0.11.0 及以上版本（推荐）： daemon 直接通过 CDP WebSocket 连接 Chrome，无需安装扩展。

# 启动 daemon（保持运行）
bb-browser daemon

# 在另一终端测试连接
curl localhost:19824/status

如果使用旧版本或特定场景： 从 Releases 下载扩展，在 chrome://extensions/ 打开开发者模式，加载解压后的扩展文件夹。

3. 执行第一个命令

# 获取知乎热榜
bb-browser site zhihu/hot

# 搜索 Twitter
bb-browser site twitter/search "AI agent"

# 搜索 arXiv 论文
bb-browser site arxiv/search "transformer"

# 东方财富股票行情
bb-browser site eastmoney/stock "茅台"

# BOSS 直聘职位搜索
bb-browser site boss/search "AI 工程师"

📋 完整使用教程

基础命令大全

# 社区适配器管理
bb-browser site update         # 拉取最新社区适配器
bb-browser site recommend      # 根据浏览习惯推荐适配器

# 社交媒体
bb-browser site twitter/search "关键词"   # 搜索推文
bb-browser site twitter/trending          # 推特趋势
bb-browser site zhihu/hot                 # 知乎热榜
bb-browser site reddit/hot                # Reddit 热门
bb-browser site weibo/search "关键词"     # 微博搜索
bb-browser site xiaohongshu/search "关键词" # 小红书搜索

# 技术资源
bb-browser site github/search "关键词"     # GitHub 仓库搜索
bb-browser site arxiv/search "关键词"      # arXiv 论文搜索
bb-browser site stackoverflow/search "关键词" # Stack Overflow 问答
bb-browser site npm/search "包名"          # npm 包搜索
bb-browser site pypi/search "包名"         # PyPI 搜索

# 视频平台
bb-browser site youtube/search "关键词"    # YouTube 视频搜索
bb-browser site youtube/transcript VIDEO_ID # 获取视频字幕全文
bb-browser site bilibili/search "关键词"   # B站视频搜索

# 财经资讯
bb-browser site eastmoney/stock "股票代码/名称"  # 实时股票行情
bb-browser site xueqiu/hot-stock N         # 雪球热股榜（N为条数）

# 知识百科
bb-browser site wikipedia/summary "关键词"  # 维基百科摘要
bb-browser site youdao/translate "文本"     # 有道翻译

浏览器通用操作

bb-browser open https://example.com          # 打开网页
bb-browser snapshot -i                       # 获取页面可访问树快照
bb-browser click "选择器"                    # 点击元素
bb-browser fill-form "选择器" "内容"         # 填充表单
bb-browser eval "document.title"             # 执行自定义 JavaScript
bb-browser fetch URL --json                  # 带 Cookie 认证的请求
bb-browser screenshot                        # 页面截图
bb-browser network requests --with-body --json # 抓取网络请求（支持 Body）

结合 OpenClaw 使用（无需扩展）

如果你使用 OpenClaw，bb-browser 可直接通过其内置浏览器运行：

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

📊 支持平台与命令（截至 2026-05）

bb-browser 由社区通过 bb-sites 仓库维护，当前覆盖 36 个平台、103 条命令，每个命令对应一个独立的 JavaScript 适配器文件。

完整列表可查阅 bb-sites 仓库。

⚖️ 与主流方案对比

对比数据综合自 GitHub README 及多篇社区评测。

社区评测也指出，在浏览器自动化操作上（如点击、填表），bb-browser 目前还不如 Playwright 成熟，稳定性有提升空间。但在 Site Adapter（获取结构化数据） 领域，bb-browser 是当前最务实的选择。

✨ 高级玩法：创建自定义 Site Adapter

对于 bb-sites 尚未覆盖的网站，可以让你手头的 AI Agent 帮你写一个适配器。

每个适配器就是一个 JavaScript 文件，放在 ~/.bb-browser/bb-sites/ 对应目录下，结构如下：

/* @meta {
  "name": "baidu-pan/list",
  "description": "获取百度网盘文件列表",
  "domain": "pan.baidu.com",
  "args": {
    "path": { "required": false, "description": "目录路径" }
  },
  "capabilities": ["network"],
  "readOnly": true
} */

async function(args) {
  const response = await fetch('/api/list?path=' + (args.path || '/'));
  const data = await response.json();
  return data.list || [];
}

适配器按认证复杂度分三档：

🔒 安全建议与注意事项

权限控制

bb-browser 会获得你完整浏览器的控制权，建议：

• 使用独立的浏览器 Profile：为 bb-browser 创建一个单独的 Chrome 用户配置，不要与日常浏览混用。
• 只在可信环境中运行：确认 daemon 端口（默认 19824）未对外暴露。

账号安全

• bb-browser 不在任何服务器存储你的 Cookie 或登录态——所有操作均在本地完成。
• 但请注意：AI Agent 获得浏览器控制权后，理论上可以代表你执行任何操作（发帖、删帖、购买等）。建议为 AI 操作设置明确的权限边界，避免误操作。

合规性

• 使用 bb-browser 访问网站时，网站认为是你本人在操作，不涉及绕过反爬的合规争议。
• 但如果用于批量抓取数据，仍需遵守目标网站的 robots.txt 及服务条款。
• 商业用途请评估所在地区相关法律要求。

💡 最佳实践建议

适合使用的场景

✅ 跨平台信息搜集与调研：一分钟内同时查询 arXiv 论文、GitHub 仓库、Twitter 讨论、知乎热榜——比任何人类研究员都快都广。

✅ 需要登录态才能访问的数据获取：微信公众号后台、B站收藏夹、微博私信界面、LinkedIn 关系网络等。

✅ 没有开放 API 但又需要自动化的业务操作：百度网盘文件管理、企业内网系统等封闭平台。

✅ 舆情监控与内容聚合：自动抓取多个社交媒体平台的热点话题和讨论趋势。

✅ 金融数据实时查询：雪球、东方财富等多渠道实时行情。

不太适合的场景

❌ 需要复杂交互的端到端自动化流程（如多步表单提交、购物车结算等），目前稳定性有待提升。

❌ 高并发、海量请求的场景（bb-browser 设计为轻量级 CLI，更适合中小规模任务）。

性能优化建议

• 善用 --json 和 --jq 过滤：直接获取结构化数据，避免处理冗余信息。
• 多标签并发查询：对不同平台的操作可在不同标签页中并发执行。
• 增量查询：v0.11.0 及以上版本支持 --since last_action 增量事件查询，避免每次拿全量数据。

📚 资源链接

bb-browser 的开源路线（MIT 协议）和活跃的社区生态（定期更新、110+ 测试用例、PR 门禁）决定了它的持续发展潜力。无论你是开发者、数据分析师，还是 AI Agent 的重度使用者，这个工具都值得被放进你的工具箱——因为它回答了一个 AI 时代的根本问题：AI 到底该如何像人一样使用互联网？