Plugin ID: browserbase | Auth: API Key (x-bb-api-key header)
Browserbase provides cloud browser infrastructure for AI agents. Create a session, then use the connect URL with Playwright/Puppeteer for full browser interaction. The plugin covers session lifecycle management via the REST API.
browserbase.sessions.create
Name: Create Session
Create a new Browserbase cloud browser session.
Input:
| Parameter | Type | Required | Default | Description |
|---|
projectId | string | Yes | — | Browserbase project ID |
proxies | boolean | No | false | Enable residential proxies for stealth browsing |
{ "sessionId": "sess_abc123", "status": "created", "connectUrl": "wss://connect.browserbase.com/...", "debuggerUrl": "https://debug.browserbase.com/..." }
browserbase.sessions.get
Name: Get Session
Get the status and details of a browser session.
Input:
| Parameter | Type | Required | Description |
|---|
sessionId | string | Yes | Session ID |
{ "sessionId": "sess_abc123", "status": "running", "startedAt": "2026-04-20T10:00:00Z", "endedAt": null, "proxy": false }
browserbase.sessions.debug
Name: Get Debug URLs
Get live debug/viewer URLs for a session. Use the debugger URL to watch the session in real time.
Input:
| Parameter | Type | Required | Description |
|---|
sessionId | string | Yes | Session ID |
{ "debuggerUrl": "https://debug.browserbase.com/sess_abc123", "debuggerFullscreenUrl": "https://debug.browserbase.com/sess_abc123/fullscreen" }
browserbase.sessions.close
Name: Close Session | Destructive: Yes
Close and terminate a browser session. Requires user approval.
Input:
| Parameter | Type | Required | Default | Description |
|---|
sessionId | string | Yes | — | Session ID |
status | string | No | "REQUEST_RELEASE" | "REQUEST_RELEASE" (graceful) or "COMPLETED" |
{ "sessionId": "sess_abc123", "status": "REQUEST_RELEASE" }
browserbase.sessions.recording
Name: Get Session Recording
Get the recording/replay data for a completed session.
Input:
| Parameter | Type | Required | Description |
|---|
sessionId | string | Yes | Session ID |
{ "recording": { "events": [], "duration": 45000 } }
browserbase.usage
Name: Get Usage
Get usage metrics for a Browserbase project.
Input:
| Parameter | Type | Required | Description |
|---|
projectId | string | Yes | Browserbase project ID |
{ "usage": { "sessionsCreated": 150, "totalMinutes": 420 } }
