# Browserbase — Cloud Browser Infra for AI Agents

> Browserbase runs managed cloud Chromium for AI agents. Stagehand, Playwright, Puppeteer compatible. Scales to 1000s of parallel sessions with replay.

## Install

Copy the content below into your project:

## Quick Use

1. Sign up at browserbase.com — copy your API key + project ID
2. `npm install @browserbasehq/stagehand`
3. Set BROWSERBASE_API_KEY + BROWSERBASE_PROJECT_ID env vars and use the Stagehand snippet below

---

## Intro

Browserbase is the cloud Chromium platform behind Stagehand and most production AI browser-automation stacks. Spin up a browser via API, drive it with Playwright or Stagehand, get back screenshots, network logs, and full session replay — without managing Chrome on your own infra. Best for: agents that need persistent browser sessions, residential proxies, or 100+ parallel scraping jobs. Works with: Stagehand, Playwright, Puppeteer, Selenium, Browser Use. Setup time: 2 minutes (sign up + API key).

---

### What you get

| Feature | Detail |
|---|---|
| **Managed Chromium** | Latest Chrome on Linux, no version drift |
| **Parallel sessions** | 100+ concurrent on Pro, scales further on Scale plan |
| **Residential proxies** | Built-in IP rotation, US/EU/Asia regions |
| **Session replay** | Full video + DOM snapshots for debugging |
| **Stealth mode** | Bypass bot detection on most major sites |
| **Persistent contexts** | Save cookies/localStorage across runs (logged-in scraping) |

### Connect from Stagehand

```typescript
import { Stagehand } from "@browserbasehq/stagehand";

const stagehand = new Stagehand({
  env: "BROWSERBASE",  // not LOCAL
  apiKey: process.env.BROWSERBASE_API_KEY,
  projectId: process.env.BROWSERBASE_PROJECT_ID,
});

await stagehand.init();

// Drive with natural language
await stagehand.act("Click the login button");
await stagehand.act("Fill in email with foo@bar.com");

// Or extract structured data
const products = await stagehand.extract({
  instruction: "Get all product names and prices on this page",
  schema: z.object({
    products: z.array(z.object({
      name: z.string(),
      price: z.number(),
    })),
  }),
});
```

### Connect from Playwright

```python
from playwright.sync_api import sync_playwright
import os

with sync_playwright() as p:
    browser = p.chromium.connect_over_cdp(
        f"wss://connect.browserbase.com?apiKey={os.environ['BROWSERBASE_API_KEY']}"
    )
    page = browser.new_page()
    page.goto("https://example.com")
    page.screenshot(path="example.png")
```

### Pricing snapshot

- **Free tier**: 1 hour of browser time / month, no credit card
- **Pro**: starts $99/mo for ~150 hours
- **Scale**: custom for >1000 hours/mo, residential proxies, dedicated infra

---

### FAQ

**Q: Is Browserbase free?**
A: Yes — there's a free tier with 1 hour of browser time per month, no credit card. Paid plans start at $99/mo for production workloads.

**Q: How is this different from Stagehand?**
A: Stagehand is the *automation library* (the natural-language API that drives the browser). Browserbase is the *infrastructure* (the cloud Chromium that Stagehand connects to). Stagehand also runs locally, but Browserbase makes it scale.

**Q: Can my AI agent stay logged in across sessions?**
A: Yes — Browserbase persistent contexts save cookies and localStorage. Pass the contextId on the next session and the browser resumes logged-in state. Critical for scraping authenticated dashboards.

---

## Source & Thanks

> Built by [Browserbase](https://github.com/browserbase). Commercial product with free tier.
>
> [browserbase/sdk-node](https://github.com/browserbase/sdk-node) — ⭐ Active SDK

---

<!-- ZH -->

## 快速使用

1. 在 browserbase.com 注册，复制 API key 和 project ID
2. `npm install @browserbasehq/stagehand`
3. 设置 BROWSERBASE_API_KEY 和 BROWSERBASE_PROJECT_ID 环境变量，用下面的 Stagehand 片段

---

## 简介

Browserbase 是 Stagehand 和大部分生产级 AI 浏览器自动化栈背后的云 Chromium 平台。通过 API 起浏览器，用 Playwright 或 Stagehand 驱动，拿回截图、网络日志、完整会话回放 —— 不用自己维护 Chrome 基础设施。适合需要持久会话、住宅代理、或 100+ 并行抓取的 agent。兼容 Stagehand / Playwright / Puppeteer / Selenium / Browser Use。装机时间 2 分钟（注册 + API key）。

---

### 你能拿到什么

| 特性 | 详情 |
|---|---|
| **托管 Chromium** | Linux 上跑最新 Chrome，没版本漂移 |
| **并行会话** | Pro 100+ 并发，Scale 套餐可继续扩 |
| **住宅代理** | 自带 IP 轮换，美/欧/亚区域 |
| **会话回放** | 完整视频 + DOM 快照，方便调试 |
| **反爬模式** | 主流站点的 bot 检测能绕开 |
| **持久上下文** | 跨任务保存 cookies / localStorage（爬登录后内容） |

### 从 Stagehand 接

```typescript
import { Stagehand } from "@browserbasehq/stagehand";

const stagehand = new Stagehand({
  env: "BROWSERBASE",  // 不是 LOCAL
  apiKey: process.env.BROWSERBASE_API_KEY,
  projectId: process.env.BROWSERBASE_PROJECT_ID,
});

await stagehand.init();

// 自然语言驱动
await stagehand.act("Click the login button");
await stagehand.act("Fill in email with foo@bar.com");

// 或提取结构化数据
const products = await stagehand.extract({
  instruction: "Get all product names and prices on this page",
  schema: z.object({
    products: z.array(z.object({
      name: z.string(),
      price: z.number(),
    })),
  }),
});
```

### 从 Playwright 接

```python
from playwright.sync_api import sync_playwright
import os

with sync_playwright() as p:
    browser = p.chromium.connect_over_cdp(
        f"wss://connect.browserbase.com?apiKey={os.environ['BROWSERBASE_API_KEY']}"
    )
    page = browser.new_page()
    page.goto("https://example.com")
    page.screenshot(path="example.png")
```

### 价格速览

- **免费档**：每月 1 小时浏览时间，不要信用卡
- **Pro**：$99/月起，约 150 小时
- **Scale**：>1000 小时/月、住宅代理、专属基础设施，谈价

---

### FAQ

**Q: Browserbase 免费吗？**
A: 有免费档，每月 1 小时浏览时间，不要信用卡。生产级工作负载从 $99/月起。

**Q: 跟 Stagehand 啥区别？**
A: Stagehand 是 *自动化库*（驱动浏览器的自然语言 API）。Browserbase 是 *基础设施*（Stagehand 连的云 Chromium）。Stagehand 也能本地跑，Browserbase 让它能扩。

**Q: agent 能跨会话保持登录吗？**
A: 能。Browserbase 持久上下文保存 cookies 和 localStorage。下次会话传同一个 contextId，浏览器恢复登录态。爬认证仪表板必备。

---

## 来源与感谢

> Built by [Browserbase](https://github.com/browserbase). Commercial product with free tier.
>
> [browserbase/sdk-node](https://github.com/browserbase/sdk-node) — ⭐ Active SDK


---
Source: https://tokrepo.com/en/workflows/browserbase-cloud-browser-infra-for-ai-agents
Author: Browserbase