Skip to content
← Tools / Skills
ToolBrowserbase/10 trustVerified
Browserbase Node SDK logo

Browserbase Node SDK

Official Node.js SDK for Browserbase's headless cloud browsers.

Visit official site →

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

browser automationweb agentstestingscraping

Works with

claudebrowser-usestagehandcustom

Trust score — 7/10

/10 trustVerified

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.