bb-browser-你的浏览器就是 API（不需要密钥，不需要爬虫，不需要模拟）

1、前言

做过网页自动化、AI Agent 开发的人，大多都有过这样的经历：用 Selenium/Playwright 写的脚本，好不容易搞定了登录，却被网站的反爬机制频繁拦截；想调用某平台的功能，翻遍全网找不到 API，只能硬着头皮逆向爬虫；就算拿到了 Cookie，也扛不住网站频繁更新的鉴权逻辑，脚本说崩就崩。

这些痛点的根源，都指向同一个问题：我们一直在试图让“机器”去模仿“人”的操作，却始终隔着一层环境壁垒。而bb-browser 给出了一个更直接的答案：既然网站信任真实用户的浏览器，那就让机器直接在你的真实浏览器里工作。

它不需要你重新搭建环境、不需要你手动维护 Cookie、更不需要你去和反爬系统玩猫鼠游戏——所有的鉴权、会话、环境都由你正在使用的 Chrome 原生处理，AI Agent 只是借你的浏览器，完成你自己也能完成的操作。

2、简介

该工具核心理念为 Your browser is the API（你的浏览器即是接口），无需网站官方API、无需额外登录，直接复用你本地已登录的 Chrome 浏览器状态，让 AI 智能体操控真实浏览器进行各类操作。

核心形态：集成 CLI 命令行工具 + MCP 服务端，还配套可选 Chrome 扩展 / 后台进程。

核心优势：沿用浏览器现有 Cookie、登录态，规避网站反爬、复杂授权流程，行为和真人操作一致，不易被风控拦截。

架构：

Github地址：

https://github.com/epiral/bb-browser

3、安装

1、全局安装依赖Node.js 18+（推荐 20.x）环境，命令如下：

npm install -g bb-browser

也可通过 npx 直接调用，或接入 MCP 客户端完成配置联动。

2、拉取社区站点适配器（关键）

bb-browser site update

这一步会下载知乎、B 站、GitHub、微博、小红书、雪球等平台的预置命令。

3、查看支持的站点

bb-browser site list
bb-browser site recommend

4、主要能力与使用场景

1、基础浏览器操作

支持打开网页、点击元素、填写表单、执行 JS 代码、网络请求、页面截图、获取页面快照等自动化操作。

示例基础命令：

bb-browser open https://example.com # 打开指定网址
bb-browser screenshot # 页面截图
bb-browser eval "document.title" # 执行JS获取页面标题

2、站点适配（Site Adapters）

社区维护了大量站点适配器（单 JS 文件），目前已适配36 个主流平台、103 条专属命令，覆盖搜索、社交、资讯、开发、视频、财经等类别，包含百度、微博、小红书、B 站、知乎、GitHub 等国内外站点，可直接调用搜索、内容摘要、获取动态等专属功能。

示例站点命令：

bb-browser site baidu/search "关键词"
bb-browser site weibo/summary

3、典型使用场景

• 让 AI 智能体调取已登录账号的内容（社交动态、平台收藏、后台数据等）；
• 无官方 API 的网站数据提取、内容检索；
• 搭配 Claude Code、Cursor 等 MCP 客户端实现 AI 联动浏览器工作流。

5、三种运行模式

模式一：OpenClaw（最简单，推荐）

如果你用 OpenClaw，不用装 Chrome 扩展、不用手动开守护进程，直接加 --openclaw：

bb-browser site zhihu/hot --openclaw
bb-browser site baidu/search "AI 教程" --openclaw
bb-browser site xueqiu/hot-stock 5 --openclaw --jq '.items[] | {name,changePercent}'

模式二：独立使用（Chrome 扩展 + 本地守护进程）

（1）安装 Chrome 扩展

打开：https://github.com/epiral/bb-browser/releases

下载最新的 bb-browser-chrome.zip

解压到一个固定目录

Chrome 地址栏输入：chrome://extensions/

右上角打开「开发者模式」→「加载已解压的扩展程序」→选中解压目录

（2）启动守护进程（后台服务）

bb-browser daemon
# 可选：指定端口/IP
# bb-browser daemon --host 127.0.0.1 --port 19824

保持终端不要关，这是控制浏览器的核心服务。

（3）测试（用你已登录的账号）

bb-browser site zhihu/hot
bb-browser site bilibili/search "bb-browser"

模式三：MCP 接入（给 Claude Code / Cursor / AI Agent 用）

在 AI 工具的 MCP 配置里添加

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

保存后重启 AI 工具，它就能直接调用你的浏览器。

6、常用命令（CLI）

1、基础浏览器操作

# 打开网页
bb-browser open https://www.zhihu.com

# 截图
bb-browser screenshot

# 执行 JS
bb-browser eval "document.title"

# 点击元素（按页面顺序，@3 表示第3个可点击元素）
bb-browser click @3

# 填表
bb-browser fill @5 "你好"

# 网络请求抓包
bb-browser network requests --with-body --json

2、站点快捷命令（site）

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

# 百度搜索
bb-browser site baidu/search "2026 AI 趋势"

# B站搜索
bb-browser site bilibili/search "bb-browser 教程"

# GitHub 搜索
bb-browser site github/search "agent"

# 雪球热股（取前5）
bb-browser site xueqiu/hot-stock 5

3、结构化输出（给 AI 用）

# 输出 JSON
bb-browser site zhihu/hot --json

# jq 过滤字段
bb-browser site xueqiu/hot-stock --jq '.items[] | {name,price}'