n8n-nodes-browser-use

This is an n8n community node. It lets you use Browser Use in your n8n workflows.

Browser Use is an AI-powered browser automation tool that allows you to create and manage browser automation tasks using natural language instructions.

n8n is a fair-code licensed workflow automation platform.

Installation
Operations
Credentials
Compatibility
Usage
Nodes-as-Tools
Resources

Installation

Follow the installation guide in the n8n community nodes documentation.

In n8n Desktop or Cloud:

Go to Settings > Community Nodes
Click on Install
Enter n8n-nodes-browser-use in the Name field
Click Install

In a self-hosted n8n instance:

npm install n8n-nodes-browser-use

For local development:

Clone this repository
Install dependencies: npm install
Build the code: npm run build
Link to your n8n installation: npm link
In your n8n installation directory: npm link n8n-nodes-browser-use

Operations

Run Task

Execute a new browser automation task with natural language instructions.

Parameters:

Instructions: Natural language description of what you want the browser to do.
Save Browser Data: Whether to save browser cookies and other data (safely encrypted).

Returns: Task ID, status, and a live preview URL.

Get Task

Retrieve full details of a specific task.

Parameters:

Task ID: The ID of the task to retrieve.

Returns: Complete task information including status, instructions, and timestamps.

Get Task Status

Check the status of a running task.

Parameters:

Task ID: The ID of the task to check.

Returns: Current status, completion percentage, and any error messages.

Pause Task

Temporarily pause a running task.

Parameters:

Task ID: The ID of the task to pause.

Returns: Confirmation of task being paused.

Resume Task

Resume a previously paused task.

Parameters:

Task ID: The ID of the task to resume.

Returns: Confirmation of task resumption.

Stop Task

Stop a running task.

Parameters:

Task ID: The ID of the task to stop.

Returns: Confirmation of task termination.

Get Task Media

Retrieve media (screenshots, video, PDF) from a task.

Parameters:

Task ID: The ID of the task.
Media Type: Type of media to retrieve (Screenshot, Video, or PDF).

Returns: URL or binary data of the requested media.

List Tasks

Retrieve a list of tasks with optional filtering.

Parameters:

Limit: Max number of results to return (1-50, default 50).
Status Filter: Filter tasks by their status (optional).

Returns: Array of task records matching the criteria.

Credentials

Browser Use Cloud API

To use the Browser Use Cloud API, you need to obtain an API key:

Sign up for Browser Use at Browser Use Cloud
Navigate to the billing section to find your API key
Create a new credential of type "Browser Use Cloud API" in n8n
Enter your API key in the credential configuration

The node automatically validates your API key by sending a ping request to the Browser Use Cloud API. If the API key is invalid or the service is unavailable, you'll receive a clear error message.

Browser Use Local Bridge API (🚧 Work In Progress)

⚠️ Note: The Local Bridge feature is currently under development and may not be fully functional.

To use the Local Bridge connection:

Set up the Browser Use bridge service (documentation coming soon)
Create a new credential of type "Browser Use Local Bridge API" in n8n
Configure with:
- URL of your local bridge service (e.g., http://localhost:8000)
- Authentication token (if enabled)

Compatibility

This node has been tested with n8n version 1.80.4.

The Nodes-as-Tools feature requires n8n version 1.62.1 or newer.

Usage

Cloud API Connection

Add the Browser Use node to your workflow
Select "Cloud API" as the connection type
Choose your credentials or create new ones
Select an operation (Run Task, Get Task Status, etc.)
Configure the operation parameters
Run your workflow

Local Bridge Connection

The Local Bridge option allows you to connect to a locally running Browser Use instance, which can be useful for development, testing, or when you need to keep your automation entirely on-premise.

Setup Requirements:

Clone the repository for the bridge service:

git clone https://github.com/draphonix/browser-n8n-local.git
cd browser-n8n-local

Install the required dependencies:
```
pip install -r requirements.txt
```
Configure and run the bridge service:
```
python app.py
```

Then in n8n:

Add the Browser Use node to your workflow
Select "Local Bridge" as the connection type
Choose your credentials or create new ones
Configure as you would with the Cloud API connection

Nodes-as-Tools

Starting with version 0.1.4, Browser Use node supports the n8n Nodes-as-Tools feature, allowing it to be used directly by AI agents in your workflows.

Requirements

n8n version 1.62.1 or newer
AI Agent node in your workflow

Using Browser Use as an AI Tool

Add the Browser Use node to your workflow
Configure the node with your credentials
Connect it to an AI Agent node
The AI Agent can now use Browser Use operations based on natural language instructions

Configuration for Community Nodes

Since Browser Use is a community node, you'll need to enable community packages as tools:

Set the environment variable N8N_COMMUNITY_PACKAGES_ALLOW_TOOL_USAGE=true when running n8n
Restart your n8n instance

Example for a Docker-based installation:

docker run -e N8N_COMMUNITY_PACKAGES_ALLOW_TOOL_USAGE=true -p 5678:5678 n8nio/n8n

Example Prompts for AI Agents

Here are some examples of how to instruct an AI agent to use Browser Use:

"Go to amazon.com and extract the prices and ratings of the top 5 bestsellers in electronics"
"Navigate to my company's website, log in with my credentials, and download the latest financial report"
"Search for recent news about artificial intelligence and summarize the top 3 articles"
"Fill out a contact form on example.com with my information"

Tool Operations Available to AI

The AI agent can use all of the Browser Use operations:

Run Task: Execute browser automation with natural language instructions
Get Task Status: Check if a task is completed or still running
Get Task: Retrieve detailed information about a task
Get Task Media: Obtain screenshots, videos, or PDFs from a task
Pause/Resume/Stop Task: Control running tasks
List Tasks: View all browser automation tasks

Resources

License

MIT