n8n Quickstart

1

Get your Browserbase Credentials

Go to the Dashboard’s Settings tab:

Copy your API Key and Project ID, you’ll need both in Step 4.Don’t have an account yet? Sign up at browserbase.com.

2

Get your Model Provider API Key

You need an API key from the provider whose models you’ll use. Choose one:

• Google: Google AI Studio
• OpenAI: OpenAI Platform
• Anthropic: Anthropic Console

The Model API Key must match the provider of both your Driver Model and Agent Model. For example, if you select google/gemini-2.5-flash as your driver and google/gemini-2.5-computer-use-preview-10-2025 as your agent model, you need a Google API key. All models in a single execution must be from the same provider.

3

Install the Community Node

In your n8n instance:

1. Go to Settings > Community Nodes
2. Click Install a community node
3. Enter n8n-nodes-browserbase
4. Click Install

Requires n8n v1.60.0 or later. If you’re self-hosting, make sure your instance is up to date.

4

Configure Credentials

1. Go to Credentials > Add Credential
2. Search for “Browserbase” and select Browserbase API
3. Fill in the three fields:

Field	Value
Browserbase API Key	Your API key from Step 1
Browserbase Project ID	Your project ID from Step 1
Model API Key	Your model provider API key from Step 2

4. Click Save

These credentials are shared across all Browserbase Agent nodes in your workflows. You only need to set them up once.

5

Add the Browserbase Agent Node

1. Create a new workflow (or open an existing one)
2. Click + to add a node and search for “Browserbase Agent”
3. Configure the required fields:

Field	Description
Starting URL	The page where the agent begins (e.g., https://news.ycombinator.com)
Instruction	Natural language task (e.g., “Find the top 3 stories and return their titles and URLs”)
Driver Model	Powers navigation and DOM interactions. Default: google/gemini-2.5-flash
Mode	CUA (vision), DOM (selectors), or Hybrid (both)
Agent Model	Orchestration model. Available options change based on selected mode

Remember: the Driver Model and Agent Model must be from the same provider as your Model API Key.

6

Run Your Workflow

Click Test Workflow to execute. The node returns an AgentResult object:

Copy

Ask AI

{
  "success": true,
  "message": "Task completed successfully",
  "actions": [
    { "type": "act", "action": "clicked submit button" }
  ],
  "completed": true,
  "usage": {
    "input_tokens": 1250,
    "output_tokens": 340,
    "inference_time_ms": 2500
  },
  "sessionId": "abc-123"
}

You can connect additional nodes to process this output. Send it to a database, spreadsheet, Slack channel, or any other n8n integration.

​

Optional Settings

​

Browser Options

​

Session Options

​

Agent Options

​

Example Workflows

• Starting URL: https://news.ycombinator.com
• Instruction: Find the top 3 stories and return their titles and URLs

• Starting URL: https://example.com/contact
• Instruction: Fill out the contact form with name "John Doe" and email "john@example.com", then submit

• Starting URL: https://github.com
• Instruction: Search for "stagehand" and click on the first repository result