Description
Decodo n8n Node
This repository provides an n8n integration for Decodo’s Web Scraping API, a powerful web scraping tool that automatically bypasses blocks and bot protection to extract data from any target URL. It’s designed for developers and startups looking to automate data collection workflows from platforms like Google, eCommerce sites, and job boards.
n8n is a fair-code licensed workflow automation platform that lets you connect apps, APIs, and services to build automated workflows with minimal effort.
Features
- Easy integration. Plug the Decodo’s n8n node into existing workflows to start scraping with minimal setup.
- Bypassing CAPTCHAs, rate-limits, and IP bans. Automatic handling of common anti-bot defenses.
- Geo-targeting. Request region-specific results from websites that restrict content based on location.
- Rotating proxy support to avoid IP bans. Built-in proxy rotation to keep requests distributed and persistent.
- Structured data output. Get results in JSON or Markdown formats for easy readability and further analysis.
Installation
Decodo is an official node integrated into n8n. To use it, simply:
1. Open the nodes panel.
2. Search for “Decodo” to find the node.
3. Click + Add to workflow.
Obtaining a Decodo account
The node requires a Decodo Web Scraping API Advanced plan. You can get started with a free trial on the dashboard.
Once you have a plan activated, copy your Web Data API key from your Web Data API subscription on the dashboard. Older plans only have a basic authentication token, which you can use in the same field:
2. Create a new credential.
3. Find the Decodo Credentials API.
4. Paste your API key into the Authentication Token field. A basic authentication token works there too, and the credential detects which one you entered.
Using the node
The node can be used in 2 ways – as an individual HTTP request node, or a tool for an AI agent.
Individual node
To use the Decodo node by itself, connect it to an existing workflow. Once you add it, you can set the target URL and Geolocation.
The node requests the target URL through a proxy in the chosen location, scrapes the page, and returns the response for use by downstream nodes such as the HTML node to extract content. Below is an example setup:
AI agent tool
You can connect the Decodo node to the AI Agent node as a tool. You don’t need to modify anything inside the node. Here’s what a simple setup would look like:
With this setup, you can prompt the agent to scrape a website in order to extract information. The prompt must be detailed and specific to return the best results.
Bad prompt example
If your AI model does not have access to the most recent web information, the following question may fail:
Who won the NBA in 2025?
Good prompt example
The question is more likely to be answered by updating the prompt with an instruction to scrape a reliable source:
Scrape Wikipedia and tell me who won the NBA in 2025.
Parameters
When used as an AI tool, most parameters can be inferred automatically from messages, for example:
| Parameter | Description | Example message |
| ———- | ———————————————- | ———————————————————————– |
| url | The target URL to scrape | Scrape Wikipedia and tell me the article of the day. |
| headless | Render JS when scraping | Scrape https://ip.decodo.com/json with JS rendering. |
| geo | The country name from which to scrape | Scrape https://ip.decodo.com/json with United States geolocation. |
| markdown | Receive Markdown type responce instead of HTML | Scrape https://ip.decodo.com/json and return result in markdown format. |
If used as an individual node, all parameters can be manually configured by double-clicking on the node.
Development & releases
Contribution
To contribute to this node:
1. Install n8n globally in your development machine.
npm install n8n -g
2. Pull this repository.
git clone https://github.com/Decodo/n8n-nodes-decodo.git3. Navigate to the downloaded folder and build it.
cd n8n-nodes-decodo
npm install
npm run build
4. Inside the project folder, run npm link after building to make your local build of @decodo/n8n-nodes-decodo available in the local npm registry.
5. Inside ~/.n8n/custom, run npm link @decodo/n8n-nodes-decodo.
See this documentation page for more information.
Automated releases
This project uses automated releases via GitHub Actions and semantic-release. When code is merged into the main branch, the following happens automatically:
1. Semantic analysis. Commit messages are analyzed to determine the type of release (patch, minor, major).
2. Version bump. The version in package.json is automatically updated.
3. NPM publish. The package is built and published to npm as @decodo/n8n-nodes-decodo.
4. GitHub release. A GitHub release is created with automatically generated release notes.
5. Git tag. A git tag is created for the new version.
Required secrets
For automated releases to work, the following GitHub repository secrets must be configured:
NPM_TOKEN. An npm access token with publish permissions for the @decodo organization.GITHUB_TOKEN. Automatically provided by GitHub Actions (no setup required).Commit message format
To trigger releases, use conventional commit messages:
feat: new feature → Minor version bumpfix: bug fix → Patch version bumpfeat!: breaking change or BREAKING CHANGE: in footer → Major version bumpdocs:, style:, refactor:, test:, chore: → No releaseCompatibility
The Decodo node has been developed and tested with:
