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

2. Search for "Evomi" in the node selector

3. Click on the Evomi node to add it to your workflow

Step 3: Configure Your Credentials

1. In the Evomi node panel, click on "Select Credential" → "+ Create new credential"

2. Enter your API key from the Evomi dashboard and click Save

3. You should see "Connection tested successfully" - your credentials are now saved!

Step 4: Configure and Execute

1. Enter the URL you want to scrape
2. Choose your preferred mode and output format
3. Click Execute step to run the scraper!

Node Parameters

URL (Required)

The web page URL to scrape. Must include http:// or https://.

https://example.com
https://news.ycombinator.com

Mode

Choose how the page should be fetched:

| Mode | Description | Best For | JavaScript | |------|-------------|----------|------------| | Auto (Default) | Automatically detects the best approach. Tries HTTP first, upgrades to browser if needed. | Most use cases | Auto-detected | | Request | Fast HTTP request without browser rendering. | Static sites, blogs, news, APIs | No | | Browser | Full browser with JavaScript execution. | SPAs, React/Vue/Angular apps, dynamic content | Yes |

Output

Choose the format for the scraped content:

| Output | Description | Use Case | |--------|-------------|----------| | JSON (Default) | Structured JSON with metadata. Toggle "Include Content" to get the full HTML. | When you need metadata (title, status, etc.) | | Markdown | Clean, readable text format. | AI processing, content analysis, LLM input | | Screenshot | Full-page PNG image. Automatically enables Browser mode. | Visual verification, archiving, thumbnails |

Include Content (JSON only)

When using JSON output, toggle this to include the full HTML content in the response. Disable to save bandwidth when you only need metadata.

• Default: Off
• When enabled: Response includes content field with full HTML

Wait Seconds (Auto & Browser modes)

Seconds to wait after page load before capturing content. Useful for pages that load content dynamically via JavaScript.

• Default: 5 seconds
• Range: 0-30 seconds
• Tip: Increase for slow-loading pages, decrease for fast static sites

Proxy Country

Route your request through a proxy in a specific country using ISO 3166-1 alpha-2 codes.

• Default: US
• Examples: US, CA, DE, GB, JP, AU, FR, BR

Common Country Codes: | Code | Country | |------|---------| | US | United States | | CA | Canada | | GB | United Kingdom | | DE | Germany | | FR | France | | JP | Japan | | AU | Australia | | BR | Brazil |

Usage Examples

As a Standalone Node

Basic scraping:

1. Set URL: https://example.com
2. Mode: Auto
3. Output: JSON
4. Execute

Get markdown for AI processing:

1. Set URL: https://blog.example.com/article
2. Mode: Auto
3. Output: Markdown
4. Execute → Feed result to AI node

Take a screenshot:

1. Set URL: https://dashboard.example.com
2. Mode: Browser (auto-selected)
3. Output: Screenshot
4. Execute

Geo-targeted scraping:

1. Set URL: https://amazon.de
2. Proxy Country: DE
3. Execute → Get German localized content

As an AI Agent Tool

Connect the Evomi node to an AI Agent node as a tool. The AI can scrape websites based on natural language prompts.

Example Prompts:

• "Scrape https://news.ycombinator.com and summarize the top 5 stories"
• "Get the content from https://example.com/pricing and extract the pricing tiers"
• "Take a screenshot of https://competitor.com/landing-page"

Response Formats

JSON Output

{
  "success": true,
  "url": "https://example.com",
  "domain": "example.com",
  "title": "Example Domain",
  "status_code": 200,
  "credits_used": 2.0,
  "credits_remaining": 98.0,
  "mode_used": "auto (request)",
  "content": "<html>...</html>"
}

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 | [email protected] | | n8n | n8n Community Forum |

License

MIT