Summary

bb-browser enables AI agents to interact with the internet by controlling a real Chrome browser, bypassing the lack of website APIs. It leverages existing user login states, allowing agents to access web content and functionality as human users, thus circumventing API limitations and anti-bot measures.

How It Works

The system uses a CLI/MCP server that communicates with a daemon, which interfaces with a Chrome extension via SSE. The extension employs Chrome Debugging Protocol (CDP) to control the user's real browser, executing JavaScript, using authenticated fetch requests, or calling page modules. Its primary advantage is invisibility to anti-bot systems, as it operates through an authenticated user session, making AI interactions indistinguishable from human activity.

Quick Start & Requirements

• Installation: npm install -g bb-browser
• Prerequisites: Node.js 18+ and Google Chrome.
• Usage: Can run standalone with a Chrome extension or integrated with OpenClaw. MCP server configuration is provided for AI agent platforms.
• Documentation: Full tutorial via bb-browser guide.

Highlighted Details

• Extensive Support: 103 commands across 36 platforms (social, news, dev, video, finance, jobs, etc.).
• Rapid Adapter Development: Community-driven bb-sites allow quick addition of new website integrations, with complex adapters taking ~10 minutes. Adapters support various auth methods.
• Full Browser Automation: Provides general browser control: opening URLs, screenshots, clicks, form fills, JS evaluation, network capture.
• Structured Output: Commands support --json output with --jq <expr> for inline filtering.

Maintenance & Community

The project is community-driven via its bb-sites repository, encouraging contributions for new website adapters. Specific community links are not detailed.

Licensing & Compatibility

Released under the MIT License, which is permissive for commercial use and integration into closed-source applications.

Limitations & Caveats

Requires a running Google Chrome instance and either a Chrome extension or OpenClaw integration. While adapter development is streamlined, reverse-engineering highly dynamic websites may still present challenges.