Quickstart
From zero to a
running browser.
Three steps. The only BrowserFleet-specific part is creating the session — everything after that is the CDP client you already know.
1 · Get a key
Sign up and copy your API key. New accounts get $2 of credit, which is five hours on Apple Silicon or forty on Standard.
Get an API key2 · Install
npm i @browserfleet/sdkThe SDK is a thin client over the REST API. You can skip it entirely and
call the API with fetch if you prefer.
3 · Drive it
// npm i @browserfleet/sdk
import { BrowserFleet } from "@browserfleet/sdk";
import { chromium } from "playwright";
const bf = new BrowserFleet({ apiKey: process.env.BROWSERFLEET_API_KEY });
// a real Chrome on Apple Silicon
const session = await bf.createSession({
image: "chrome-stable",
machineClass: "mac-shared",
});
const browser = await chromium.connectOverCDP(BrowserFleet.cdpUrl(session));
const page = await browser.newPage();
await page.goto("https://example.com");
await bf.endSession(session.id); // billing stopsChoosing a machine
Which class should you use?
mac-sharedflagship
Real Apple M2 hardware and a Metal GPU. Use it when the fingerprint is the point — the sites you need are reading the GPU and the platform.
browser-standard
Headful real Chrome on Linux at $0.05/hr. The sensible default for volume work where a Linux platform string is acceptable.
browser-perf
3 vCPU and 6 GB for heavy pages — video, WebGL, or a site that fights back with expensive JavaScript.
Transports
Every session exposes cdp. Interactive sessions
(vnc: true) also expose vnc for a live view and control for
server-side input that moves a real cursor — useful when you want to watch a run, or take over one
by hand.
Point your existing code at a real Mac.
Sign up, take the $2 of trial credit and run a session — five hours on Apple Silicon, enough to check the fingerprint against whatever has been blocking you.