n8n-nodes-nvk-browser

This is an n8n community node that provides integration with NVK Browser automation API. It allows you to control browser profiles, interact with web pages, capture network traffic, and execute JavaScript code programmatically.

n8n is a fair-code licensed workflow automation platform.

Installation

Follow the installation guide in the n8n community nodes documentation.

Community Node Installation

1. Go to Settings > Community Nodes in your n8n instance
2. Click Install and enter: n8n-nodes-nvk-browser
3. Click Install

Manual Installation

For local development:

npm install n8n-nodes-nvk-browser

Operations

Profile Management

• Create Profile: Create a new browser profile with proxy and extensions
• Delete Profile: Delete an existing browser profile
• Start Profile: Start a browser profile with custom window settings
• Stop Profile: Stop a running browser profile
• Update Profile: Update profile settings (name, proxy, notes, extensions)
• Download Browser: Download the browser binary

Page Interaction

• Move and Click: Click on elements using CSS selectors or Puppeteer locators
• Run JavaScript: Execute JavaScript code in the browser context
• Get Network Response: Capture and filter network requests/responses
• Browser HTTP Request: Make HTTP requests using the browser's context (cookies, headers)

Configuration

Environment

Choose between:

• Local: Connect to http://localhost:3000
• Docker: Connect to http://host.docker.internal:3000

API Endpoints

The node connects to the following NVK Browser API endpoints:

• /api/profile/create - Create profile
• /api/profile/delete - Delete profile
• /api/profile/start - Start profile
• /api/profile/stop - Stop profile
• /api/profile/update - Update profile
• /api/browser/download - Download browser
• /api/browser/action - Move and click
• /api/browser/script - Run JavaScript
• /api/browser/network - Get network response
• /api/browser/request - Browser HTTP request

Examples

Create a Browser Profile

{
  "environment": "local",
  "resource": "profileManagement",
  "operation": "createProfile",
  "profileName": "MyProfile",
  "proxy": "http:127.0.0.1:8080:user:pass",
  "note": "Test profile"
}

Start Profile and Navigate

{
  "environment": "local",
  "resource": "profileManagement",
  "operation": "startProfile",
  "profileId": "profile_123",
  "initialUrl": "https://example.com",
  "headless": false
}

Click an Element

{
  "environment": "local",
  "resource": "pageInteraction",
  "operation": "moveAndClick",
  "profileId": "profile_123",
  "selector": "button#submit",
  "clickMethod": "puppeteer"
}

Capture Network Request

{
  "environment": "local",
  "resource": "pageInteraction",
  "operation": "getNetworkResponse",
  "profileId": "profile_123",
  "requestFilter": "api/data",
  "matchType": "contains"
}

Requirements

• n8n version 0.198.0 or higher
• NVK Browser API server running on localhost:3000 or accessible via Docker

Credentials

This node does not require any credentials as it connects directly to your local NVK Browser API server.

Compatibility

Tested with n8n version 1.0.0+

Resources

• n8n community nodes documentation
• NVK Browser API Documentation

Version History

1.0.0

• Initial release
• Support for all 10 core operations
• Environment selection (Local/Docker)
• Binary file upload support

License

MIT

Support

For issues and feature requests, please visit the GitHub repository.