Airbrowser

Open-source browser automation API with anti-detection — Undetectable Chrome for AI agents, web scraping, and automation. REST API + MCP server + VNC debugging. Selenium/Playwright alternative that bypasses Cloudflare.

Quick Start

Cloud Hosted (no setup)

Use the managed cloud version - no installation required:

https://airbrowser.dev

Docker (one-liner)

docker run -d -p 18080:18080 --name airbrowser ghcr.io/ifokeev/airbrowser-mcp:latest

Portable Downloads

Download and run - no Docker knowledge required:

Platform	Download	Requirements
Linux	airbrowser-linux.tar.gz	uidmap package or Docker
macOS	airbrowser-mac.tar.gz	Colima, Docker Desktop, or Podman
Windows	airbrowser-windows.zip	Docker Desktop or Podman

# Linux/macOS
tar -xzf airbrowser-*.tar.gz && cd airbrowser-* && ./airbrowser

# Windows: Extract zip and double-click airbrowser.bat

From Source

git clone https://github.com/ifokeev/airbrowser-mcp.git
cd airbrowser-mcp
docker compose up --build

---

Open http://localhost:18080 - all services available:

Service	Path
Dashboard	/
API Docs	/docs/
REST API	/api/v1/
MCP Server	/mcp
VNC Viewer	/vnc/

Features

• Undetected Chrome (SeleniumBase UC)
• 100+ concurrent browsers
• Persistent profiles & cookies
• Tab management
• Proxy per browser (DataImpulse recommended)
• MCP for AI agents
• AI vision tools (optional)

AI Vision (Recommended)

Enable AI-powered vision tools (what_is_visible, detect_coordinates) by setting your OpenRouter API key. Without it, these tools won't be available to AI agents.

# Docker run
docker run -d -p 18080:18080 -e OPENROUTER_API_KEY=sk-or-v1-xxx ghcr.io/ifokeev/airbrowser-mcp:latest

# Docker compose
OPENROUTER_API_KEY=sk-or-v1-xxx docker compose up

Get your API key at https://openrouter.ai/

MCP Client Configuration

Add airbrowser to your AI coding assistant:

Claude Code

claude mcp add airbrowser --transport http http://localhost:18080/mcp

Cursor

Go to Cursor Settings → MCP → Add new MCP Server:

{
  "mcpServers": {
    "airbrowser": {
      "url": "http://localhost:18080/mcp",
      "transport": "http"
    }
  }
}

VS Code / Copilot

Add to your MCP settings:

{
  "mcpServers": {
    "airbrowser": {
      "url": "http://localhost:18080/mcp",
      "transport": "http"
    }
  }
}

Cline

Follow Cline MCP guide with:

{
  "mcpServers": {
    "airbrowser": {
      "url": "http://localhost:18080/mcp",
      "transport": "http"
    }
  }
}

Windsurf

Follow the Windsurf MCP guide with the config above.

Test your setup

Navigate to https://example.com and take a screenshot

Your AI assistant should create a browser, navigate to the URL, and return a screenshot.

Generated Clients

Auto-generated from OpenAPI spec:

# Python
pip install airbrowser-client

# TypeScript
npm install airbrowser-client

Docs

• docs/ - Full documentation
• examples/ - Code samples

License

Fair Source - Free for up to 10 users. Cannot be offered as a hosted service. Commercial license required for larger deployments.