Package Information
Documentation
n8n-nodes-browsertotal
n8n community node for scanning URLs, browser extensions, IDE plugins, and packages for security threats using BrowserTotal.com
Why BrowserTotal?
Real Browser Analysis - Unlike static analysis tools, BrowserTotal launches a real browser instance to analyze URLs and extensions exactly as they would execute in a user's environment. This catches threats that only activate in actual browser contexts.
Dynamic Behavior Tracing - Every network request, DOM manipulation, cookie access, and API call is traced and recorded. See what extensions and websites actually do, not just what their code looks like.
Sandboxed Execution - All analysis runs in an isolated, sandboxed browser environment. Test suspicious URLs and extensions safely without risking your system.
AI-Powered Threat Detection - Combines runtime behavior analysis with LLM-powered code review to identify obfuscated malware, data exfiltration, and sophisticated supply chain attacks.
Multi-Platform Coverage - Scan browser extensions (Chrome, Firefox, Edge, Safari, Opera, Brave), IDE plugins (VS Code, JetBrains), and packages (npm, PyPI, WordPress) - all through a unified node.
Supported Platforms
| Platform | Operation | Description |
|---|---|---|
| URLs | Scan URL | Scan any URL for security threats |
| Chrome | Scan Browser Extension | Chrome Web Store extensions |
| Firefox | Scan Browser Extension | Firefox Add-ons |
| Edge | Scan Browser Extension | Microsoft Edge Add-ons |
| Opera | Scan Browser Extension | Opera Add-ons |
| Safari | Scan Browser Extension | Safari Extensions |
| Brave | Scan Browser Extension | Brave Extensions |
| VS Code | Scan VS Code Extension | Visual Studio Marketplace extensions |
| JetBrains | Scan JetBrains Plugin | IntelliJ, PyCharm, WebStorm plugins |
| npm | Scan npm Package | npm packages |
| PyPI | Scan PyPI Package | Python packages |
| WordPress | Scan WordPress Plugin | WordPress plugins |
Installation
In n8n
- Go to Settings > Community Nodes
- Select Install
- Enter
n8n-nodes-browsertotaland click Install
Manual Installation
npm install n8n-nodes-browsertotal
Operations
Scan URL
Analyze a URL for security threats including malware, phishing, and suspicious content.
Parameters:
- URL - The URL to scan (e.g.,
https://example.com)
Scan Browser Extension
Check browser extensions for malicious code, excessive permissions, or suspicious behavior.
Parameters:
- Extension ID - The extension identifier
- Browser Store - Chrome, Firefox, Edge, Opera, Safari, or Brave
Scan VS Code Extension
Verify the safety of VS Code extensions before installing them in your development environment.
Parameters:
- Extension ID - The extension ID in
publisher.extension-nameformat
Scan JetBrains Plugin
Scan JetBrains IDE plugins (IntelliJ, PyCharm, WebStorm, etc.) for security issues.
Parameters:
- Plugin ID - The JetBrains plugin ID
Scan npm Package
Detect supply chain attacks and malicious code in npm packages.
Parameters:
- Package Name - The npm package name
Scan PyPI Package
Check Python packages for security vulnerabilities and malicious content.
Parameters:
- Package Name - The PyPI package name
Scan WordPress Plugin
Analyze WordPress plugins for security issues and vulnerabilities.
Parameters:
- Plugin Slug - The WordPress plugin slug
Output
All operations return a result object containing:
| Field | Description |
|---|---|
status |
Threat status: safe, suspicious, malicious, unknown, or error |
score |
Numeric threat score (0-100, where 100 is safest) |
threats |
Array of detected threats with type, severity, and description |
scanUrl |
Direct link to the full scan report on BrowserTotal |
timestamp |
When the scan was performed |
Example Output
{
"url": "https://example.com",
"status": "safe",
"score": 100,
"threats": [],
"scanUrl": "https://browsertotal.com/analysis/urls/...",
"timestamp": "2024-01-15T10:30:00.000Z"
}
Options
| Option | Type | Default | Description |
|---|---|---|---|
| Headless Mode | Boolean | true |
Run the browser in headless mode |
| Timeout (ms) | Number | 420000 |
Maximum time to wait for scan results (7 minutes) |
| Disable AI Analysis | Boolean | true |
Skip AI-powered analysis for faster scans |
Use Cases
Security Automation Workflows
- Phishing Detection: Automatically scan URLs from emails or messages
- Supply Chain Security: Scan npm/PyPI packages before adding to projects
- Extension Vetting: Verify browser extensions before deploying to enterprise
- Continuous Monitoring: Schedule regular scans of critical dependencies
Example Workflow
- Trigger: Webhook receives a URL to check
- BrowserTotal: Scan the URL for threats
- IF: Check if status is
maliciousorsuspicious - Slack: Send alert if threat detected
- Airtable: Log scan results
Requirements
- Node.js 22 or higher
- n8n version 1.0 or higher
- Chromium browser (installed automatically via Puppeteer)