Skip to content

Install

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-core

Playwright (Node.js)

bash
npm install playwright-core

Playwright (Python)

bash
pip install playwright

Set your API key in the environment:

bash
export BROWSERLESS_API_KEY=your_token_here

Self-hosted via Docker

Run Browserless locally on port 3000 using the official container image:

bash
docker run -p 3000:3000 ghcr.io/browserless/chromium

For Firefox:

bash
docker run -p 3000:3000 ghcr.io/browserless/firefox

For all browser types (Chromium + Firefox + WebKit):

bash
docker run -p 3000:3000 ghcr.io/browserless/multi

After 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/mcp

Pass your API token as token in the connection URL or via the Authorization header.