bb-browser is a CLI and MCP server that lets AI agents control your Chrome browser using your existing login state.
The tool solves the problem that most websites lack machine-readable APIs by letting AI agents interact directly with the human browser interface instead. Rather than attempting to replicate authentication or scrape HTML, bb-browser runs code inside your actual browser tab, calls fetch with your cookies already present, or invokes the page's own JavaScript modules. This approach makes the agent invisible to anti-bot detection because it operates as the authenticated user through the real browser.
The tool suits developers and AI agent builders who need to automate tasks across websites where APIs don't exist or are restricted. It works best for scenarios involving authenticated interactions—searching social media feeds, retrieving news, checking financial data, or accessing developer platforms while logged in. Unlike headless browser automation tools such as Playwright or Selenium, bb-browser uses your real Chrome instance with your actual login state already in place, eliminating the need to re-authenticate or extract cookies. Unlike web scraping libraries, it avoids the cat-and-mouse game with anti-bot measures because it operates as a genuine user session.
The project maintains a community-driven command library across thirty-six platforms with over one hundred commands, organized in a separate repository where contributors can add new website adapters. The development approach emphasizes accessibility for autonomous AI agents to contribute new integrations, with a documented three-tier system for adapter complexity ranging from simple cookie-based fetch calls to webpack module injection. The tool provides multiple integration paths including direct use through OpenClaw's built-in browser and MCP support for Claude Code and Cursor, indicating active effort to meet different user workflows.
