Appearance
Install
Cloud (managed) -- recommended
No server install needed. Get an API key at browserless.io/account, then install the client library for your language.
Puppeteer (Node.js)
bash
npm install puppeteer-corePlaywright (Node.js)
bash
npm install playwright-corePlaywright (Python)
bash
pip install playwrightSet your API key in the environment:
bash
export BROWSERLESS_API_KEY=your_token_hereSelf-hosted via Docker
Run Browserless locally on port 3000 using the official container image:
bash
docker run -p 3000:3000 ghcr.io/browserless/chromiumFor Firefox:
bash
docker run -p 3000:3000 ghcr.io/browserless/firefoxFor all browser types (Chromium + Firefox + WebKit):
bash
docker run -p 3000:3000 ghcr.io/browserless/multiAfter launch, the interactive API docs are available at http://localhost:3000/docs and the WebSocket endpoint is at ws://localhost:3000.
MCP server (for AI agents)
The Browserless MCP server needs no local install. Register the remote endpoint in your Claude/LangChain config:
https://mcp.browserless.io/mcpPass your API token as token in the connection URL or via the Authorization header.