bb-browser
Your browser is the API. CLI + MCP server for AI agents to control Chrome with your login state.
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Badge for your README
Markdown
[](/listings/epiral-bb-browser)HTML
<a href="/listings/epiral-bb-browser"><img src="/api/listings/epiral-bb-browser/badge.svg" alt="findsafeskills safety rating" /></a>Install
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
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](https://openclaw.ai), 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](https://clawhub.ai/yan5xu/bb-browser)
MCP (Claude Code / Cursor)
{
"mcpServers": {
"bb-browser": {
"command": "npx",
"args": ["-y", "bb-browser", "--mcp"]
}
}
}What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
README.md · README · 194 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
- <div align="center">
- # bb-browser
- ### BadBoy Browser
- **Your browser is the API. No keys. No bots. No scrapers.**
- [](https://www.npmjs.com/package/bb-browser)
- [](https://nodejs.org)
- [](LICENSE)
- [English](README.md) · [中文](README.zh-CN.md)
- </div>
- ---
- You're already logged into Twitter, Reddit, YouTube, Zhihu, Bilibili, LinkedIn, GitHub — bb-browser lets AI agents **use that directly**.
- ```bash
- 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 →](https://github.com/epiral/bb-sites)
- ## 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
- ```bash
- npm install -g bb-browser
- ```
- ### Use
- ```bash
- 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](https://openclaw.ai), bb-browser runs directly through OpenClaw's built-in browser — no Chrome extension or daemon required:
- ```bash
- bb-browser site reddit/hot --openclaw
- bb-browser site xueqiu/hot-stock 5 --openclaw --jq '.items[] | {name, changePercent}'
- ```
- Skill on ClawHub: [bb-browser-openclaw](https://clawhub.ai/yan5xu/bb-browser)
- ### MCP (Claude Code / Cursor)
- ```json
- {
- "mcpServers": {
- "bb-browser": {
- "command": "npx",
- "args": ["-y", "bb-browser", "--mcp"]
- }
- }
- }
- ```
- ## 36 platforms, 103 commands
- Community-driven via [bb-sites](https://github.com/epiral/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
- ```bash
- 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:
- ```bash
- # 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
- ```bash
- 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.
- ```bash
- 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 `127.0.0.1:19824` by default. You can customize the host with `--host`:
- ```bash
- 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 ──CDP WebSocket──▶ Your Real Browser
- │
- ┌──────┴──────┐
- │ Per-tab │
- │ event cache │
- │ (network, │
- │ console, │
- │ errors) │
- └─────────────┘
- ```
- ## License
- [MIT](LICENSE)
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.