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