npm - bb-browser - Versions diffs - 0.4.4 → 0.4.5 - Mend

bb-browser 0.4.4 → 0.4.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (5) hide show

package/README.md CHANGED Viewed

@@ -16,154 +16,120 @@
 ---
-You're already logged into Gmail, Twitter, Reddit, Xiaohongshu — bb-browser lets AI agents use that. Not by stealing cookies or faking fingerprints. By **being** the browser.
+You're already logged into Reddit, Twitter, YouTube, Zhihu, Bilibili, Weibo, Douban, Xiaohongshu — bb-browser lets AI agents **use that directly**.
-```
-AI Agent (Claude Code, Codex, etc.)
-       │ CLI commands
-       ▼
-bb-browser CLI ──HTTP──▶ Daemon ──SSE──▶ Chrome Extension
-                                              │
-                                              ▼ chrome.debugger (CDP)
-                                         Your Real Browser
-                                    (logged-in sites, cookies, sessions)
+```bash
+bb-browser site zhihu/hot                    # 知乎热榜
+bb-browser site weibo/hot                    # 微博热搜
+bb-browser site bilibili/popular             # B站热门
+bb-browser site douban/top250                # 豆瓣 Top 250
+bb-browser site youtube/transcript VIDEO_ID  # YouTube 字幕全文
+bb-browser site reddit/thread URL            # Reddit 讨论树
+bb-browser site twitter/user elonmusk        # Twitter 用户资料
+bb-browser site xiaohongshu/search 美食       # 小红书搜索
 ```
-## Why
+**50+ commands across 10 platforms.** All using your real browser's login state. [Full list →](https://github.com/epiral/bb-sites)
-Every scraping tool tries to **pretend** it's a browser. bb-browser **is** the browser.
+## Why this is different
+Every browser automation tool can click buttons and fill forms. bb-browser does that too. But the real power is **site adapters** — pre-built commands that turn any website into a CLI/API, using your browser's login state.
+How it works under the hood: the adapter runs `eval` inside your browser tab. It calls `fetch()` with your cookies, or invokes the page's own Vue/Pinia store actions. The website thinks it's you. Because it **is** you.
 | | Playwright / Selenium | Scraping libs | bb-browser |
 |---|---|---|---|
 | Browser | Headless, isolated | No browser | Your real Chrome |
 | Login state | None, must re-login | Cookie extraction | Already there |
-| Anti-bot | Detected easily | Cat-and-mouse game | Invisible — it IS the user |
-| Internal sites | Need VPN/proxy setup | Can't reach | If you can see it, so can the agent |
+| Anti-bot | Detected easily | Cat-and-mouse | Invisible — it IS the user |
+| XHS signing | Can't replicate | Reverse engineer | Page signs it itself |
-## What it can do
+## Quick Start
-### Browser Automation
+### Install
 ```bash
-bb-browser open https://example.com
-bb-browser snapshot -i           # interactive elements only
-bb-browser click @0              # click by ref
-bb-browser fill @2 "hello"       # fill input
-bb-browser press Enter
-bb-browser screenshot
+npm install -g bb-browser
 ```
-### Authenticated Fetch
+### Chrome Extension
-Like `curl`, but with your browser's login state. No API keys, no tokens.
+1. Download from [Releases](https://github.com/epiral/bb-browser/releases/latest)
+2. Unzip → `chrome://extensions/` → Developer Mode → Load unpacked
-```bash
-# Reddit — you're logged in, just fetch
-bb-browser fetch https://www.reddit.com/api/me.json
-# Any website's internal API — the browser handles auth
-bb-browser fetch https://api.example.com/user/profile --json
-```
-### Network Capture
-See what any website sends and receives — request headers, bodies, response data. Like Chrome DevTools Network tab, but from CLI.
+### Use
 ```bash
-bb-browser network requests --filter "api.example.com" --with-body --json
-# → Full request headers (including auth/signing), full response body
-# → See exactly how a website's API works — then build an adapter for it
+bb-browser site update    # pull 50+ community adapters
+bb-browser site list      # see what's available
+bb-browser site zhihu/hot # go
 ```
-### Site Adapters
+### MCP (Claude Code / Cursor)
+```json
+{
+  "mcpServers": {
+    "bb-browser": {
+      "command": "npx",
+      "args": ["-y", "bb-browser", "--mcp"]
+    }
+  }
+}
+```
-Pre-built commands for popular websites. Community-driven via [bb-sites](https://github.com/epiral/bb-sites).
+## Site Adapters — the core feature
-```bash
-bb-browser site update                                    # install adapters
-bb-browser site reddit/thread https://reddit.com/r/...    # Reddit discussion tree
-bb-browser site twitter/user yan5xu                        # Twitter profile
-bb-browser site xiaohongshu/feed                           # Xiaohongshu feed
-bb-browser site hackernews/top                             # HN front page
-```
+Community-driven via [bb-sites](https://github.com/epiral/bb-sites). One JS file per command.
-> Xiaohongshu has request signing (X-s headers). Our adapters call the page's own Vue/Pinia store actions — the page signs the requests itself. Zero reverse engineering needed.
+| Platform | Commands | Auth |
+|----------|----------|------|
+| **Reddit** | me, posts, thread, context | Cookie |
+| **Twitter/X** | user, thread | Bearer + CSRF |
+| **GitHub** | me, repo, issues, issue-create, pr-create, fork | Cookie |
+| **Hacker News** | top, thread | Public API |
+| **Zhihu** | me, hot, question, search | Cookie |
+| **Bilibili** | me, popular, ranking, search, video, comments, feed, history, trending | Cookie |
+| **Weibo** | me, hot, feed, user, user_posts, post, comments | Cookie |
+| **Douban** | search, movie, movie-hot, movie-top, top250, comments | Cookie |
+| **YouTube** | search, video, comments, channel, feed, transcript | innertube |
+| **Xiaohongshu** | me, feed, search, note, comments, user_posts | Pinia store |
-## Install
+### Create your own
 ```bash
-npm install -g bb-browser
+bb-browser guide    # full tutorial
 ```
-Then load the Chrome extension:
+Tell your AI agent "turn XX website into a CLI" — it reads the guide, reverse-engineers the API with `network --with-body`, writes the adapter, tests it, and submits a PR. All autonomously.
-1. `chrome://extensions/` → Enable Developer Mode
-2. "Load unpacked" → select `node_modules/bb-browser/extension/`
-3. Done.
+## Also a full browser automation tool
 ```bash
-bb-browser daemon    # start the daemon
-bb-browser status    # verify connection
+bb-browser open https://example.com
+bb-browser snapshot -i                # accessibility tree
+bb-browser click @3                   # click element
+bb-browser fill @5 "hello"            # fill input
+bb-browser eval "document.title"      # run JS
+bb-browser fetch URL --json           # authenticated fetch
+bb-browser network requests --with-body --json  # capture traffic
+bb-browser screenshot                 # take screenshot
 ```
-## Command Reference
-| Category | Command | Description |
-|----------|---------|-------------|
-| **Navigate** | `open <url>` | Open URL |
-| | `back` / `forward` / `refresh` | Navigate |
-| | `close` | Close tab |
-| **Snapshot** | `snapshot` | Full DOM tree |
-| | `snapshot -i` | Interactive elements only |
-| **Interact** | `click <ref>` | Click element |
-| | `fill <ref> <text>` | Clear and fill |
-| | `type <ref> <text>` | Append text |
-| | `hover <ref>` | Hover |
-| | `press <key>` | Keyboard (Enter, Tab, Control+a) |
-| | `scroll <dir> [px]` | Scroll |
-| | `check` / `uncheck <ref>` | Checkbox |
-| | `select <ref> <val>` | Dropdown |
-| **Data** | `get text <ref>` | Element text |
-| | `get url` / `get title` | Page info |
-| | `screenshot [path]` | Screenshot |
-| | `eval "<js>"` | Run JavaScript |
-| **Fetch** | `fetch <url> [--json]` | Authenticated HTTP fetch |
-| **Site** | `site list` | List site adapters |
-| | `site <name> [args]` | Run adapter |
-| | `site update` | Update community adapters |
-| **Network** | `network requests [filter]` | View requests |
-| | `network requests --with-body` | Include headers & body |
-| | `network route "<url>" --abort` | Block requests |
-| | `network clear` | Clear records |
-| **Tab** | `tab` | List tabs |
-| | `tab new [url]` | New tab |
-| | `tab <n>` | Switch tab |
-| **Debug** | `console` / `errors` | Console & JS errors |
-| | `trace start` / `trace stop` | Record user actions |
-| **Daemon** | `daemon` / `stop` / `status` | Manage daemon |
-All commands support `--json` for structured output and `--tab <id>` for multi-tab operations.
+All commands support `--json` output and `--tab <id>` for concurrent multi-tab operations.
 ## Architecture
 ```
-bb-browser/
-├── packages/
-│   ├── cli/          # CLI (TypeScript, argument parsing, HTTP client)
-│   ├── daemon/       # HTTP daemon (SSE bridge, request-response matching)
-│   ├── extension/    # Chrome extension (Manifest V3, chrome.debugger CDP)
-│   └── shared/       # Shared types and protocol definitions
-├── dist/             # Build output (npm publish)
-└── extension/        # Built extension (npm publish)
+AI Agent (Claude Code, Codex, Cursor, etc.)
+       │ CLI or MCP (stdio)
+       ▼
+bb-browser CLI ──HTTP──▶ Daemon ──SSE──▶ Chrome Extension
+                                              │
+                                              ▼ chrome.debugger (CDP)
+                                         Your Real Browser
 ```
-| Layer | Tech |
-|-------|------|
-| CLI | TypeScript, zero dependencies |
-| Daemon | Node.js HTTP + SSE |
-| Extension | Chrome MV3 + `chrome.debugger` API |
-| Build | pnpm monorepo + Turborepo + tsup + Vite |
 ## License
 [MIT](LICENSE)

package/README.zh-CN.md CHANGED Viewed

@@ -16,154 +16,120 @@
 ---
-你已经登录了 Gmail、Twitter、Reddit、小红书 — bb-browser 让 AI Agent 直接用你的浏览器。不是偷 Cookie，不是伪造指纹。是**成为**浏览器本身。
+你已经登录了知乎、微博、B站、豆瓣、小红书、Reddit、Twitter、YouTube — bb-browser 让 AI Agent **直接用你的登录态**。
-```
-AI Agent (Claude Code, Codex 等)
-       │ CLI 命令
-       ▼
-bb-browser CLI ──HTTP──▶ Daemon ──SSE──▶ Chrome 扩展
-                                              │
-                                              ▼ chrome.debugger (CDP)
-                                         你的真实浏览器
-                                    (已登录的网站、Cookie、会话)
+```bash
+bb-browser site zhihu/hot                    # 知乎热榜
+bb-browser site weibo/hot                    # 微博热搜
+bb-browser site bilibili/popular             # B站热门
+bb-browser site douban/top250                # 豆瓣 Top 250
+bb-browser site youtube/transcript VIDEO_ID  # YouTube 字幕全文
+bb-browser site reddit/thread URL            # Reddit 讨论树
+bb-browser site twitter/user elonmusk        # Twitter 用户资料
+bb-browser site xiaohongshu/search 美食       # 小红书搜索
 ```
-## 为什么
+**10 个平台，50+ 个命令，全部用你真实浏览器的登录态。** [完整列表 →](https://github.com/epiral/bb-sites)
-所有爬虫工具都在**假装**是浏览器。bb-browser **就是**浏览器。
+## 为什么它不一样
+所有浏览器自动化工具都能点按钮、填表单，bb-browser 也能。但真正的杀手锏是 **Site Adapters** — 预置命令把任何网站变成 CLI/API，直接用你的登录态。
+原理：adapter 在你的浏览器 tab 里跑 `eval`，用你的 Cookie 调 `fetch()`，或者直接调用页面自己的 Vue/Pinia store action。网站以为是你在操作。因为**就是你**。
 | | Playwright / Selenium | 爬虫库 | bb-browser |
 |---|---|---|---|
 | 浏览器 | 无头、隔离环境 | 没有浏览器 | 你的真实 Chrome |
 | 登录态 | 没有，要重新登录 | 偷 Cookie | 已经在了 |
 | 反爬检测 | 容易被识别 | 猫鼠游戏 | 无法检测 — 它就是用户 |
-| 内部系统 | 需要配 VPN/代理 | 访问不了 | 你能看到的，Agent 都能用 |
+| 小红书签名 | 无法复制 | 需要逆向 | 页面自己签名 |
-## 能做什么
+## 快速开始
-### 浏览器自动化
+### 安装
 ```bash
-bb-browser open https://example.com
-bb-browser snapshot -i           # 只看可交互元素
-bb-browser click @0              # 按 ref 点击
-bb-browser fill @2 "hello"       # 填写输入框
-bb-browser press Enter
-bb-browser screenshot
+npm install -g bb-browser
 ```
-### 带登录态的 Fetch
+### Chrome 扩展
-像 `curl`，但自动带上浏览器里的 Cookie 和会话。不需要 API key，不需要 token。
+1. 从 [Releases](https://github.com/epiral/bb-browser/releases/latest) 下载 zip
+2. 解压 → `chrome://extensions/` → 开发者模式 → 加载已解压的扩展程序
-```bash
-# Reddit — 你已经登录了，直接 fetch
-bb-browser fetch https://www.reddit.com/api/me.json
-# 任何网站的内部 API — 浏览器自动处理认证
-bb-browser fetch https://api.example.com/user/profile --json
-```
-### 网络抓包
-查看任何网站发送和接收的完整数据 — 请求头、请求体、响应体。相当于 Chrome DevTools 的 Network 面板，但在命令行里。
+### 使用
 ```bash
-bb-browser network requests --filter "api.example.com" --with-body --json
-# → 完整的请求头（包括签名 header）、完整的响应体
-# → 看清一个网站的 API 是怎么工作的 — 然后为它写 adapter
+bb-browser site update    # 拉取 50+ 社区适配器
+bb-browser site list      # 看看有什么
+bb-browser site zhihu/hot # 开搞
 ```
-### Site Adapters — 网站 CLI 化
+### MCP 接入（Claude Code / Cursor）
+```json
+{
+  "mcpServers": {
+    "bb-browser": {
+      "command": "npx",
+      "args": ["-y", "bb-browser", "--mcp"]
+    }
+  }
+}
+```
-为热门网站预置的命令，社区驱动，通过 [bb-sites](https://github.com/epiral/bb-sites) 维护。
+## Site Adapters — 核心能力
-```bash
-bb-browser site update                                    # 安装/更新 adapter
-bb-browser site reddit/thread https://reddit.com/r/...    # Reddit 讨论树
-bb-browser site twitter/user yan5xu                        # Twitter 用户资料
-bb-browser site xiaohongshu/feed                           # 小红书推荐 Feed
-bb-browser site hackernews/top                             # HN 首页
-```
+社区驱动，通过 [bb-sites](https://github.com/epiral/bb-sites) 维护。每个命令一个 JS 文件。
-> 小红书有请求签名（X-s header）。我们的 adapter 通过调用页面自己的 Vue/Pinia store action 发请求 — 页面自己签名，零逆向。
+| 平台 | 命令 | 认证方式 |
+|------|------|----------|
+| **知乎** | me, hot, question, search | Cookie |
+| **B站** | me, popular, ranking, search, video, comments, feed, history, trending | Cookie |
+| **微博** | me, hot, feed, user, user_posts, post, comments | Cookie |
+| **豆瓣** | search, movie, movie-hot, movie-top, top250, comments | Cookie |
+| **小红书** | me, feed, search, note, comments, user_posts | Pinia store |
+| **YouTube** | search, video, comments, channel, feed, transcript | innertube |
+| **Reddit** | me, posts, thread, context | Cookie |
+| **Twitter/X** | user, thread | Bearer + CSRF |
+| **GitHub** | me, repo, issues, issue-create, pr-create, fork | Cookie |
+| **Hacker News** | top, thread | 公开 API |
-## 安装
+### 自己做一个
 ```bash
-npm install -g bb-browser
+bb-browser guide    # 完整教程
 ```
-加载 Chrome 扩展：
+跟你的 AI Agent 说「帮我把 XX 网站 CLI 化」— 它会读 guide，用 `network --with-body` 抓包逆向 API，写 adapter，测试，然后自己提 PR 到社区仓库。全程自动。
-1. 打开 `chrome://extensions/` → 开启开发者模式
-2. 点击「加载已解压的扩展程序」→ 选 `node_modules/bb-browser/extension/`
-3. 完成。
+## 同时也是完整的浏览器自动化工具
 ```bash
-bb-browser daemon    # 启动 daemon
-bb-browser status    # 确认连接
+bb-browser open https://example.com
+bb-browser snapshot -i                # 可访问性树
+bb-browser click @3                   # 点击元素
+bb-browser fill @5 "hello"            # 填写输入框
+bb-browser eval "document.title"      # 执行 JS
+bb-browser fetch URL --json           # 带登录态的 fetch
+bb-browser network requests --with-body --json  # 抓包
+bb-browser screenshot                 # 截图
 ```
-## 命令速查
-| 分类 | 命令 | 说明 |
-|------|------|------|
-| **导航** | `open <url>` | 打开 URL |
-| | `back` / `forward` / `refresh` | 导航 |
-| | `close` | 关闭标签页 |
-| **快照** | `snapshot` | 完整 DOM 树 |
-| | `snapshot -i` | 只看可交互元素 |
-| **交互** | `click <ref>` | 点击 |
-| | `fill <ref> <text>` | 清空后填入 |
-| | `type <ref> <text>` | 追加输入 |
-| | `hover <ref>` | 悬停 |
-| | `press <key>` | 按键（Enter, Tab, Control+a）|
-| | `scroll <dir> [px]` | 滚动 |
-| | `check` / `uncheck <ref>` | 复选框 |
-| | `select <ref> <val>` | 下拉框 |
-| **数据** | `get text <ref>` | 元素文本 |
-| | `get url` / `get title` | 页面信息 |
-| | `screenshot [path]` | 截图 |
-| | `eval "<js>"` | 执行 JavaScript |
-| **Fetch** | `fetch <url> [--json]` | 带登录态的 HTTP 请求 |
-| **Site** | `site list` | 列出 adapter |
-| | `site <name> [args]` | 运行 adapter |
-| | `site update` | 更新社区 adapter |
-| **网络** | `network requests [filter]` | 查看请求 |
-| | `network requests --with-body` | 包含请求头和响应体 |
-| | `network route "<url>" --abort` | 拦截请求 |
-| | `network clear` | 清空记录 |
-| **Tab** | `tab` | 列出标签页 |
-| | `tab new [url]` | 新标签页 |
-| | `tab <n>` | 切换标签页 |
-| **调试** | `console` / `errors` | 控制台/JS 错误 |
-| | `trace start` / `trace stop` | 录制用户操作 |
-| **Daemon** | `daemon` / `stop` / `status` | 管理 daemon |
-所有命令支持 `--json` 结构化输出和 `--tab <id>` 多标签页操作。
+所有命令支持 `--json` 输出和 `--tab <id>` 多标签页并发操作。
 ## 架构
 ```
-bb-browser/
-├── packages/
-│   ├── cli/          # CLI（TypeScript，参数解析，HTTP 客户端）
-│   ├── daemon/       # HTTP Daemon（SSE 桥接，请求响应匹配）
-│   ├── extension/    # Chrome 扩展（Manifest V3，chrome.debugger CDP）
-│   └── shared/       # 共享类型和协议定义
-├── dist/             # 构建产物（npm 发布）
-└── extension/        # 构建好的扩展（npm 发布）
+AI Agent (Claude Code, Codex, Cursor 等)
+       │ CLI 或 MCP (stdio)
+       ▼
+bb-browser CLI ──HTTP──▶ Daemon ──SSE──▶ Chrome 扩展
+                                              │
+                                              ▼ chrome.debugger (CDP)
+                                         你的真实浏览器
 ```
-| 层 | 技术栈 |
-|----|--------|
-| CLI | TypeScript，零依赖 |
-| Daemon | Node.js HTTP + SSE |
-| Extension | Chrome MV3 + `chrome.debugger` API |
-| 构建 | pnpm monorepo + Turborepo + tsup + Vite |
 ## 许可证
 [MIT](LICENSE)

package/dist/cli.js CHANGED Viewed

@@ -1980,85 +1980,79 @@ bb-browser - AI Agent \u6D4F\u89C8\u5668\u81EA\u52A8\u5316\u5DE5\u5177
 \u7528\u6CD5\uFF1A
   bb-browser <command> [options]
-\u547D\u4EE4\uFF1A
-  open <url> [--tab] \u6253\u5F00\u6307\u5B9A URL\uFF08\u9ED8\u8BA4\u65B0 tab\uFF0C--tab current \u5F53\u524D tab\uFF09
-  snapshot          \u83B7\u53D6\u5F53\u524D\u9875\u9762\u5FEB\u7167\uFF08\u9ED8\u8BA4\u5B8C\u6574\u6811\uFF09
-  click <ref>       \u70B9\u51FB\u5143\u7D20\uFF08ref \u5982 @5 \u6216 5\uFF09
-  hover <ref>       \u60AC\u505C\u5728\u5143\u7D20\u4E0A
-  fill <ref> <text> \u586B\u5145\u8F93\u5165\u6846\uFF08\u6E05\u7A7A\u540E\u586B\u5165\uFF09
-  type <ref> <text> \u9010\u5B57\u7B26\u8F93\u5165\uFF08\u4E0D\u6E05\u7A7A\uFF09
-  check <ref>       \u52FE\u9009\u590D\u9009\u6846
-  uncheck <ref>     \u53D6\u6D88\u52FE\u9009\u590D\u9009\u6846
-  select <ref> <val> \u4E0B\u62C9\u6846\u9009\u62E9
-  eval "<js>"       \u6267\u884C JavaScript
-  close             \u5173\u95ED\u5F53\u524D\u6807\u7B7E\u9875
-  get text <ref>    \u83B7\u53D6\u5143\u7D20\u6587\u672C
-  get url           \u83B7\u53D6\u5F53\u524D\u9875\u9762 URL
-  get title         \u83B7\u53D6\u9875\u9762\u6807\u9898
-  screenshot [path] \u622A\u53D6\u5F53\u524D\u9875\u9762
-  wait <ms|@ref>    \u7B49\u5F85\u65F6\u95F4\u6216\u5143\u7D20
-  press <key>       \u53D1\u9001\u952E\u76D8\u6309\u952E\uFF08\u5982 Enter, Tab, Control+a\uFF09
-  scroll <dir> [px] \u6EDA\u52A8\u9875\u9762\uFF08up/down/left/right\uFF0C\u9ED8\u8BA4 300px\uFF09
-  daemon            \u524D\u53F0\u542F\u52A8 Daemon
-  start             \u524D\u53F0\u542F\u52A8 Daemon\uFF08daemon \u7684\u522B\u540D\uFF09
-  stop              \u505C\u6B62 Daemon
-  status            \u67E5\u770B Daemon \u72B6\u6001
-  reload            \u91CD\u8F7D\u6269\u5C55\uFF08\u9700\u8981 CDP \u6A21\u5F0F\uFF09
-  back              \u540E\u9000
-  forward           \u524D\u8FDB
-  refresh           \u5237\u65B0\u9875\u9762
-  tab               \u5217\u51FA\u6240\u6709\u6807\u7B7E\u9875
-  tab new [url]     \u65B0\u5EFA\u6807\u7B7E\u9875
-  tab <n>           \u5207\u6362\u5230\u7B2C n \u4E2A\u6807\u7B7E\u9875\uFF08\u6309 index\uFF09
-  tab select --id <id>  \u5207\u6362\u5230\u6307\u5B9A tabId \u7684\u6807\u7B7E\u9875
-  tab close [n]     \u5173\u95ED\u6807\u7B7E\u9875\uFF08\u6309 index\uFF0C\u9ED8\u8BA4\u5F53\u524D\uFF09
-  tab close --id <id>   \u5173\u95ED\u6307\u5B9A tabId \u7684\u6807\u7B7E\u9875
-  frame <selector>  \u5207\u6362\u5230\u6307\u5B9A iframe
-  frame main        \u8FD4\u56DE\u4E3B frame
-  dialog accept [text]  \u63A5\u53D7\u5BF9\u8BDD\u6846\uFF08alert/confirm/prompt\uFF09
-  dialog dismiss    \u62D2\u7EDD/\u5173\u95ED\u5BF9\u8BDD\u6846
+\u7F51\u7AD9 CLI \u5316\uFF08\u628A\u4EFB\u4F55\u7F51\u7AD9\u53D8\u6210\u547D\u4EE4\u884C API\uFF09\uFF1A
+  site list            \u5217\u51FA\u6240\u6709\u53EF\u7528 adapter\uFF0850+\uFF09
+  site search <q>      \u641C\u7D22 adapter
+  site <name> [args]   \u8FD0\u884C adapter\uFF08\u5982 site reddit/thread <url>\uFF09
+  site update          \u66F4\u65B0\u793E\u533A adapter \u5E93
+  guide                \u5982\u4F55\u521B\u5EFA\u65B0 adapter\uFF08\u5F00\u53D1\u6307\u5357\uFF09
+  \u793A\u4F8B\uFF1A
+    bb-browser site twitter/search "claude code"
+    bb-browser site reddit/thread <url>
+    bb-browser site github/pr-create owner/repo --title "feat: ..."
+\u9875\u9762\u5BFC\u822A\uFF1A
+  open <url> [--tab]   \u6253\u5F00\u6307\u5B9A URL\uFF08\u9ED8\u8BA4\u65B0 tab\uFF0C--tab current \u5F53\u524D tab\uFF09
+  back / forward       \u540E\u9000 / \u524D\u8FDB
+  refresh              \u5237\u65B0\u9875\u9762
+  close                \u5173\u95ED\u5F53\u524D\u6807\u7B7E\u9875
+  tab                  \u5217\u51FA\u6240\u6709\u6807\u7B7E\u9875
+  tab new [url]        \u65B0\u5EFA\u6807\u7B7E\u9875
+  tab <n>              \u5207\u6362\u5230\u7B2C n \u4E2A\u6807\u7B7E\u9875\uFF08\u6309 index\uFF09
+  tab select --id <id> \u5207\u6362\u5230\u6307\u5B9A tabId \u7684\u6807\u7B7E\u9875
+  tab close [n|--id <id>]  \u5173\u95ED\u6807\u7B7E\u9875
+  frame <selector>     \u5207\u6362\u5230\u6307\u5B9A iframe
+  frame main           \u8FD4\u56DE\u4E3B frame
+  wait <ms|@ref>       \u7B49\u5F85\u65F6\u95F4\u6216\u5143\u7D20
+\u9875\u9762\u4EA4\u4E92\uFF1A
+  click <ref>          \u70B9\u51FB\u5143\u7D20\uFF08ref \u5982 @5 \u6216 5\uFF09
+  hover <ref>          \u60AC\u505C\u5728\u5143\u7D20\u4E0A
+  fill <ref> <text>    \u586B\u5145\u8F93\u5165\u6846\uFF08\u6E05\u7A7A\u540E\u586B\u5165\uFF09
+  type <ref> <text>    \u9010\u5B57\u7B26\u8F93\u5165\uFF08\u4E0D\u6E05\u7A7A\uFF09
+  check <ref>          \u52FE\u9009\u590D\u9009\u6846
+  uncheck <ref>        \u53D6\u6D88\u52FE\u9009\u590D\u9009\u6846
+  select <ref> <val>   \u4E0B\u62C9\u6846\u9009\u62E9
+  press <key>          \u53D1\u9001\u952E\u76D8\u6309\u952E\uFF08\u5982 Enter, Tab, Control+a\uFF09
+  scroll <dir> [px]    \u6EDA\u52A8\u9875\u9762\uFF08up/down/left/right\uFF0C\u9ED8\u8BA4 300px\uFF09
+  dialog accept [text] \u63A5\u53D7\u5BF9\u8BDD\u6846
+  dialog dismiss       \u62D2\u7EDD/\u5173\u95ED\u5BF9\u8BDD\u6846
+\u9875\u9762\u4FE1\u606F\uFF1A
+  snapshot             \u83B7\u53D6\u5F53\u524D\u9875\u9762\u5FEB\u7167\uFF08\u9ED8\u8BA4\u5B8C\u6574\u6811\uFF09
+  get text <ref>       \u83B7\u53D6\u5143\u7D20\u6587\u672C
+  get url              \u83B7\u53D6\u5F53\u524D\u9875\u9762 URL
+  get title            \u83B7\u53D6\u9875\u9762\u6807\u9898
+  screenshot [path]    \u622A\u53D6\u5F53\u524D\u9875\u9762
+  eval "<js>"          \u6267\u884C JavaScript
+  fetch <url>          \u5728\u6D4F\u89C8\u5668\u4E0A\u4E0B\u6587\u4E2D fetch\uFF08\u81EA\u52A8\u540C\u6E90\u8DEF\u7531\uFF0C\u5E26\u767B\u5F55\u6001\uFF09
+\u7F51\u7EDC\u4E0E\u8C03\u8BD5\uFF1A
   network requests [filter]  \u67E5\u770B\u7F51\u7EDC\u8BF7\u6C42
   network route <url> [--abort|--body <json>]  \u62E6\u622A\u8BF7\u6C42
-  network unroute [url]  \u79FB\u9664\u62E6\u622A\u89C4\u5219
-  network clear     \u6E05\u7A7A\u8BF7\u6C42\u8BB0\u5F55
-  console           \u67E5\u770B\u63A7\u5236\u53F0\u6D88\u606F
-  console --clear   \u6E05\u7A7A\u63A7\u5236\u53F0
-  errors            \u67E5\u770B JS \u9519\u8BEF
-  errors --clear    \u6E05\u7A7A\u9519\u8BEF\u8BB0\u5F55
-  trace start       \u5F00\u59CB\u5F55\u5236\u7528\u6237\u64CD\u4F5C
-  trace stop        \u505C\u6B62\u5F55\u5236\uFF0C\u8F93\u51FA\u4E8B\u4EF6\u5217\u8868
-  trace status      \u67E5\u770B\u5F55\u5236\u72B6\u6001
-  fetch <url>       \u5728\u6D4F\u89C8\u5668\u4E0A\u4E0B\u6587\u4E2D fetch\uFF08\u81EA\u52A8\u540C\u6E90\u8DEF\u7531\uFF0C\u5E26\u767B\u5F55\u6001\uFF09
-  site              \u7F51\u7AD9 CLI \u5316 \u2014 \u7BA1\u7406\u548C\u8FD0\u884C site adapter
-  site list         \u5217\u51FA\u6240\u6709\u53EF\u7528 adapter
-  site search <q>   \u641C\u7D22 adapter
-  site <name>       \u8FD0\u884C adapter\uFF08\u5982 site reddit/thread <url>\uFF09
-  site update       \u66F4\u65B0\u793E\u533A adapter \u5E93
-  guide             \u5982\u4F55\u628A\u4EFB\u4F55\u7F51\u7AD9\u53D8\u6210 site adapter\uFF08\u5F00\u53D1\u6307\u5357\uFF09
+  network unroute [url]      \u79FB\u9664\u62E6\u622A\u89C4\u5219
+  network clear              \u6E05\u7A7A\u8BF7\u6C42\u8BB0\u5F55
+  console [--clear]          \u67E5\u770B/\u6E05\u7A7A\u63A7\u5236\u53F0\u6D88\u606F
+  errors [--clear]           \u67E5\u770B/\u6E05\u7A7A JS \u9519\u8BEF
+  trace start|stop|status    \u5F55\u5236\u7528\u6237\u64CD\u4F5C
+Daemon \u7BA1\u7406\uFF1A
+  daemon / start       \u524D\u53F0\u542F\u52A8 Daemon
+  stop                 \u505C\u6B62 Daemon
+  status               \u67E5\u770B Daemon \u72B6\u6001
+  reload               \u91CD\u8F7D\u6269\u5C55\uFF08\u9700\u8981 CDP \u6A21\u5F0F\uFF09
 \u9009\u9879\uFF1A
-  --json          \u4EE5 JSON \u683C\u5F0F\u8F93\u51FA
-  -i, --interactive \u53EA\u8F93\u51FA\u53EF\u4EA4\u4E92\u5143\u7D20\uFF08snapshot \u547D\u4EE4\uFF09
-  -c, --compact   \u79FB\u9664\u7A7A\u7ED3\u6784\u8282\u70B9\uFF08snapshot \u547D\u4EE4\uFF09
-  -d, --depth <n> \u9650\u5236\u6811\u6DF1\u5EA6\uFF08snapshot \u547D\u4EE4\uFF09
+  --json               \u4EE5 JSON \u683C\u5F0F\u8F93\u51FA
+  -i, --interactive    \u53EA\u8F93\u51FA\u53EF\u4EA4\u4E92\u5143\u7D20\uFF08snapshot \u547D\u4EE4\uFF09
+  -c, --compact        \u79FB\u9664\u7A7A\u7ED3\u6784\u8282\u70B9\uFF08snapshot \u547D\u4EE4\uFF09
+  -d, --depth <n>      \u9650\u5236\u6811\u6DF1\u5EA6\uFF08snapshot \u547D\u4EE4\uFF09
   -s, --selector <sel> \u9650\u5B9A CSS \u9009\u62E9\u5668\u8303\u56F4\uFF08snapshot \u547D\u4EE4\uFF09
-  --tab <tabId>   \u6307\u5B9A\u64CD\u4F5C\u7684\u6807\u7B7E\u9875 ID
-  --mcp           \u542F\u52A8 MCP server\uFF08\u7528\u4E8E Claude Code / Cursor \u7B49 AI \u5DE5\u5177\uFF09
-  --help, -h      \u663E\u793A\u5E2E\u52A9\u4FE1\u606F
-  --version, -v   \u663E\u793A\u7248\u672C\u53F7
-\u793A\u4F8B\uFF1A
-  bb-browser open https://example.com
-  bb-browser snapshot --json
-  bb-browser click @5
-  bb-browser fill @3 "hello world"
-  bb-browser type @3 "append text"
-  bb-browser get text @5
-  bb-browser get url
-  bb-browser press Enter
-  bb-browser press Control+a
-  bb-browser daemon
-  bb-browser stop
+  --tab <tabId>        \u6307\u5B9A\u64CD\u4F5C\u7684\u6807\u7B7E\u9875 ID
+  --mcp                \u542F\u52A8 MCP server\uFF08\u7528\u4E8E Claude Code / Cursor \u7B49 AI \u5DE5\u5177\uFF09
+  --help, -h           \u663E\u793A\u5E2E\u52A9\u4FE1\u606F
+  --version, -v        \u663E\u793A\u7248\u672C\u53F7
 `.trim();
 function parseArgs(argv) {
   const args = argv.slice(2);