by epiral
Enables AI agents to interact with any website through the user's logged‑in Chrome instance, exposing site‑specific commands via a CLI or MCP server.
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.
npm install -g bb-browser
bb-browser site twitter/search "AI agent"
bb-browser site wikipedia/summary "Python"
{
"mcpServers": {
"bb-browser": {
"command": "npx",
"args": ["-y", "bb-browser", "--mcp"]
}
}
}
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.
Your browser is the API. No keys. No bots. No scrapers.
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 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 |
npm install -g bb-browser
bb-browser site update # pull community adapters
bb-browser site recommend # see which adapters match your browsing habits
bb-browser site zhihu/hot # go
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
For use without OpenClaw (Claude Code MCP, standalone CLI):
chrome://extensions/ → Developer Mode → Load unpacked{
"mcpServers": {
"bb-browser": {
"command": "npx",
"args": ["-y", "bb-browser", "--mcp"]
}
}
}
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 |
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.
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.
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
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)
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
Please log in to share your review and rating for this MCP.
Explore related MCPs that share similar capabilities and solve comparable challenges
by modelcontextprotocol
A Model Context Protocol server that provides web content fetching capabilities.
by microsoft
Provides fast, lightweight browser automation using Playwright's accessibility tree, enabling LLMs to interact with web pages through structured snapshots instead of screenshots.
by firecrawl
Provides powerful web scraping capabilities for LLM clients such as Cursor, Claude, and others, enabling content extraction, crawling, search, and batch processing through a Model Context Protocol server.
by firecrawl
Provides web scraping, crawling, search, and structured data extraction for LLM clients through a Model Context Protocol server.
by brightdata
Provides real-time web access for AI models, delivering search, markdown‑ready scraping, and optional browser automation while bypassing geo‑restrictions, rate limits, and CAPTCHAs.
by tavily-ai
Provides real‑time web search, intelligent data extraction, structured website mapping, and systematic crawling through an MCP server, ready to be integrated with AI coding assistants and other tools.
by zcaceres
Fetches web content and returns it in HTML, JSON, plain‑text, or Markdown formats, optionally applying custom request headers.
by hyperbrowserai
Provides tools to scrape, extract structured data, crawl webpages, and access general‑purpose browser agents such as OpenAI CUA, Anthropic Claude Computer Use, and lightweight Browser Use via a Model Context Protocol server.
by tinyfish-io
Extract structured data from any web page by invoking AgentQL's extraction tool through a Model Context Protocol server, enabling AI assistants to retrieve and format web information on demand.
{
"mcpServers": {
"bb-browser": {
"command": "npx",
"args": [
"-y",
"bb-browser",
"--mcp"
]
}
}
}claude mcp add bb-browser npx -y bb-browser --mcp