Enables scraping and parsing of Amazon Search results for product queries, returning structured data from Amazon's platform.
Enables scraping and parsing of Google Search results for queries, returning structured data including search rankings and results.
Provides web scraping capabilities for Google Maps data through related repository integration.
Enables scraping and parsing of Reddit content including specific posts and subreddit feeds, returning structured data from Reddit's platform.
Decodo MCP Server
This repository provides a Model Context Protocol (MCP) server that connects LLMs and applications to Decodo's platform. The server facilitates integration between MCP-compatible clients and Decodo's services, streamlining access to our tools and capabilities.
Features
Easy web data access. Simplified retrieval of information from websites and online sources.
Geographic flexibility. Access content regardless of regional restrictions.
Enhanced privacy. Browse and collect data while maintaining anonymity.
Reliable scraping. Advanced techniques to avoid detection and blocks.
Simple integration. Seamless setup with popular MCP clients like Claude Desktop, Cursor, and Windsurf.
Quick start
Start a Decodo Web Advanced plan (free trials available) via dashboard.
Copy the auto-generated basic authentication token in the Web Advanced page.
Open up your favourite MCP client and add the following configuration:
Running the MCP server locally (manual)
Prerequisites
Node.js 18.0+
An MCP client - popular choices are Claude Desktop and Cursor
Step-by-step guide
Clone this repository:
Run the following commands in the terminal:
Take note of your build location:
Adding index.js to the end of this directory, your build file location should look something like
this:
Update your MCP client with the server information:
Tools
The server exposes the following tools:
Tool | Description | Example prompt |
| Scrapes any target URL, expects a URL to be given via prompt. Returns results in Markdown. | Scrape peacock.com from a US IP address and tell me the pricing. |
| Scrapes Google Search for a given query, and returns parsed results. | Scrape Google Search for shoes and tell me the top position. |
| Scrapes Amazon Search for a given query, and returns parsed results. | Scrape Amazon Search for toothbrushes. |
| Scrapes a specific Reddit post for a given query, and returns parsed results. | Scrape the following Reddit post: https://www.reddit.com/r/horseracing/comments/1nsrn3/ |
| Scrapes a specific Reddit subreddit for a given query, and returns parsed results. | Scrape the top 5 posts on r/Python this week. |
Parameters
The following parameters are inferred from user prompts:
Parameter | Description |
| Renders target URL in a headless browser. |
| Sets the country from which the request will originate. |
| Sets the locale of the request. |
| Truncates the response content up to this limit. Useful if the context window is small. |
| Skips automatic truncation and returns full content. If context window is small, may throw warnings. |
Examples
Scraping geo-restricted content
Query your AI agent with the following prompt:
This prompt will say that peacock.com is geo-restricted. To bypass the geo-restriction:
Limiting number of response tokens
If your agent has a small context window, the content returned from scraping will be automatically truncated, in order to avoid context-overflow. You can increase the number of tokens returned within your prompt:
If your agent has a big context window, tell it to return full content:
Related repositories
License
All code is released under the MIT License.