Browserbase Node SDK
Official Node.js SDK for Browserbase's headless cloud browsers.
About
The official Node.js/TypeScript SDK for Browserbase, the headless browser infrastructure behind Stagehand and many web agents. It wraps the Sessions API: create cloud browser sessions (with region, proxy, and fingerprint options), get a CDP connect URL, then drive the browser with Playwright or Puppeteer via chromium.connectOverCDP(). The SDK is a thin, typed REST client (@browserbasehq/sdk on npm, Apache-2.0); the heavy lifting — stealth browsers, residential proxies, session recording — lives in the Browserbase platform itself. Node 18+ required. Note: the deprecated browserbase/js-sdk repo is archived — use sdk-node.
What it can do
- **sessions.create()**: spin up cloud browser sessions with region, proxy, fingerprinting, and metadata options
- **CDP connect URL**: every session returns connectUrl for playwright-core / puppeteer attach via connectOverCDP
- **Session metadata**: id, status, region, expiration, userMetadata for tracking test suites or agent runs
- **Proxy support**: built-in or external proxies per session (external proxies require a paid plan)
- **Stagehand compatibility**: same Browserbase API key powers @browserbasehq/stagehand AI browser actions
Setup
```bash
npm install @browserbasehq/sdk playwright-core
```
```ts
import { chromium } from "playwright-core";
import { Browserbase } from "@browserbasehq/sdk";
const bb = new Browserbase({ apiKey: process.env.BROWSERBASE_API_KEY });
const session = await bb.sessions.create({ region: "us-west-2" });
const browser = await chromium.connectOverCDP(session.connectUrl);
const page = browser.contexts()[0].pages()[0];
await page.goto("https://example.com");
// ... use page ...
await browser.close();
```
Create sessions close to the point of use — an unconnected session terminates after 5 minutes.
Prerequisites
Node.js 18+ A Browserbase API key (BROWSERBASE_API_KEY) from browserbase.com.
Use cases
Works with
Trust score — 7/10
Scored 7/10 (verified tier, metrics-v1). Evidence: 66 GitHub stars (log-scaled vs catalog peers); blended with ~10,604,111 monthly package downloads; last push 18d ago; 20 releases/12mo; 22 open issues. Manual review: repo is browserbase/sdk-node (not browserbasehq/sdk-typescript); only 66★ — platform signal outweighs SDK traction; npm `browserbase` is UNRELATED package; unconnected sessions terminate after 5 min. License: Apache-2.0.
★ 66 GitHub stars
How the trust score is built
Full methodology →- Adoption · stars/downloads, log-scaled vs peers
- 5.8/10
- Maintenance · recency, releases, issue load
- 7.7/10
- Openness · license + docs
- 10.0/10
- Manual review · sanity read + red-flag check
- 7.0/10
- · 66 GitHub stars (log-scaled vs catalog peers)
- · blended with ~10,604,111 monthly package downloads
- · last push 18d ago; 20 releases/12mo; 22 open issues
- · manual review: repo is browserbase/sdk-node (not browserbasehq/sdk-typescript); only 66★ — platform signal outweighs SDK traction; npm `browserbase` is UNRELATED package; unconnected sessions terminate after 5 min
Sources
Every fact above was checked against these sources. Where a claim comes from the provider and couldn't be independently verified, the text says so.