Bb Browser

What is Bb Browser about?

Bb Browser turns a real Chrome browser into a programmable API. By running adapters inside the user's browser tab, it can issue authenticated fetch calls or invoke page‑level JavaScript, allowing AI agents to query and manipulate sites exactly as the logged‑in user would.

How to use Bb Browser?

1. Install the CLI globally:

   npm install -g bb-browser
   

2. Run commands directly:

   bb-browser site twitter/search "AI agent"
   bb-browser site wikipedia/summary "Python"
   

3. Add to an MCP client (e.g., Claude Code, Cursor) by adding the following to the client’s configuration:

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

4. Optional: use the Chrome extension (stand‑alone mode) or OpenClaw integration for environments without the extension.

Key Features of Bb Browser

• Leverages real login state – no need to manage cookies or tokens; the browser already has them.
• 103 commands across 36 platforms – ranging from social feeds to finance data.
• CLI, daemon, and MCP interfaces – flexible integration with scripts, servers, or AI agents.
• JSON/JQ output – easy downstream processing.
• Multi‑tab concurrency – operate on several tabs simultaneously.
• Built‑in automation primitives – click, fill, evaluate JS, capture network traffic, screenshots, etc.
• Zero‑bot detection – the website sees a genuine user.

Use Cases of Bb Browser

• Research assistants: fetch latest papers, tweets, and forum discussions on a topic in a single command.
• Job hunting bots: search and retrieve detailed listings from BOSS Zhipin or LinkedIn using the user's account.
• Financial monitoring: obtain real‑time stock quotes and watchlists from Xueqiu, Eastmoney, or Yahoo Finance.
• Content aggregation: collect headlines, newsflash, or hot topics from multiple news sites.
• Custom browser automation: programmatically click, fill forms, or scrape data from any site without writing Selenium scripts.
• AI‑driven agents: give language models direct internet access for planning, verification, or data enrichment.

FAQ

Q: Do I need a Chrome extension? A: Only when not using OpenClaw. The extension provides the bridge between the daemon and the real Chrome instance.

Q: Will my credentials be exposed? A: No. All operations run inside your own browser context; adapters merely invoke fetch or page JavaScript with existing cookies.

Q: Can I run Bb Browser on a headless server? A: The tool is designed for a real Chrome UI. For headless scenarios you would need to run a remote Chrome instance with a UI (e.g., via VNC) or use OpenClaw.

Q: How do I add support for a new website? A: Use bb-browser guide to generate an adapter template, reverse‑engineer the network request with --with-body, implement the command, and submit a PR to the bb-sites repo.

Q: How is the MCP server started? A: The daemon launches automatically when you run any bb-browser command with --mcp; it listens on localhost:19824 by default.

bb-browser

BadBoy Browser

Your browser is the API. No keys. No bots. No scrapers.

English · 中文

---

You're already logged into Twitter, Reddit, YouTube, Zhihu, Bilibili, LinkedIn, GitHub — bb-browser lets AI agents use that directly.

bb-browser site twitter/search "AI agent"       # search tweets
bb-browser site zhihu/hot                        # trending on Zhihu
bb-browser site arxiv/search "transformer"       # search papers
bb-browser site eastmoney/stock "茅台"            # real-time stock quote
bb-browser site boss/search "AI engineer"        # search jobs
bb-browser site wikipedia/summary "Python"       # Wikipedia summary
bb-browser site youtube/transcript VIDEO_ID      # full transcript
bb-browser site stackoverflow/search "async"     # search SO questions

103 commands across 36 platforms. All using your real browser's login state. Full list →

The idea

The internet was built for browsers. AI agents have been trying to access it through APIs — but 99% of websites don't offer one.

bb-browser flips this: instead of forcing websites to provide machine interfaces, let machines use the human interface directly. The adapter runs eval inside your browser tab, calls fetch() with your cookies, or invokes the page's own webpack modules. 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	Invisible — it IS the user
Complex auth	Can't replicate	Reverse engineer	Page handles it itself

Quick Start

Install

npm install -g bb-browser

Use

bb-browser site update        # pull community adapters
bb-browser site recommend     # see which adapters match your browsing habits
bb-browser site zhihu/hot     # go

OpenClaw (no extension needed)

If you use OpenClaw, bb-browser runs directly through OpenClaw's built-in browser — no Chrome extension or daemon required:

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

Skill on ClawHub: bb-browser-openclaw

Chrome Extension (standalone mode)

For use without OpenClaw (Claude Code MCP, standalone CLI):

1. Download from Releases
2. Unzip → chrome://extensions/ → Developer Mode → Load unpacked

MCP (Claude Code / Cursor)

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

36 platforms, 103 commands

Community-driven via bb-sites. One JS file per command.

Category	Platforms	Commands
Search	Google, Baidu, Bing, DuckDuckGo, Sogou WeChat	search
Social	Twitter/X, Reddit, Weibo, Xiaohongshu, Jike, LinkedIn, Hupu	search, feed, thread, user, notifications, hot
News	BBC, Reuters, 36kr, Toutiao, Eastmoney	headlines, search, newsflash, hot
Dev	GitHub, StackOverflow, HackerNews, CSDN, cnblogs, V2EX, Dev.to, npm, PyPI, arXiv	search, issues, repo, top, thread, package
Video	YouTube, Bilibili	search, video, transcript, popular, comments, feed
Entertainment	Douban, IMDb, Genius, Qidian	movie, search, top250
Finance	Xueqiu, Eastmoney, Yahoo Finance	stock, hot stocks, feed, watchlist, search
Jobs	BOSS Zhipin, LinkedIn	search, detail, profile
Knowledge	Wikipedia, Zhihu, Open Library	search, summary, hot, question
Shopping	SMZDM	search deals
Tools	Youdao, GSMArena, Product Hunt, Ctrip	translate, phone specs, trending products

10 minutes to add any website

bb-browser guide    # full tutorial

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.

Three tiers of adapter complexity:

Tier	Auth method	Example	Time
1	Cookie (fetch directly)	Reddit, GitHub, V2EX	~1 min
2	Bearer + CSRF token	Twitter, Zhihu	~3 min
3	Webpack injection / Pinia store	Twitter search, Xiaohongshu	~10 min

We tested this: 20 AI agents ran in parallel, each independently reverse-engineered a website and produced a working adapter. The marginal cost of adding a new website to the agent-accessible internet is approaching zero.

What this means for AI agents

Without bb-browser, an AI agent's world is: files + terminal + a few APIs with keys.

With bb-browser: files + terminal + the entire internet.

An agent can now, in under a minute:

# Cross-platform research on any topic
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

Six platforms, six dimensions, structured JSON. Faster and broader than any human researcher.

Also a full browser automation tool

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

All commands support --json output, --jq <expr> for inline filtering, and --tab <id> for concurrent multi-tab operations.

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

bb-browser site info xueqiu/stock   # view adapter args, example, domain

Daemon configuration

The daemon binds to localhost:19824 by default. You can customize the host with --host:

bb-browser daemon --host 127.0.0.1    # IPv4 only (fix macOS IPv6 issues)
bb-browser daemon --host 0.0.0.0      # listen on all interfaces (for Tailscale / ZeroTier remote access)

Architecture

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

License

MIT