🐝 BUMBLEBEE

Next-Gen Remote Anti-Detect Browser & Telemetry Server
Powered by Camoufox, Hono & Bun for Playwright & AI Agents

---

⚡ Quick Start

1. Docker (Recommended)

docker compose up -d

Visit the Web Dashboard at: 👉 http://localhost:8240/

2. Local Development (Hono + Bun)

# Install dependencies
bun install

# Run Frontend & Backend together with hot-reload
bun run dev

# Or build & start Single Production Server
bun run build
bun run start

---

🤖 AI Agent & MCP Setup (Claude, Cursor, Antigravity)

Bumblebee integrates natively with Model Context Protocol (MCP) to give AI Agents a 100% Anti-Detect stealth browser.

Add this configuration to your AI IDE or MCP client settings (e.g. claude_desktop_config.json, mcp_config.json):

{
  "mcpServers": {
    "bumblebee": {
      "command": "npx",
      "args": [
        "-y",
        "@playwright/mcp@latest",
        "--endpoint=ws://127.0.0.1:9223/ws"
      ]
    }
  }
}

• 🚀 What AI can do: Claude / Cursor can browse websites, extract live data, bypass Cloudflare / Turnstile, and automate web tasks while you watch live telemetry on http://localhost:8240/!

---

🔌 Connection Guide (Playwright)

Bumblebee exposes a remote WebSocket endpoint (ws://127.0.0.1:9223/ws) and Hono Management API (http://127.0.0.1:8240).

TypeScript / Playwright

import { firefox } from 'playwright-core';

// 1. Get dynamic endpoint (or connect directly to ws://127.0.0.1:9223/ws)
const res = await fetch('http://127.0.0.1:8240/ws');
const { ws_endpoint } = await res.json();

// 2. Connect
const browser = await firefox.connect(ws_endpoint);
const context = await browser.newContext({ viewport: null });
const page = await context.newPage();

await page.goto('https://httpbin.org/headers');
console.log(await page.innerText('body'));

await context.close();
await browser.close();

---

🛡️ Core Features

• Model Context Protocol (MCP) Ready: Plug directly into AI IDEs & Agents with @playwright/mcp.
• Single Server Architecture: Hono natively serves both the Web Dashboard SPA and the REST/SSE APIs on port 8240.
• Real-time Action & URL Inspector: Automatically intercepts Playwright RPC to monitor URLs and actions for Frontend Web UI.
• Auto-Recovery Watchdog: Automatically restarts on crash and detects frozen/deadlocked browser states every 15s.
• Full Anti-Detect: Bypasses Cloudflare Turnstile, DataDome, Akamai, Canvas/WebGL fingerprinting.
• Zero Config GeoIP: Automatically syncs timezone and locale spoofing.