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.
- 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.
Decodo is an official node integrated into n8n. To use it, simply:
- Open the nodes panel.
- Search for "Decodo" to find the node.
- Click + Add to workflow.
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, take a note of your generated authentication token from the Web Scraping API page:
- Open the credentials window on n8n.
- Create a new credential.
- Find the Decodo Credentials API.
- Enter your authentication token.
The node can be used in 2 ways - as an individual HTTP request node, or a tool for an AI agent.
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:
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.
When used as an AI tool, the following parameters are inferred automatically from messages:
| Parameter | Description | Example message |
|---|---|---|
url |
The target URL to scrape | Scrape Wikipedia and tell me the article of the day. |
geo |
The country name from which to scrape | Scrape https://ip.decodo.com/json and tell me what city the request originated from. |
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, these parameters can be manually configured by double-clicking on the node.
To contribute to this node:
- Install n8n globally in your development machine.
- Pull this repository.
git clone https://github.com/Decodo/n8n-nodes-decodo.git
- Navigate to the downloaded folder and build it.
cd n8n-nodes-decodo
npm install
npm run build
- Inside the project folder, run
npm linkafter building to make your local build of@decodo/n8n-nodes-decodoavailable in the local npm registry. - Inside
~/.n8n/nodes/node_modules/, runnpm link @decodo/n8n-nodes-decodo.
See this documentation page for more information.
This project uses automated releases via GitHub Actions and semantic-release. When code is merged into the main branch, the following happens automatically:
- Semantic analysis. Commit messages are analyzed to determine the type of release (patch, minor, major).
- Version bump. The version in
package.jsonis automatically updated. - NPM publish. The package is built and published to npm as
@decodo/n8n-nodes-decodo. - GitHub release. A GitHub release is created with automatically generated release notes.
- Git tag. A git tag is created for the new version.
For automated releases to work, the following GitHub repository secrets must be configured:
NPM_TOKEN. An npm access token with publish permissions for the@decodoorganization.GITHUB_TOKEN. Automatically provided by GitHub Actions (no setup required).
To trigger releases, use conventional commit messages:
feat: new feature→ Minor version bumpfix: bug fix→ Patch version bumpfeat!: breaking changeorBREAKING CHANGE:in footer → Major version bumpdocs:,style:,refactor:,test:,chore:→ No release
The Decodo node has been developed and tested with:
- Node.js v22.17.0
- n8n nodes API version 1
- n8n-workflow v1.82.0