A CDP-based CLI + MCP Server that lets AI agents control the user's real Chrome browser with full login state, backed by 36 platform community adapters.
bb-browser is a browser control tool for AI agents that connects to the user's local, already-logged-in Chrome browser via Chrome DevTools Protocol (CDP) WebSocket, fully reusing cookies and login state without additional authentication. It offers both a standalone CLI and an MCP Server mode, directly callable by AI IDEs like Claude Code and Cursor.
Key features include: universal browser automation commands (open, snapshot, click, fill, eval, fetch, network, screenshot), a community-driven site adapter system called bb-sites (covering 36 platforms with 103 commands using a three-tier complexity model for easy contribution), JSON output with inline jq filtering, concurrent multi-tab operations via --tab, a Daemon background process mode, and OpenClaw integration.
The adapter system uses a three-tier complexity model: Tier 1 — Cookie fetch (e.g., Reddit, GitHub, ~1 min to write); Tier 2 — Bearer + CSRF token (e.g., Twitter, Zhihu, ~3 min); Tier 3 — Webpack injection / Pinia store (e.g., Twitter search, Xiaohongshu, ~10 min).
Typical use cases span cross-platform information aggregation (arXiv, Twitter, GitHub, Zhihu, etc.), real-time financial data retrieval (Xueqiu, East Money), social media monitoring, video content extraction (YouTube, Bilibili subtitles/transcripts), job search, and general browser automation testing.
Built with TypeScript in a pnpm monorepo (Turborepo), it requires Node.js ≥ 18 and a Chrome browser.
Installation & Usage:
npm install -g bb-browser
bb-browser site update
bb-browser site zhihu/hot
bb-browser site twitter/search "AI agent"
MCP Integration:
{
"mcpServers": {
"bb-browser": {
"command": "npx",
"args": ["-y", "bb-browser", "--mcp"]
}
}
}
Unconfirmed: Author/team background (author field empty in package.json), standalone website (none found), Chrome extension installation steps (not detailed in README), OpenClaw integration details, PRIVACY.md contents, LICENSE year marked as 2026 (possible typo), full syntax for low-level browser commands, relationship between Daemon and Chrome extension modes.