{"id":34658773,"url":"https://github.com/ifokeev/airbrowser-mcp","last_synced_at":"2026-01-13T20:30:58.091Z","repository":{"id":330740972,"uuid":"1121858903","full_name":"ifokeev/airbrowser-mcp","owner":"ifokeev","description":"Undetectable Chrome for AI agents, web scraping, and automation. REST API + MCP server + VNC debugging.","archived":false,"fork":false,"pushed_at":"2026-01-04T13:37:23.000Z","size":1184,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2026-01-06T23:15:41.238Z","etag":null,"topics":["ai-agents","browser-automation","chrome","mcp","selenium","seleniumbase","web-scraping"],"latest_commit_sha":null,"homepage":"https://ifokeev.github.io/airbrowser-mcp/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ifokeev.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null}},"created_at":"2025-12-23T17:10:27.000Z","updated_at":"2026-01-06T23:09:46.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/ifokeev/airbrowser-mcp","commit_stats":null,"previous_names":["ifokeev/airbrowser-mcp"],"tags_count":8,"template":false,"template_full_name":null,"purl":"pkg:github/ifokeev/airbrowser-mcp","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ifokeev%2Fairbrowser-mcp","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ifokeev%2Fairbrowser-mcp/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ifokeev%2Fairbrowser-mcp/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ifokeev%2Fairbrowser-mcp/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ifokeev","download_url":"https://codeload.github.com/ifokeev/airbrowser-mcp/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ifokeev%2Fairbrowser-mcp/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28399894,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-13T14:36:09.778Z","status":"ssl_error","status_checked_at":"2026-01-13T14:35:19.697Z","response_time":56,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai-agents","browser-automation","chrome","mcp","selenium","seleniumbase","web-scraping"],"created_at":"2025-12-24T18:37:57.098Z","updated_at":"2026-01-13T20:30:58.086Z","avatar_url":"https://github.com/ifokeev.png","language":"Python","readme":"# Airbrowser\n\n[![CI](https://github.com/ifokeev/airbrowser-mcp/actions/workflows/ci.yml/badge.svg)](https://github.com/ifokeev/airbrowser-mcp/actions/workflows/ci.yml)\n[![PyPI](https://img.shields.io/pypi/v/airbrowser-client?label=PyPI\u0026logo=python\u0026logoColor=white)](https://pypi.org/project/airbrowser-client/)\n[![npm](https://img.shields.io/npm/v/airbrowser-client?label=npm\u0026logo=npm)](https://www.npmjs.com/package/airbrowser-client)\n[![License](https://img.shields.io/badge/License-Fair%20Source-blue.svg)](LICENSE)\n[![Discord](https://img.shields.io/badge/Discord-Join%20us-5865F2?logo=discord\u0026logoColor=white)](https://discord.gg/dP9PbTPHcN)\n\n**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.\n\n## Quick Start\n\n### Cloud Hosted (no setup)\n\nUse the managed cloud version - no installation required:\n\n**[https://airbrowser.dev](https://airbrowser.dev)**\n\n### Docker (one-liner)\n\n```bash\ndocker run -d -p 18080:18080 --name airbrowser ghcr.io/ifokeev/airbrowser-mcp:latest\n```\n\n### Portable Downloads\n\nDownload and run - no Docker knowledge required:\n\n| Platform | Download | Requirements |\n|----------|----------|--------------|\n| Linux | [airbrowser-linux.tar.gz](https://github.com/ifokeev/airbrowser-mcp/releases/latest/download/airbrowser-linux.tar.gz) | `uidmap` package or Docker |\n| macOS | [airbrowser-mac.tar.gz](https://github.com/ifokeev/airbrowser-mcp/releases/latest/download/airbrowser-mac.tar.gz) | Colima, Docker Desktop, or Podman |\n| Windows | [airbrowser-windows.zip](https://github.com/ifokeev/airbrowser-mcp/releases/latest/download/airbrowser-windows.zip) | Docker Desktop or Podman |\n\n```bash\n# Linux/macOS\ntar -xzf airbrowser-*.tar.gz \u0026\u0026 cd airbrowser-* \u0026\u0026 ./airbrowser\n\n# Windows: Extract zip and double-click airbrowser.bat\n```\n\n### From Source\n\n```bash\ngit clone https://github.com/ifokeev/airbrowser-mcp.git\ncd airbrowser-mcp\ndocker compose up --build\n```\n\n---\n\nOpen **http://localhost:18080** - all services available:\n\n| Service | Path |\n|---------|------|\n| Dashboard | `/` |\n| API Docs | `/docs/` |\n| REST API | `/api/v1/` |\n| MCP Server | `/mcp` |\n| VNC Viewer | `/vnc/` |\n\n## Features\n\n- Undetected Chrome (SeleniumBase UC)\n- 100+ concurrent browsers\n- Persistent profiles \u0026 cookies\n- Tab management\n- Proxy per browser ([DataImpulse](https://dataimpulse.com/?aff=250254) recommended)\n- MCP for AI agents\n- AI vision tools (optional)\n\n## AI Vision (Recommended)\n\nEnable 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.\n\n```bash\n# Docker run\ndocker run -d -p 18080:18080 -e OPENROUTER_API_KEY=sk-or-v1-xxx ghcr.io/ifokeev/airbrowser-mcp:latest\n\n# Docker compose\nOPENROUTER_API_KEY=sk-or-v1-xxx docker compose up\n```\n\nGet your API key at https://openrouter.ai/\n\n## MCP Client Configuration\n\nAdd airbrowser to your AI coding assistant:\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cb\u003eClaude Code\u003c/b\u003e\u003c/summary\u003e\n\n```bash\nclaude mcp add airbrowser --transport http http://localhost:18080/mcp\n```\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cb\u003eCursor\u003c/b\u003e\u003c/summary\u003e\n\nGo to `Cursor Settings` → `MCP` → `Add new MCP Server`:\n\n```json\n{\n  \"mcpServers\": {\n    \"airbrowser\": {\n      \"url\": \"http://localhost:18080/mcp\",\n      \"transport\": \"http\"\n    }\n  }\n}\n```\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cb\u003eVS Code / Copilot\u003c/b\u003e\u003c/summary\u003e\n\nAdd to your MCP settings:\n\n```json\n{\n  \"mcpServers\": {\n    \"airbrowser\": {\n      \"url\": \"http://localhost:18080/mcp\",\n      \"transport\": \"http\"\n    }\n  }\n}\n```\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cb\u003eCline\u003c/b\u003e\u003c/summary\u003e\n\nFollow [Cline MCP guide](https://docs.cline.bot/mcp/configuring-mcp-servers) with:\n\n```json\n{\n  \"mcpServers\": {\n    \"airbrowser\": {\n      \"url\": \"http://localhost:18080/mcp\",\n      \"transport\": \"http\"\n    }\n  }\n}\n```\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cb\u003eWindsurf\u003c/b\u003e\u003c/summary\u003e\n\nFollow the [Windsurf MCP guide](https://docs.windsurf.com/windsurf/cascade/mcp) with the config above.\n\u003c/details\u003e\n\n### Test your setup\n\n```\nNavigate to https://example.com and take a screenshot\n```\n\nYour AI assistant should create a browser, navigate to the URL, and return a screenshot.\n\n## Generated Clients\n\nAuto-generated from OpenAPI spec:\n\n```bash\n# Python\npip install airbrowser-client\n\n# TypeScript\nnpm install airbrowser-client\n```\n\n## Docs\n\n- [docs/](docs/) - Full documentation\n- [examples/](examples/) - Code samples\n\n## License\n\n[Fair Source](LICENSE) - Free for up to 10 users. Cannot be offered as a hosted service. Commercial license required for larger deployments.\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fifokeev%2Fairbrowser-mcp","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fifokeev%2Fairbrowser-mcp","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fifokeev%2Fairbrowser-mcp/lists"}