Skip to main content
Browserbase is a cloud platform for running and managing headless browser sessions, enabling agents to automate web browsing with configurable fingerprinting, proxy support, persistent contexts, and full session observability.

​
Setup

  1. In Agent Studio, go to Tools → Browserbase → Connect
  2. Paste your API key from the Browserbase dashboard

​
Available actions

ActionDescription
BROWSERBASE__CREATE_SESSIONCreate a new cloud browser session with configurable settings such as region, proxy, fingerprinting, and ad blocking.
BROWSERBASE__LIST_SESSIONSList all browser sessions for a project, with optional filtering by status or user metadata.
BROWSERBASE__GET_SESSIONRetrieve detailed metadata for a specific browser session by its ID.
BROWSERBASE__UPDATE_SESSIONUpdate a browser session’s status, such as requesting early release to avoid additional charges.
BROWSERBASE__GET_SESSION_DEBUGRetrieve Chrome DevTools Protocol debug URLs and page inspection interfaces for a specific session.
BROWSERBASE__GET_SESSION_DOWNLOADSGet the list of files downloaded during a specific browser session.
BROWSERBASE__GET_SESSION_LOGSRetrieve the activity logs for a specific browser session.
BROWSERBASE__GET_SESSION_RECORDINGGet the recorded event timeline for a specific browser session.
BROWSERBASE__LIST_PROJECTSList all projects associated with your Browserbase account.
BROWSERBASE__GET_PROJECTRetrieve detailed information about a specific project by its ID.
BROWSERBASE__GET_PROJECT_USAGERetrieve resource usage statistics for a specific project.
BROWSERBASE__CREATE_CONTEXTCreate a persistent browser context (profile) that can be reused across multiple sessions.
BROWSERBASE__GET_CONTEXTRetrieve metadata for a specific browser context by its ID.
BROWSERBASE__UPDATE_CONTEXTUpdate a browser context to refresh its encryption keys and security parameters.
BROWSERBASE__GET_EXTENSIONRetrieve details about a specific browser extension by its ID.
BROWSERBASE__DELETE_EXTENSIONDelete a specific browser extension by its ID.

​
Adding to an agent

  1. Open your agent in Agent Studio → Agent Builder
  2. Go to Tools and enable Browserbase
  3. Select only the actions your agent needs
  4. Set auth mode: Shared (agent acts on one account) or Per-user (each end-user connects their own account)

​
Example use cases

Automated web scraping with persistent sessions An agent creates a Browserbase session with stealth mode and proxy enabled, navigates target websites to extract structured data, and retrieves downloaded files at the end of the session, all without triggering bot detection. Monitoring and auditing browser automation workflows An agent lists recent sessions filtered by status, fetches logs and recordings for any errored sessions, and surfaces debugging information to help diagnose and fix automation failures. Reusable authenticated browsing contexts An agent creates a persistent browser context to store login state, then spins up multiple sessions that reuse the same context, avoiding repeated authentication flows across tasks.