Documentation
BrowseFleet
Open-source cloud browser API for AI agents and developers. Launch managed browser sessions, scrape content, take screenshots, generate PDFs, solve CAPTCHAs, and automate the web through a simple REST API and CDP WebSocket proxy.
Key Concepts
Sessions
A session is a managed browser instance running in the cloud. You create sessions via the API, connect to them over CDP WebSocket with Puppeteer, Playwright, or Selenium, and release them when done. Sessions have configurable timeouts, viewports, stealth settings, and proxy support.
Quick Actions
For simple one-off tasks, BrowseFleet provides quick action endpoints that handle the full browser lifecycle automatically. Scrape a URL to markdown, take a screenshot, or generate a PDF with a single API call. No session management required.
Computer API
The Computer API lets you interact with browser sessions through click, type, scroll, and navigate actions. Every action returns a screenshot, making it ideal for AI agents that use vision models (Claude Computer Use, GPT-4o, Gemini) to understand and interact with web pages.
Agent
The autonomous agent endpoint accepts a task in natural language and uses an LLM (Claude or GPT-4o) to iteratively screenshot, reason, and act until the task is complete. Supports both blocking and SSE streaming modes.
Profiles
Browser profiles persist cookies and localStorage across sessions. Create a profile, use it with a session to log in to a site, and future sessions with the same profile will maintain the authenticated state.
Architecture
BrowseFleet is a single Node.js process managing Chrome instances via puppeteer-core. The REST API is served by Hono. CDP WebSocket connections are proxied transparently to browser tabs.
Client (Puppeteer / Playwright / SDK)
|
| HTTPS / WebSocket
v
+----------------------------------------------+
| BrowseFleet Server |
| |
| +----------+ +-----------+ +------------+ |
| | REST API | | CDP Proxy | | Agent Loop | |
| | (Hono) | | (WS) | | (LLM) | |
| +----+-----+ +-----+-----+ +-----+------+ |
| | | | |
| +----+--------------+--------------+------+ |
| | Browser Pool Manager | |
| +----+-------+-------+-------+-------+----+ |
| | | | | | |
| [Tab] [Tab] [Tab] [Tab] [Tab] |
| Chrome Process (puppeteer-core) |
+----------------------------------------------+
|
| SQLite (usage tracking, API keys)
v
+----------------------------------------------+
| /data — profiles, cookies, file uploads |
+----------------------------------------------+