Run Browserbase cloud browser sessions from Guild agents

Integrations · Browserbase

Guild agents fetch web pages, search the web, and manage Browserbase cloud browser sessions, contexts, and functions. Guild stores your Browserbase API key and injects it server-side, so agent code never sees it. Credential policies decide which Browserbase operations each agent may call.

Book a demo

See how teams govern agents that use Browserbase.

Talk to sales

Get access to Guild, then connect Browserbase to your first agent.

What the Browserbase integration exposes

The integration is guildai~browserbase. Two tools return content directly: browserbase_fetch_create fetches a page with its headers and metadata, and browserbase_search_web returns structured search results. The rest manage Browserbase resources: sessions and their logs, recordings, and replays, contexts, downloads, extensions, certificates, functions and their invocations, and projects and usage. Requests go to https://api.browserbase.com.

How it works

Copy your Browserbase API key

Connect the key in Guild

Go to Access & setup > Credentials, click Connect, select browserbase, and paste the key into API Key.

Import the tools you need

Import BrowserbaseTools from @guildai-services/guildai~browserbase and use pick() to give the agent only the tools its job needs.

Authentication

Type: API key
Header: Guild sends the key as x-bb-api-key: <key>

See Credentials for workspace, member, and agent-scoped credentials.

Usage

import { BrowserbaseTools } from "@guildai-services/guildai~browserbase"
import { llmAgent, pick } from "@guildai/agents-sdk"

export default llmAgent({
  systemPrompt: "You research a topic on the web and summarize what you find, with links.",
  tools: {
    ...pick(BrowserbaseTools, [
      "browserbase_search_web",
      "browserbase_fetch_create",
    ]),
  },
})

Tools are named with the browserbase_ prefix.

Tools

Tools in the latest published version of guildai~browserbase:

All 37 tools

Tool	What it does
`browserbase_certificates_delete`	Certificates delete.
`browserbase_certificates_get`	Certificates get.
`browserbase_certificates_list`	Certificates list.
`browserbase_contexts_create`	Contexts create.
`browserbase_contexts_delete`	Contexts delete.
`browserbase_contexts_get`	Contexts get.
`browserbase_contexts_update`	Contexts update.
`browserbase_downloads_delete`	Delete a download file from storage and mark as deleted.
`browserbase_downloads_get`	Get download metadata (Accept: application/json) or file content (Accept: application/octet-stream).
`browserbase_downloads_list`	List all downloads for a session with optional filtering and pagination.
`browserbase_extensions_delete`	Extensions delete.
`browserbase_extensions_get`	Extensions get.
`browserbase_fetch_create`	Fetch a page and return its content, headers, and metadata.
`browserbase_function_builds_get`	Function builds get.
`browserbase_function_builds_get_logs`	Function builds get logs.
`browserbase_function_builds_list`	Function builds list.
`browserbase_functions_get`	Functions get.
`browserbase_functions_invoke`	Functions invoke.
`browserbase_functions_list`	Functions list.
`browserbase_functions_list_versions`	Functions list versions.
`browserbase_function_versions_get`	Function versions get.
`browserbase_function_versions_list_invocations`	Function versions list invocations.
`browserbase_invocations_get`	Invocations get.
`browserbase_invocations_get_logs`	Invocations get logs.
`browserbase_projects_get`	Projects get.
`browserbase_projects_list`	Projects list.
`browserbase_projects_usage`	Projects usage.
`browserbase_search_web`	Perform a web search and return structured results.
`browserbase_sessions_create`	Sessions create.
`browserbase_sessions_get`	Sessions get.
`browserbase_sessions_get_debug`	Sessions get debug.
`browserbase_sessions_get_logs`	Sessions get logs.
`browserbase_sessions_get_recording`	Sessions get recording.
`browserbase_sessions_get_replay`	Returns page metadata for a session replay, including timing information and the URL of each page’s HLS playlist.
`browserbase_sessions_get_replay_page`	Returns an HLS VOD media playlist (.m3u8) for a specific page of a session replay.
`browserbase_sessions_list`	Sessions list.
`browserbase_sessions_update`	Sessions update.

Frequently asked questions

Can the agent click and type in a Browserbase session?

No. browserbase_sessions_create starts a session and returns its connection details, but driving the page takes a Chrome DevTools Protocol client such as Playwright, which these tools don’t include. Use browserbase_fetch_create to read a page, or deploy a Browserbase function and call it with browserbase_functions_invoke.

Do Browserbase sessions cost money when an agent forgets to close them?

Yes. A session runs until it times out or you release it, and Browserbase bills for that time. Have the agent end sessions with browserbase_sessions_update, and set a timeout when it creates them.

Can I stop an agent from deleting contexts or downloads?

Yes. Write a credential policy that denies the delete operations. See Credential policies.

Also runs on Guild: Firecrawl · Pinecone Read: Docs: Credential policies · Credentials · Tools in agents

Overview

Models

Inference providers

Code & CI/CD

Communication

Project management

Testing

Design

Productivity

Monitoring & observability

Data

Web & search

Customer support

Sales & finance

Recruiting

Run Browserbase cloud browser sessions from Guild agents

Book a demo

Talk to sales

What the Browserbase integration exposes

How it works

Authentication

Usage

Tools

Frequently asked questions

Book a demo

Talk to sales

​What the Browserbase integration exposes

​How it works

​Authentication

​Usage

​Tools

​Frequently asked questions

​Related

What the Browserbase integration exposes

How it works

Authentication

Usage

Tools

Frequently asked questions

Related