想拿 Twitter 的搜尋結果，傳統做法有三條路：申請 API key（限制一堆）、寫爬蟲（被封 IP）、用 Playwright 開 headless browser（被偵測到不是真人）。

bb-browser 走第四條路：直接用你已經開著的 Chrome。你登入過 Twitter，cookie 已經在那邊了，bb-browser 就在那個標籤裡跑 fetch()，從網站的角度看，這就是你本人在瀏覽。

跟爬蟲和 Playwright 差在哪

先把差異講清楚。

關鍵在於 bb-browser 不啟動新的瀏覽器實例。它透過 CDP（Chrome DevTools Protocol）連到你正在用的 Chrome，在標籤裡注入程式碼。網站看到的 User-Agent、cookie、TLS 指紋全部都是真的，因為本來就是你的瀏覽器。

架構

1
2
3
4
5
6
7
8
9

AI Agent (Claude Code, Codex, Cursor)
         │ CLI 或 MCP (stdio)
         ▼
bb-browser CLI ──HTTP──▶ Daemon ──CDP WebSocket──▶ 真實瀏覽器
                            │
                     ┌──────┴──────┐
                     │ 每標籤事件快取│
                     │ (網路、控制台)│
                     └─────────────┘

bb-browser 會起一個 daemon（預設 127.0.0.1:19824），透過 CDP WebSocket 跟 Chrome 溝通。CLI 指令送到 daemon，daemon 在對應的標籤裡執行。

安裝和基本用法

1

npm install -g bb-browser

拉取社群適配器：

1

bb-browser site update

跑一條命令試試：

1

bb-browser site zhihu/hot

這會打開知乎的標籤（如果你已經登入），用你的 cookie 去撈熱門問題列表。

結構化輸出

所有命令都支援 --json 和 --jq：

1
2
3

bb-browser site xueqiu/hot-stock 5 --jq '.items[] | {name, changePercent}'
# {"name":"云天化","changePercent":"2.08%"}
# {"name":"东芯股份","changePercent":"-7.60%"}

瀏覽器操作

除了跑適配器，也能直接操作瀏覽器：

1
2
3
4
5
6
7

bb-browser open https://example.com     # 開啟 URL
bb-browser snapshot -i                  # 無障礙樹快照
bb-browser click @3                     # 點擊元素
bb-browser fill @5 "hello"             # 填入文字
bb-browser eval "document.title"       # 執行 JavaScript
bb-browser fetch URL --json            # 帶認證的 fetch
bb-browser screenshot                  # 截圖

36 個平台、103 條命令

bb-browser 的適配器涵蓋的平台很廣：

• 搜尋：Google、百度、Bing、DuckDuckGo
• 社交：Twitter/X、Reddit、微博、小紅書、LinkedIn
• 開發：GitHub、StackOverflow、Hacker News、npm、PyPI、arXiv、V2EX、Dev.to
• 新聞：BBC、Reuters、36kr、今日頭條
• 影片：YouTube、Bilibili
• 金融：雪球、Yahoo Finance、東方財富
• 知識：Wikipedia、知乎

每個適配器就是一個 JavaScript 檔案，社群驅動。要加新平台，寫一個 JS 檔丟到 bb-sites repo 就好。

適配器的三種複雜度

不是每個網站都一樣好搞。bb-browser 把適配器分成三層：

Level 1 最簡單，有些網站的 API 只要帶 cookie 就能用。Level 3 最複雜，要反向工程前端打包的模組，從 Webpack 的 __webpack_require__ 或 Vue 的 Pinia store 裡撈資料。

當 MCP Server 給 AI Agent 用

這是 bb-browser 最有意思的用法。設定成 MCP server 之後，Claude Code 或 Cursor 就能直接存取你的瀏覽器能看到的所有網站。

1
2
3
4
5
6
7
8

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

設好之後，你可以跟 Claude Code 說「幫我查一下 arXiv 上最近的 RAG 論文」，它就會透過 bb-browser 去 arXiv 搜尋，用你的真實瀏覽器。

沒有 bb-browser 的 AI agent 只能操作檔案和終端。有了 bb-browser，它能存取整個網際網路——用你的身份。

之前寫的 CLI-Anything 是把桌面軟體包成 CLI 給 agent 呼叫，AionUi 是統一管理多個 agent 的介面。bb-browser 則是從另一個角度擴展 agent 能力：讓它直接用你的瀏覽器上網。

注意事項

幾件事要想清楚再用：

• 用的是你的真實帳號。bb-browser 代你操作，如果操作頻率太高，帳號可能被平台標記。它不是隱形的爬蟲，它就是你
• 安全性。daemon 預設只綁 localhost，但如果開到 0.0.0.0，任何能連到你機器的人都能操作你的瀏覽器。搭配 Tailscale 或 ZeroTier 用比較安全
• 適配器品質不一。社群驅動的好處是覆蓋廣，壞處是有些適配器可能跟不上網站改版
• macOS 用戶注意 IPv6 問題，daemon 要加 --host 127.0.0.1

適合什麼場景

bb-browser 不是拿來大規模爬資料的。如果你要爬百萬筆資料，還是用 Scrapy。

它適合的場景是：

• 讓 AI agent 能查網路資料，不需要一個一個申請 API key
• 快速從某個已登入的平台撈結構化資料
• 跨平台研究——一分鐘內同時查 arXiv、Twitter、GitHub、知乎、StackOverflow

一條指令就能完成以前要寫爬蟲才能做的事，而且不會被擋。

參考資源

• bb-browser GitHub Repository
• bb-sites 社群適配器
• Chrome DevTools Protocol 文件
• Model Context Protocol 規範