# epiral/bb-browser

Your browser is the API. CLI + MCP server for AI agents to control Chrome with your login state.

Repository: https://github.com/epiral/bb-browser
Canonical: https://ross.abutalabs.com/products/bb-browser
Language: TypeScript
License: MIT
License Family: permissive
Last push: 2026-05-29T08:14:51+00:00

## Health v2 (maintenance only)
Score: 70/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 84, release rhythm 83, longevity 15
- inputs: {"age_days": 214, "days_push": 96, "days_rel": 114, "gap_med": 0.5, "n_releases_24m": 21}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 6128, forks 599 (observed 2026-08-28T04:09:36.276925+00:00)

## What it is
bb-browser is a TypeScript CLI and MCP server that lets AI agents control your real Chrome browser using your existing login state, exposing 103 commands across 36 platforms (Twitter, Zhihu, YouTube, arXiv, etc.). It works by running eval/fetch inside your logged-in browser tabs, so websites see requests as coming from the authenticated user rather than a bot.

## Use cases
- let AI agents search Twitter or Reddit using my logged-in session
- fetch YouTube video transcripts from the command line
- give Claude Code or Cursor browser access via MCP without API keys
- scrape sites that block headless browsers and scrapers
- query Zhihu trending or stock quotes through my real Chrome
- automate web tasks reusing existing cookies and complex logins

## When to choose
- you want AI agents to access sites with no public API using your real login state
- anti-bot detection breaks Playwright/Selenium or scraping libraries
- you need an MCP server for browser control in Claude Code or Cursor
- you want quick CLI commands for common site actions across many platforms

## When to avoid
- you need headless, isolated, or CI-friendly browser automation
- you require strict compliance with site terms of service regarding automated access
- you don't use Chrome or can't run a local daemon/extension
- you need scalable distributed scraping rather than single-user session reuse

## Facets
- artifact type: cli-tool
- maturity: active
- function: cli, mcp, web-scraping, browser-extension, http-client, agent-framework, developer-tools
- domain: developer-tools, crawlers, web-development
- platform: cli, browser, cross-platform
- tags: browser-automation, mcp-server, chrome-extension, login-state, ai-agents, site-adapters, anti-bot-bypass, typescript, automation, command-line, nodejs

## Member repositories
- epiral/bb-browser (main) score 70

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:09:36.276925+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T17:47:58.837351+00:00, confidence not recorded.
  - readme: https://github.com/epiral/bb-browser (fetched 2026-08-28T04:09:36.276925+00:00, sha 0be1178ce9df)
  - registry_npm: https://registry.npmjs.org/bb-browser (fetched 2026-08-29T08:44:44.394553+00:00, sha 8e241839f36e)
- Data as of 2026-08-30T08:39:29.467469+00:00.