你的浏览器就是 API。不需要密钥,不需要爬虫,不需要模拟。bb-browser 让 AI Agent 直接使用你真实浏览器的登录态访问任何网站——因为那就是你。

一个反直觉的想法

想象一下这个场景:

你想让 AI 帮你查一下知乎热榜、看看 Twitter 上关于某个话题的讨论、或者从雪球获取几只股票的实时行情。

传统做法是什么?

  • 找官方 API(99% 的网站没有)
  • 写爬虫(猫鼠游戏,随时被反爬)
  • 用 Playwright/Selenium(无头浏览器,容易被检测)
  • 偷 Cookie(安全风险,还要处理复杂的鉴权)

bb-browser 说:等等,为什么不用你已经登录的浏览器?

你每天都要打开微博、知乎、B 站、Twitter、GitHub、LinkedIn……你已经登录了这些网站,Cookie 就在浏览器里,为什么 AI 不能用?

bb-browser 是什么?

bb-browser(BadBoy Browser)是一个开源项目,它让 AI Agent 直接使用你真实浏览器的登录态来访问任何网站。

# Twitter 通知信息
bb-browser site twitter/notifications

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

# 雪球热门股票
bb-browser site xueqiu/hot-stock 5

# YouTube 视频字幕全文
bb-browser site youtube/transcript VIDEO_ID

# 小红书首页推荐
bb-browser site xiaohongshu/feed

36 个平台,103 个命令,全部用你真实浏览器的登录态。网站以为是你在操作——因为就是你

内置的 bb-sites 内容

 bb-browser site list

36kr/
  newsflash            - 36氪快讯

arxiv/
  search               - Search arXiv papers by query

baidu/
  search               - 百度搜索

bbc/
  news                 - BBC News headlines (RSS) or search

bilibili/
  comments             - Get comments for a Bilibili video
  feed                 - Get Bilibili dynamic feed (timeline from followed users)
  history              - Get Bilibili watch history
  me                   - Get current Bilibili logged-in user info
  popular              - Get Bilibili popular/trending videos
  ranking              - Get Bilibili top ranking videos (all categories or specific category)
  search               - Search Bilibili videos by keyword
  trending             - Get Bilibili trending search keywords (hot searches)
  video                - Get Bilibili video details by bvid

bing/
  search               - Bing 搜索

boss/
  detail               - 获取 BOSS直聘职位详情(JD、公司信息)
  search               - BOSS直聘搜索职位

cnblogs/
  search               - 博客园技术文章搜索

csdn/
  search               - CSDN 技术文章搜索

ctrip/
  search               - 携程旅行搜索 - 搜索目的地景点信息

devto/
  search               - Search Dev.to articles by keyword

douban/
  comments             - Get short reviews/comments for a Douban movie or TV show
  movie                - Get detailed movie/TV info with rating, cast, and hot reviews from Douban
  movie-hot            - Get hot/trending movies or TV shows on Douban by tag
  movie-top            - Get top rated movies by genre from Douban charts
  search               - Search Douban across movies, books, and music
  top250               - Get Douban Top 250 movies list

duckduckgo/
  search               - DuckDuckGo search (HTML lite, no JS needed)

eastmoney/
  news                 - 获取东方财富网财经热点新闻
  stock                - 获取东方财富网股票实时行情

genius/
  search               - Genius 歌曲/歌词搜索

github/
  fork                 - Fork a GitHub repository
  issue-create         - Create a GitHub issue
  issues               - 获取 GitHub 仓库的 issue 列表
  me                   - 获取当前 GitHub 登录用户信息
  pr-create            - Create a GitHub pull request
  repo                 - 获取 GitHub 仓库信息

google/
  search               - Google 搜索

gsmarena/
  search               - GSMArena 手机搜索

hackernews/
  thread               - 获取 Hacker News 帖子的评论树
  top                  - 获取 Hacker News 当前热门帖子

hupu/
  hot                  - 虎扑步行街热帖

imdb/
  search               - IMDb 电影搜索

jike/
  feed                 - 获取即刻推荐 Feed
  search               - 即刻搜索动态

linkedin/
  profile              - 获取 LinkedIn 用户 profile
  search               - 搜索 LinkedIn 帖子

npm/
  search               - Search npm packages via registry API

openlibrary/
  search               - Open Library 图书搜索

producthunt/
  today                - Product Hunt 今日热门产品

pypi/
  package              - 获取 Python 包详情
  search               - 搜索 Python 包

qidian/
  search               - 起点中文网小说搜索

reddit/
  context              - 获取评论的 ancestor chain(从根帖到目标评论的完整路径)
  hot                  - 获取 subreddit 热门帖子(或 Reddit 首页)
  me                   - 获取当前 Reddit 登录用户信息
  posts                - 获取用户发帖列表(自动翻页)
  search               - 搜索 Reddit 帖子
  thread               - 获取 Reddit 帖子的完整讨论树

reuters/
  search               - Reuters 路透社新闻搜索

smzdm/
  search               - 什么值得买搜索好价

sogou/
  weixin               - 搜狗微信文章搜索

stackoverflow/
  search               - Search Stack Overflow questions

toutiao/
  hot                  - 今日头条热榜
  search               - 今日头条搜索

twitter/
  bookmarks            - 获取 Twitter 书签列表
  notifications        - 获取 Twitter 通知(点赞、转发、回复、关注等)
  search               - 搜索推文
  thread               - 获取推文对话线程(原文 + 所有回复)
  tweets               - 获取用户最近的推文(时间线)
  user                 - 获取 Twitter 用户 profile

v2ex/
  hot                  - 获取 V2EX 最热主题
  latest               - 获取 V2EX 最新主题
  topic                - 获取 V2EX 主题详情和回复

weibo/
  comments             - Get comments on a Weibo post
  feed                 - Get Weibo home timeline (posts from followed users)
  hot                  - Get Weibo hot search / trending topics
  me                   - Get current logged-in Weibo user info
  post                 - Get a single Weibo post by ID (numeric or mblogid)
  user                 - Get Weibo user profile by uid (numeric) or screen_name
  user_posts           - Get a Weibo user's posts (timeline)

wikipedia/
  search               - 搜索维基百科
  summary              - 获取维基百科页面摘要

xiaohongshu/
  comments             - 获取小红书笔记的评论列表
  feed                 - 获取小红书首页推荐 Feed
  me                   - 获取当前小红书登录用户信息
  note                 - 获取小红书笔记详情(标题、正文、互动数据)
  search               - 搜索小红书笔记
  user_posts           - 获取小红书用户的笔记列表

xueqiu/
  feed                 - 获取雪球首页时间线(关注用户的动态)
  hot                  - 获取雪球热门动态
  hot-stock            - 获取雪球热门股票榜
  search               - 搜索雪球股票(代码或名称)
  stock                - 获取雪球股票实时行情
  watchlist            - 获取雪球自选股列表

yahoo-finance/
  quote                - Yahoo Finance 股票行情

youdao/
  translate            - 有道翻译/词典查询

youtube/
  channel              - Get YouTube channel info and recent videos
  comments             - Get comments for a YouTube video
  feed                 - Get YouTube home feed or subscriptions feed
  search               - Search YouTube videos
  transcript           - Get video transcript/captions (must be on the video page)
  video                - Get detailed info for a YouTube video (from current page or by video ID)

zhihu/
  hot                  - Get Zhihu hot list (trending topics)
  me                   - Get current logged-in Zhihu user info
  question             - Get a Zhihu question and its top answers
  search               - Search Zhihu for questions and answers

核心理念:翻转思维

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

bb-browser 翻转了这个逻辑:

不是让网站适配机器,而是让机器使用人的界面。

技术实现上,bb-browser 的 adapter 会在你的浏览器 tab 里执行 eval,用你的 Cookie 调用 fetch(),或者直接调用页面的 webpack 模块。

对比传统方案

Playwright/Selenium爬虫库bb-browser
浏览器无头、隔离环境没有浏览器你的真实 Chrome
登录态没有,要重新登录偷 Cookie已经在了
反爬检测容易被识别猫鼠游戏无法检测—它就是用户
复杂鉴权无法复制需要逆向页面自己处理

这个差异是本质性的:当你的 AI 用 bb-browser 访问网站时,它不是在"模拟"用户,它就是用户。

架构设计

AI Agent (Claude Code, Codex, Cursor 等)
       │ CLI 或 MCP (stdio)
       ▼
bb-browser CLI ──HTTP──▶ Daemon ──SSE──▶ Chrome Extension
                                              │
                                              ▼ chrome.debugger (CDP)
                                         你的真实浏览器
  • CLI:命令行入口,支持直接调用或 MCP 协议
  • Daemon:本地守护进程,默认绑定 localhost:19824
  • Chrome Extension:通过 chrome.debugger API 控制浏览器
  • CDP:Chrome DevTools Protocol,执行底层操作

10 分钟,CLI 化任何网站

bb-browser 最厉害的地方在于它的扩展性

社区通过 bb-sites 仓库维护适配器,每个命令一个 JS 文件。你可以告诉 AI Agent:

"帮我把 XX 网站 CLI 化"

AI 会:

  1. 读 guide 文档
  2. network --with-body 抓包逆向
  3. 写 adapter
  4. 测试
  5. 提 PR 到社区仓库

全程自动。

根据复杂度分三个层级:

层级认证方式代表耗时
Tier 1Cookie(直接 fetch)Reddit、GitHub、V2EX~1 分钟
Tier 2Bearer + CSRF tokenTwitter、知乎~3 分钟
Tier 3Webpack 注入 / Pinia storeTwitter 搜索、小红书~10 分钟

项目方实测:20 个 AI Agent 并发运行,每个独立逆向一个网站并产出可用的 adapter。

将一个新网站纳入 Agent 可访问范围的边际成本,趋近于零。

对 AI Agent 意味着什么

没有 bb-browser,AI Agent 的世界是:

文件系统 + 终端 + 少数有 API key 的服务

有了 bb-browser:

文件系统 + 终端 + 整个互联网

想象一个 Agent 在一分钟内能做什么:

# 跨平台调研任何话题
bb-browser site arxiv/search "retrieval augmented generation"
bb-browser site twitter/search "RAG"
bb-browser site github search rag-framework
bb-browser site stackoverflow/search "RAG implementation"
bb-browser site zhihu/search "RAG"
bb-browser site 36kr/newsflash

六个平台,六个维度,结构化 JSON 输出。比任何人类研究员都快、都广。

不仅是信息获取

bb-browser 同时也是完整的浏览器自动化工具:

# 打开页面
bb-browser open https://example.com

# 查看可交互元素
bb-browser snapshot -i
# @1 [button] "提交"
# @2 [input] placeholder="请输入姓名"

# 点击、填写
bb-browser click @1
bb-browser fill @2 "张三"

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

# 截图
bb-browser screenshot

# 抓包
bb-browser network requests --with-body --json

所有命令支持 --json 输出、--jq 内联过滤、和 --tab 多标签页并发操作。

快速开始

安装

npm install -g bb-browser

使用

bb-browser site update        # 拉取社区适配器
bb-browser site recommend     # 看看哪些和你浏览习惯匹配
bb-browser site zhihu/hot     # 开搞

OpenClaw 用户

如果你使用 OpenClaw,bb-browser 可以直接通过 OpenClaw 内置浏览器运行,不需要额外安装 Chrome 扩展或 daemon:

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

MCP 接入(Claude Code / Cursor)

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

已支持平台(部分)

类别平台
搜索引擎Google、百度、Bing、DuckDuckGo、搜狗微信
社交媒体Twitter/X、Reddit、微博、小红书、即刻、LinkedIn、虎扑
新闻资讯BBC、Reuters、36 氪、今日头条、东方财富
技术开发GitHub、StackOverflow、HackerNews、CSDN、博客园、V2EX、arXiv
视频平台YouTube、B 站
财经股票雪球、东方财富、Yahoo Finance
求职招聘BOSS 直聘、LinkedIn
知识百科Wikipedia、知乎、Open Library

完整列表见 bb-sites

思考

bb-browser 代表了一种思维转变:

与其让每个网站都提供 API,不如让 AI 学会使用人的界面。

这个思路的延伸是什么?

  • 企业内部系统不需要为 AI 开发接口,AI 直接用员工的浏览器访问
  • 政府网站、学校系统、银行后台……任何需要登录的地方,AI 都能用
  • AI 不再是"外部调用者",而是"内部使用者"

当然,这也带来了新的问题:权限管理、操作审计、责任归属……

但技术已经在这里了。下一步,看我们怎么用它。


项目信息

License: MIT

#AI工具 #开源项目 #浏览器自动化 #AI-Agent #开发者工具
#Web Scraping #Chrome扩展 #效率工具 #技术分享 #编程

Q.E.D.


寻门而入,破门而出