Browserbase Tool

Learn how to use Browserbase Tool with Composio

Overview

SLUG

BROWSERBASE_TOOL

Description

Browserbase is a serverless platform that enables developers to run, manage, and monitor headless browsers at scale, offering seamless integration with tools like Playwright, Puppeteer, and Selenium.

Authentication Details

browserbase_api_key
stringRequired

Tools

SLUG: BROWSERBASE_TOOL_CONTEXTS_CREATE

Tool to create a new browser context. use when you need to obtain upload credentials for a custom user-data-directory in a project.

Action Parameters

projectId
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: BROWSERBASE_TOOL_CONTEXTS_GET

Tool to retrieve details of a specific browser context. use when you have a context id and need its metadata.

Action Parameters

id
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: BROWSERBASE_TOOL_CONTEXTS_UPDATE

Tool to update a specific browser context. use when you need fresh upload url and encryption details for an existing context, after obtaining a valid context id.

Action Parameters

id
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: BROWSERBASE_TOOL_CREATE_BROWSER_SESSION

Tool to create a new browser session. use when you need an isolated browser context before performing any page interactions.

Action Parameters

browser
stringRequired
headless
boolean
locale
string
projectId
stringRequired
proxy
object
timezoneId
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: BROWSERBASE_TOOL_SESSIONS_GET

Tool to retrieve details of a specific browser session. use when you have a session id and need its metadata (status, urls, timestamps).

Action Parameters

id
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: BROWSERBASE_TOOL_SESSIONS_GET_DEBUG

Tool to retrieve live debug urls for a specific session. use when you need to connect to a running session for debugging.

Action Parameters

id
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: BROWSERBASE_TOOL_SESSIONS_GET_DOWNLOADS

Tool to download files from a specific session. use after session completion to retrieve all generated artifacts in a zip archive.

Action Parameters

id
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: BROWSERBASE_TOOL_SESSIONS_GET_LOGS

Tool to retrieve logs of a specific session. use after actions in a session to inspect network events and data exchange.

Action Parameters

id
stringRequired

Action Response

data
arrayRequired
error
string
successful
booleanRequired

SLUG: BROWSERBASE_TOOL_SESSIONS_LIST

Tool to list all browser sessions. use when you need to retrieve sessions with optional filtering by status or metadata query.

Action Parameters

q
string
status
string

Action Response

data
arrayRequired
error
string
successful
booleanRequired

SLUG: BROWSERBASE_TOOL_SESSIONS_UPDATE

Tool to update the status of a specific browser session. use when you need to request session completion before timeout to avoid additional charges.

Action Parameters

id
stringRequired
projectId
stringRequired
status
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: BROWSERBASE_TOOL_BROWSERBASE_LOAD_TOOL

Load webpages url in a headless browser using browserbase and return the contents.

Action Parameters

url
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired