n8n-nodes-browserbase

This is an n8n community node that lets you automate browsers using Browserbase powered by Stagehand in your n8n workflows.

n8n is a fair-code licensed workflow automation platform.

Installation

Follow the installation guide in the n8n community nodes documentation.

Development / Testing with Docker

# Install dependencies
npm install

# Build the node
npm run build

# Run n8n with your node in Docker
docker-compose up --build

# Open http://localhost:5678 and search for "Browserbase" node

To rebuild after changes:

npm run build && docker-compose up --build

How It Works

The Browserbase Agent node is a single, self-contained node that:

1. Creates a browser session
2. Navigates to your starting URL
3. Executes an AI agent to complete your task
4. Closes the session automatically

Just provide a URL and an instruction - the node handles everything else.

Configuration

Required Fields

Field	Description
Starting URL	The page where the agent begins (e.g., https://example.com)
Instruction	Natural language task for the agent to complete

Driver Model

The driver model powers the browser session (navigation, DOM interactions). Choose from:

• google/gemini-2.5-flash (Recommended - fast & cheap)
• google/gemini-2.5-pro
• openai/gpt-4o
• openai/gpt-4o-mini
• anthropic/claude-sonnet-4-5-20250929

Agent Mode

Mode	Description	Best For
CUA	Computer Use Agent - uses vision and coordinates	Complex UIs, visual interactions
DOM	Uses DOM selectors - works with any LLM	Speed, simple pages
Hybrid	Combines both approaches	Fallback reliability

Agent Models

Models available depend on the selected mode:

CUA Mode:

• google/gemini-2.5-computer-use-preview-10-2025
• openai/computer-use-preview
• anthropic/claude-sonnet-4-20250514
• anthropic/claude-sonnet-4-5-20250929
• anthropic/claude-haiku-4-5-20251001

DOM Mode:

• google/gemini-2.5-flash
• google/gemini-2.5-pro
• openai/gpt-4o
• openai/gpt-4o-mini
• anthropic/claude-sonnet-4-5-20250929

Hybrid Mode:

• google/gemini-3-flash-preview
• anthropic/claude-sonnet-4-20250514
• anthropic/claude-haiku-4-5-20251001

Credentials

You need three credentials:

Credential	Description
Browserbase API Key	Your Browserbase API key
Browserbase Project ID	Your Browserbase project ID
Model API Key	API key for your chosen model provider

Important: The Model API Key must match the provider of your models. If using Google models, provide a Google API key. If using OpenAI, provide an OpenAI key.

Getting Credentials

1. Sign up at Browserbase
2. Navigate to your dashboard for API key and Project ID
3. Get an API key from your model provider:
   • Google AI Studio
   • OpenAI
   • Anthropic

Example Usage

Simple extraction:

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

Form filling:

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

Navigation + action:

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

Output

The node returns an AgentResult object:

{
  "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"
}

Compatibility

Compatible with [email protected] or later

Resources

• n8n community nodes documentation
• Browserbase Documentation
• Stagehand Documentation