# Decodo MCP Server [Health: Active]

**Category:** 🌐 Social Media  
**Repository:** https://github.com/Decodo/mcp-server  
**GitHub Stars:** 37  
**Views:** 3  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/mcp-server-64

## Description
Enable your AI agents to scrape and parse web content dynamically, including geo-restricted sites

## Tools
Capabilities this server exposes over MCP:

- **scrape_as_markdown** — Scrapes any target URL, expects a URL to be given via prompt. Returns results in Markdown.
- **screenshot** — Captures a screenshot of any webpage and returns it as a PNG image.
- **google_search** — Scrapes Google Search for a given query, and returns parsed results.
- **google_ads** — Scrapes Google Ads search results.
- **google_lens** — Scrapes Google Lens image search results.
- **google_ai_mode** — Scrapes Google AI Mode (Search with AI) results.
- **google_travel_hotels** — Scrapes Google Travel Hotels search results.
- **amazon_search** — Scrapes Amazon Search for a given query, and returns parsed results.
- **amazon_product** — Scrapes Amazon Product page.
- **amazon_pricing** — Scrapes Amazon Product pricing information.
- **amazon_sellers** — Scrapes Amazon Seller information.
- **amazon_bestsellers** — Scrapes Amazon Bestsellers list.
- **walmart_search** — Scrapes Walmart Search for a given query, and returns parsed results.
- **walmart_product** — Scrapes Walmart Product page.
- **target_search** — Scrapes Target Search for a given query, and returns parsed results.
- **target_product** — Scrapes Target Product page.
- **tiktok_post** — Scrapes a TikTok post URL for structured data (e.g. engagement, caption, hashtags).
- **tiktok_shop_search** — Scrapes TikTok Shop Search for a given query, and returns parsed results.
- **tiktok_shop_product** — Scrapes TikTok Shop Product page.
- **tiktok_shop_url** — Scrapes TikTok Shop page by URL.
- **youtube_metadata** — Scrapes YouTube video metadata.
- **youtube_channel** — Scrapes YouTube channel videos.
- **youtube_subtitles** — Scrapes YouTube video subtitles.
- **youtube_search** — Search YouTube videos.
- **reddit_post** — Scrapes a specific Reddit post.
- **reddit_subreddit** — Scrapes Reddit subreddit results.
- **reddit_user** — Scrapes a Reddit user profile and their posts/comments.
- **bing_search** — Scrapes Bing Search results.
- **chatgpt** — Search and interact with ChatGPT for AI-powered responses and conversations.
- **perplexity** — Search and interact with Perplexity for AI-powered responses and conversations.

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `npx` (confidence: high):

```json
"mcpServers": {
  "decodo-mcp-server": {
    "command": "npx",
    "args": ["-y","@decodo/mcp-server"],
    "env": {
      "SCRAPER_API_TOKEN": "",
      "TOOLSETS": ""
    }
  }
}
```

**Requires environment variables:** `SCRAPER_API_TOKEN`, `TOOLSETS` — the values above are empty placeholders; fill in real credentials before running (see the repository for what each one is for).

## Documentation

## What Decodo MCP Server MCP server does

The Decodo MCP Server MCP server gives MCP-compatible AI clients access to live web data through Decodo's Web Scraping API. It can fetch a supplied URL as Markdown, capture a webpage as a PNG image, and query supported search, marketplace, social, and AI platforms. The available targets include Google, Bing, Amazon, Walmart, Target, TikTok Shop, Reddit, TikTok, YouTube, ChatGPT, Perplexity, and Google AI Mode.

The service is suited to agents that need current information rather than relying only on model training data. Example workflows include collecting search results for retrieval-augmented generation, extracting product prices or seller details, reading social posts and video metadata, and researching dynamic websites. The repository describes support for server-side JavaScript rendering, anti-bot handling, and geo-restricted sites.

## How it works

An MCP client calls one of the registered tools and supplies the relevant URL or search query. The hosted configuration connects to `https://mcp.decodo.com/mcp`; requests authenticate with a Basic authentication token obtained from the Decodo dashboard. A local Node.js process can use the same API through the `@decodo/mcp-server` package and the `SCRAPER_API_TOKEN` environment variable.

Tools are grouped into optional toolsets:

- `web` provides URL scraping and screenshots.
- `search` covers Google and Bing search-related tools.
- `ecommerce` covers Amazon, Walmart, Target, and TikTok Shop tools.
- `social_media` covers Reddit, TikTok, and YouTube tools.
- `ai` covers ChatGPT, Perplexity, and Google AI Mode.

If no toolset is selected, all listed tools are registered. For hosted connections, a `toolsets` query parameter can limit the server to selected groups, which can reduce the number of tools presented to an agent.

## Setup and configuration

Create a Decodo account and obtain a Web Scraping API basic authentication token. The README states that new accounts include up to 2,000 free requests without a credit card. Configure the hosted endpoint with an `Authorization` header containing the Basic token, or run the package locally with Node.js 18 or later.

For a local client configuration, the package can be started with `npx -y @decodo/mcp-server`. Set `SCRAPER_API_TOKEN` to the token from the dashboard. The `TOOLSETS` environment variable can be set to a comma-separated selection such as `web,ai`; hosted configurations instead use the `toolsets` URL parameter. Claude Desktop, Cursor, and Windsurf are specifically documented as client options.

## Tools and capabilities

The Decodo MCP Server MCP server exposes tools for:

- Scraping arbitrary URLs as Markdown and taking webpage screenshots.
- Searching Google, Bing, Google Ads, Google Lens, Google Travel Hotels, and Google AI Mode.
- Querying Amazon, Walmart, Target, and TikTok Shop, including product, pricing, seller, and bestseller data where supported.
- Reading Reddit posts, subreddits, and user profiles; TikTok posts; and YouTube metadata, channels, subtitles, and search results.
- Interacting with ChatGPT and Perplexity for AI-powered search and conversations.

Outputs may be returned as Markdown, structured data, or screenshots depending on the tool.

## Limitations and notes

A Decodo API token is required, so the server is not credential-free. The hosted service depends on Decodo's endpoint and API access, while local use still sends scraping requests through that service. Results and supported behavior vary by tool and target platform; the README identifies the tools and broad output formats but does not specify schemas for every response. The repository also documents a global proxy network and anti-bot handling, but users remain responsible for deciding whether their collection of a target site's content is permitted.

_Full upstream README: https://allmcps.com/mcp/mcp-server-64/readme_