bb-browser

About

bb-browser is a browser automation CLI and MCP server that lets AI agents operate Chrome with an existing browser session.

Key Features

• Use browser-session-based adapters for supported websites.
• Give agents a reusable interface for web navigation and data retrieval.

Use Cases

Navigate websites, collect page information and exercise browser workflows through an agent.

Limitations

Access is determined by the connected browser session. The OpenClaw path has different setup requirements from the Chrome extension path.

Sources

• Project documentation: https://github.com/epiral/bb-browser

MCP Setup

Prerequisites

• Node.js 18+ and npm.
• Chrome with the project extension for the standard browser connection.

Access requirements

• Uses the connected browser login sessions.

Companion app or plugin

Name: bb-browser extension Install URL: https://github.com/epiral/bb-browser

• Follow the extension setup in the repository.

The documented OpenClaw CLI route is a separate option that does not need the extension.

Client setup

Cursor

Transport: stdio

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

• Install bb-browser: npm install -g bb-browser
• Connect the browser according to the README extension guide.

Setup docs: https://github.com/epiral/bb-browser