n8n-nodes-chrome-cdp
v0.1.4
Published
Direct Chrome DevTools Protocol (CDP) integration for n8n
Maintainers
Readme
n8n-nodes-chrome-cdp
A high-performance n8n community node package providing direct integration with the Chrome DevTools Protocol (CDP). This package is designed for low-level browser control, efficient tab management, and high-speed data extraction.
https://github.com/user-attachments/assets/8e19cdfd-9934-4b97-bd7f-d372227db5c2
Features
- Chrome: Create Tab: Open new browser targets with optional navigation and native "Wait for Page Load" event handling.
- Chrome: Read Web Page: Extract
innerTextorouterHTMLfrom an existing tab session via WebSocket. - Chrome: Run Script: Execute custom asynchronous JavaScript within the page context and return JSON results directly to n8n.
Installation
Follow the official n8n guide to install this package:
- Go to Settings > Community Nodes in your n8n instance.
- Click on Install a community node.
- Enter
n8n-nodes-chrome-cdpin the npm Package Name field. - Agree to the risks and click Install.
Prerequisites
This node requires a running Chromium-based browser (Chrome, Edge, or Brave) with the remote debugging port enabled.
Recommended Startup Command
Launch your browser with the following flags to allow n8n to connect:
chrome --remote-debugging-port=9222 --remote-debugging-address=0.0.0.0 --incognitoNote: Ensure your firewall or network settings allow traffic on port 9222.
Node Documentation
1. Chrome: Create Tab
Initializes a new browser tab and returns connection details.
- Host: The IP or hostname of your Chrome instance.
- URL: The destination address (defaults to
about:blank). - Wait for Page Load: If enabled, pauses execution until the browser triggers
loadEventFired.
2. Chrome: Read Web Page
Connects to an active session to pull content without re-navigating.
- WebSocket URL: The
wsUrlprovided by the Create Tab node. - Extract Type: Choose Text for a clean string or HTML for the raw source code.
- Wait for Navigation: Ensures the DOM is fully settled before extraction.
3. Chrome: Run Script
Injects and executes custom logic inside the browser.
- JavaScript Code: Your script. Supports
async/await. Usereturnto pass data back to the workflow. - Wait for Navigation: Optional flag to delay execution until the page is ready.
