Description

Evomi n8n Node

This repository provides an n8n community node for Evomi’s Scraper API, a powerful web scraping tool with intelligent mode detection, automatic CAPTCHA solving, and residential proxy support.

n8n is a fair-code licensed workflow automation platform that lets you connect apps, APIs, and services to build automated workflows.

Features

• Intelligent Auto Mode: Automatically detects whether to use fast HTTP requests or full browser rendering
• Three Scraping Modes: Choose between auto, request, or browser modes
• Multiple Output Formats: Get results as JSON, Markdown, or Screenshot
• AI Tool Compatible: Use as an AI agent tool for intelligent web scraping
• Automatic CAPTCHA Solving: Built-in CAPTCHA handling with browser mode
• Geo-Targeting: Route requests through proxies in 195+ countries
• Robust Error Handling: Comprehensive validation with helpful error messages

—

Prerequisites

To use this node, you need:

1. An Evomi account – Sign up at evomi.com
2. Active Scraper API subscription or Pay-As-You-Go credits – Required to make API requests

> 🎁 Free Trial Available! New users can get started with a free trial at my.evomi.com/scraper-api.

—

Installation

From n8n Community Nodes

1. Open your n8n instance
2. Go to Settings → Community Nodes
3. Select Install
4. Enter n8n-nodes-evomi and confirm

Manual Installation

npm install n8n-nodes-evomi

—

Getting Started

Step 1: Get Your API Key

1. Log in to your Evomi Dashboard
2. Navigate to Products → Scraper API → Playground
3. Your API key is displayed in the top-right section of the dashboard



Copy the API key from the highlighted field (click the copy icon next to it).

Step 2: Add the Evomi Node to Your Workflow

1. In your n8n workflow editor, click the + button to add a new node

..." }

Markdown Output

Returns clean, formatted text:

Example Domain
This domain is for use in illustrative examples in documents...

Screenshot Output

Returns binary PNG image data that can be:

• Saved to file
• Uploaded to cloud storage
• Processed by image nodes

—

Error Handling

The node provides comprehensive error handling with helpful messages:

Input Validation Errors

| Error | Cause | Solution |
|——-|——-|———-|
| “URL is required” | Empty URL field | Enter a valid URL |
| “Invalid URL format” | Missing http:// or https:// | Add protocol to URL |
| “Invalid proxy country code” | Not a 2-letter code | Use ISO 3166-1 alpha-2 (e.g., US, DE) |

API Errors

| Error | Cause | Solution |
|——-|——-|———-|
| “Invalid API key” | Wrong or expired key | Check credentials in n8n |
| “Insufficient credits” | Account out of credits | Add credits or start a free trial |
| “Rate limit exceeded” | Too many requests | Wait and retry, or upgrade plan |
| “Failed to connect” | Network issue | Check internet connection |

Continue on Fail

Enable “Continue on Fail” in node settings to handle errors gracefully. Failed items will return:

{
  "success": false,
  "error": "Error message here",
  "itemIndex": 0
}

—

Credits & Pricing

| Mode | Output | Approximate Cost |
|——|——–|——————|
| Request | JSON/Markdown | 1-2 credits |
| Auto (request used) | JSON/Markdown | 2 credits |
| Auto (browser used) | JSON/Markdown | 6 credits |
| Browser | JSON/Markdown | 5 credits |
| Browser | Screenshot | 6 credits |

Check your credit balance at my.evomi.com.

> 💡 Tip: Start with a free trial to test the API before committing to a subscription.

—

Development

Setup

Clone the repository
git clone https://github.com/evomi/n8n-nodes-evomi.git
cd n8n-nodes-evomi
Install dependencies
npm install
Build the project
npm run build

Testing Locally

1. Build the node
npm run build
2. Link the package
npm link
3. Create n8n custom folder and link
mkdir -p ~/.n8n/custom
cd ~/.n8n/custom
npm init -y
npm link n8n-nodes-evomi
4. Start n8n
n8n start

Linting

npm run lint
npm run lint:fix

—

Compatibility

• Node.js: >=20.15
• n8n: Latest version recommended
• n8n Nodes API Version: 1

—

Resources

• Evomi Scraper API Documentation
• Evomi Dashboard & API Playground
• Start Free Trial
• n8n Community Nodes Documentation

—

Support

| Issue Type | Where to Get Help |
|————|——————-|
| This node | GitHub Issues |
| Evomi API | support@evomi.com |
| n8n | n8n Community Forum |

—

License

MIT