n8n-nodes-sy-browseruse

English | 中文

This is an n8n community node. It lets you use AI-powered browser automation in your n8n workflows through the SYBrowserUse node.

n8n is a fair-code licensed workflow automation platform.

Installation
Features
Operations
Credentials
Webhook Callback Support
Compatibility
Resources

Installation

Option 1: Install via n8n UI (Recommended)

1. Open n8n
2. Go to Settings → Community Nodes
3. Click Install
4. Enter: n8n-nodes-sy-browseruse
5. Click install and agree to the risks

Option 2: Install via npm

npm install n8n-nodes-sy-browseruse

For detailed instructions, follow the installation guide in the n8n community nodes documentation.

Features

• 🤖 AI-Powered Automation: Use natural language instructions to control browser interactions
• ☁️ Dual Connection Modes: Connect via Cloud API or Local Bridge
• 🔄 Webhook Callbacks: Automatic workflow resumption for long-running tasks (v1.1.0+)
• 🎯 Multiple AI Providers: Support for Anthropic, OpenAI, Google, Mistral, OpenRouter, and custom providers
• 📊 Task Management: Complete lifecycle control (run, pause, resume, stop)
• 📸 Media Retrieval: Access screenshots, videos, and PDFs from task executions

Operations

SYBrowserUse Node

• Run Task: Execute browser automation with natural language instructions
• Get Task: Retrieve complete task details including results and media
• Get Task Status: Check the current status of a running task
• Get Task Media: Download screenshots, videos, or PDFs from task execution
• List Tasks: Get a list of recent tasks with configurable limit
• Pause Task: Temporarily pause a running task
• Resume Task: Resume a previously paused task
• Stop Task: Terminate a running task

Credentials

Browser Use Cloud API

Connect to the official Browser Use cloud service:

1. Sign up at Browser Use to get your API key
2. In n8n, create a new credential of type "Browser Use Cloud API"
3. Enter your API Key
4. Test the connection to verify

Browser Use Local Bridge API

Connect to a locally running Browser Use service:

1. Set up the Browser Use bridge service following the documentation
2. In n8n, create a new credential of type "Browser Use Local Bridge API"
3. Enter the URL of your local service (e.g., http://localhost:8000)
4. Optionally enter an access token if your service requires authentication
5. Test the connection to verify

⚠️ Important: This node requires an enhanced Browser Use backend to support webhook callbacks and extended features.

Recommended Backend: browser-n8n-local (sybrowseruse branch)

Webhook Callback Support

v1.1.0+ Feature: Asynchronous Task Completion

For long-running browser tasks (>5 minutes), SYBrowserUse now supports automatic workflow resumption via webhook callbacks:

• 🔔 Automatic Notification: Browser Use calls back to n8n when task completes
• ⚡ Resource Efficient: Workflow pauses during task execution, no polling required
• 🔧 Simple Configuration: Enable with a single parameter

Quick Setup:

1. Enable "Use Webhook Callback" in Run Task node
2. Add a Wait node (mode: "On Webhook Call") after Run Task
3. Process results in subsequent nodes after Wait resumes

Detailed Guide: See Webhook Callback Guide for complete setup instructions including:

• n8n workflow configuration steps
• Browser Use backend implementation requirements
• Troubleshooting common issues
• Best practices and security considerations

Note: Requires Browser Use backend version with webhook_url parameter support.

Compatibility

• Compatible with n8n@1.60.0 or later
• Webhook callback feature requires n8n@1.0.0+ (for $execution.resumeUrl support)
• Recommended backend: browser-n8n-local

Resources

• n8n community nodes documentation
• Browser Use documentation
• Webhook Callback Implementation Guide
• Enhanced Backend Repository

Contributing

Issues and Pull Requests are welcome!

License

MIT License - see LICENSE file for details

Author

Cshiyuan

• Email: 826718591@qq.com
• GitHub: @Cshiyuan

---

⭐ If this project helps you, please give it a star!