JSPM

n8n-nodes-cloudbrowser

0.1.3
  • ESM via JSPM
  • ES Module Entrypoint
  • Export Map
  • Keywords
  • License
  • Repository URL
  • TypeScript Types
  • README
  • Created
  • Published
  • Downloads 7
  • Score
    100M100P100Q47167F
  • License MIT

CloudBrowser node for n8n that allows users to interact with websites using Puppeteer - retrieve HTML, take screenshots, and generate PDFs

Package Exports

  • n8n-nodes-cloudbrowser
  • n8n-nodes-cloudbrowser/index.js

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (n8n-nodes-cloudbrowser) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

Banner image

n8n-nodes-cloudbrowser

This is a node for n8n that allows users to interact with websites using a cloud-based browser instance powered by Puppeteer. It provides various operations to navigate websites and retrieve different types of content.

Installation

Follow these steps to install this node:

# Install via npm
npm install n8n-nodes-cloudbrowser

# Or directly from n8n
n8n community-nodes add n8n-nodes-cloudbrowser

Features

The CloudBrowser node offers the following operations:

1. Get Website HTML

This operation allows you to navigate to a specific URL and retrieve the HTML content of the page.

Output:

  • Page title
  • Final URL (after any redirections)
  • Full HTML content

2. Get Website Screenshot

This operation allows you to navigate to a specific URL and capture an image of the page.

Options:

  • Full page or viewport only
  • Image quality (for JPEG)
  • Image format (JPEG or PNG)
  • Crop area (coordinates and dimensions)

Output:

  • Screenshot in base64
  • Binary data
  • File metadata (name, extension, MIME type)

3. Get Website PDF

This operation allows you to navigate to a specific URL and generate a PDF version of the page.

Options:

  • Paper format (A4, Letter, etc.)
  • Orientation (portrait/landscape)
  • Print backgrounds
  • Scale
  • Margins
  • Page ranges

Output:

  • PDF in base64
  • Binary data
  • File metadata (name, extension, MIME type)

Configuration

All operations require the following common parameters:

  • CloudBrowser API Credentials: Your CloudBrowser API credentials for authentication
  • URL to Navigate: The URL of the website to visit
  • Navigation Options:
    • Wait until event (load, domcontentloaded, networkidle)
    • Timeout

Additional browser configuration options include:

  • Browser type (Chrome, Chromium)
  • Headless mode
  • Stealth mode
  • Session management
  • Proxy configuration

Usage Example

Capture a screenshot of a website and save it as a file

  1. Add the CloudBrowser node
  2. Configure the CloudBrowser API credentials
  3. Select the "Get Website Screenshot" operation
  4. Specify the URL (e.g., https://n8n.io)
  5. Configure the screenshot options as needed
  6. Connect to a Write Binary File node to save the image

Generate a PDF of a website

  1. Add the CloudBrowser node
  2. Configure the CloudBrowser API credentials
  3. Select the "Get Website PDF" operation
  4. Specify the URL (e.g., https://docs.n8n.io)
  5. Configure the PDF options as needed
  6. Connect to a Write Binary File node to save the PDF

API Requirements

This node requires an API token from the CloudBrowser.ai service. Please register at https://cloudbrowser.ai to obtain your API token and configure it in the credentials section.

Testing

This node is thoroughly tested to ensure reliability and functionality. To run tests:

# Install dependencies
npm install

# Run tests
npm run test

# Run tests with coverage report
npm run test:coverage

For more information about testing, see the test documentation.

License

MIT