# Decodo MCP Server [Health: Active]

**Category:** 🌐 Social Media  
**Repository:** https://github.com/Decodo/mcp-server  
**GitHub Stars:** 40  
**npm Downloads (last month):** 1661  
**Views:** 9  
**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** — Fetch any public web page through the Decodo Web Scraping API (`universal` target) and return its content as Markdown. Use it to read a specific URL when no site-specific tool fits; very long pages are truncated, and `tokenLimit` sets a lower cap. Docs: https://help.decodo.com/docs/web-data-api-markdown-response
- **screenshot** — Capture a PNG screenshot of a web page through the Decodo Web Scraping API (`universal` target with PNG output). Use it when the page layout or visuals matter, not just its text. Docs: https://help.decodo.com/docs/web-data-api-screenshot-response
- **map** — List the URLs on a website without fetching their content. Large sites can overflow your context, so `limit` defaults to 10; narrow with selectPaths or excludePaths. For precise work, map the site, then scrape_as_markdown only the pages you need.
- **crawl_start** — Start crawling a website and return the crawl id right away, without waiting for it to finish. Check progress with crawl_status, read pages with crawl_results and stop it early with crawl_cancel. Crawled content can overflow your context, so `limit` defaults to 10 pages. For precise work, prefer map plus scrape_as_markdown on the pages you need.
- **crawl_status** — Report the progress of a crawl started with crawl_start: its status and how many pages were discovered, completed and failed. The crawl is finished once status is no longer "pending".
- **crawl_results** — Return crawled pages as Markdown from a crawl started with crawl_start, a few at a time. Call it once crawl_status reports the crawl is no longer "pending". Crawled pages can be long and overflow your context, so each call returns at most about 50 KB and up to `limit` pages (10 by default). A page too long for one call is split across calls; each part carries contentPart with its character range. Pass nextCursor back to get the rest; when it is missing, you have every page. For precise work, prefer map plus scrape_as_markdown on the pages you need.
- **crawl_cancel** — Stop a crawl started with crawl_start so it crawls no more pages. Pages crawled before the cancel stay readable with crawl_results.
- **search** — Search the web and return ranked results with title, link and description. Results can overflow your context, so `limit` defaults to 10. To read a result, pass its link to scrape_as_markdown.
- **google_search** — Search Google through the Decodo Web Scraping API (`google_search` target) and return the parsed results page as JSON, including organic results. Use it for fresh web results or Google rankings for a query. Docs: https://help.decodo.com/docs/web-scraping-api-google-search
- **google_ads** — Search Google through the Decodo Web Scraping API (`google_ads` target) and return the paid Google Ads shown for a query, parsed as JSON. Use it to see which advertisers bid on a keyword and what their ads say. Docs: https://help.decodo.com/docs/web-scraping-api-google-ads
- **google_lens** — Run a Google Lens image search for an image URL through the Decodo Web Scraping API (`google_lens` target) and return the parsed visual matches as JSON. Use it to identify what an image shows or find pages where it appears. Docs: https://help.decodo.com/docs/web-scraping-api-google-lens
- **google_ai_mode** — Ask Google AI Mode a question through the Decodo Web Scraping API (`google_ai_mode` target) and return its AI answer as JSON. Use it to see what Google's AI search says about a query. Docs: https://help.decodo.com/docs/web-scraping-api-google-ai-mode
- **google_travel_hotels** — Search Google Travel for hotels through the Decodo Web Scraping API (`google_travel_hotels` target) and return the listings as Markdown. Use it to find hotel options and prices for a destination. Docs: https://help.decodo.com/docs/web-scraping-api-google-travel-hotels
- **amazon_search** — Search Amazon for a keyword through the Decodo Web Scraping API (`amazon_search` target) and return the product listings parsed as JSON. Use it to find products and compare listings on a chosen Amazon domain. Docs: https://help.decodo.com/docs/web-scraping-api-amazon-search
- **amazon_product** — Fetch an Amazon product page by ASIN through the Decodo Web Scraping API (`amazon_product` target) and return its details parsed as JSON. Use it when you know the product's ASIN and need its title, price, rating or description. Docs: https://help.decodo.com/docs/web-scraping-api-amazon-product
- **amazon_pricing** — Fetch the offers for an Amazon product by ASIN through the Decodo Web Scraping API (`amazon_pricing` target) and return them parsed as JSON. Use it to compare what different sellers charge for the same product. Docs: https://help.decodo.com/docs/web-scraping-api-amazon-pricing
- **amazon_sellers** — Fetch an Amazon seller profile by seller ID through the Decodo Web Scraping API (`amazon_sellers` target) and return it parsed as JSON. Use it to check a seller's name, rating and feedback. Docs: https://help.decodo.com/docs/web-scraping-api-amazon-sellers
- **amazon_bestsellers** — Fetch the Amazon Best Sellers list for a category through the Decodo Web Scraping API (`amazon_bestsellers` target) and return it parsed as JSON. Use it to see the top-selling products in a category. Docs: https://help.decodo.com/docs/web-scraping-api-amazon-bestsellers
- **walmart_search** — Search Walmart for a keyword through the Decodo Web Scraping API (`walmart_search` target) and return the results as Markdown. Use it to find Walmart products, optionally for a store or delivery ZIP code. Docs: https://help.decodo.com/docs/web-scraping-api-walmart-search
- **walmart_product** — Fetch a Walmart product page by product ID through the Decodo Web Scraping API (`walmart_product` target) and return its details parsed as JSON. Use it when you know the product ID and need its price, availability or description. Docs: https://help.decodo.com/docs/web-scraping-api-walmart-product
- **target_search** — Search Target for a keyword through the Decodo Web Scraping API (`target_search` target) and return the results as Markdown. Use it to find products sold by the Target retail store, optionally for a delivery ZIP code. Docs: https://help.decodo.com/docs/web-scraping-api-target-search
- **target_product** — Fetch a Target product page by product ID through the Decodo Web Scraping API (`target_product` target) and return its details parsed as JSON. Use it when you know a Target product ID and need its price, availability or description. Docs: https://help.decodo.com/docs/web-scraping-api-target-product
- **tiktok_post** — Fetch a TikTok video post by URL through the Decodo Web Scraping API (`tiktok_post` target) and return the page's raw HTML, often several hundred KB. Use it to analyse a specific TikTok video; set xhr to get a JSON list of the page's XHR/fetch requests instead of the HTML. Docs: https://help.decodo.com/docs/web-scraping-api-tiktok-post
- **tiktok_shop_search** — Search TikTok Shop for a keyword through the Decodo Web Scraping API (`tiktok_shop_search` target) and return the results as Markdown. Use it to find products sold on TikTok Shop in a given country. Docs: https://help.decodo.com/docs/web-scraping-api-tiktok-shop-search
- **tiktok_shop_product** — Fetch a TikTok Shop product page by product ID through the Decodo Web Scraping API (`tiktok_shop_product` target) and return it as Markdown. Use it when you know a TikTok Shop product ID and need its price, seller or description. Docs: https://help.decodo.com/docs/web-scraping-api-tiktok-shop-product
- **tiktok_shop_url** — Fetch any TikTok Shop page by URL through the Decodo Web Scraping API (`tiktok` target) and return the page's raw HTML, often several hundred KB. Use it for TikTok Shop pages that tiktok_shop_search and tiktok_shop_product do not cover, such as a shop or category URL. Docs: https://help.decodo.com/docs/web-scraping-api-tiktok-shop-url
- **youtube_metadata** — Fetch a YouTube video's metadata by video ID through the Decodo Web Scraping API (`youtube_metadata` target) and return it as JSON, such as title, channel, views and description. Use it when you know the video ID and need details about the video. Docs: https://help.decodo.com/docs/web-scraping-youtube-metadata
- **youtube_channel** — Fetch the videos of a YouTube channel by handle or ID through the Decodo Web Scraping API (`youtube_channel` target) and return them parsed as JSON. Use it to list what a channel has published. Docs: https://help.decodo.com/docs/web-scraping-api-youtube-channel
- **youtube_subtitles** — Fetch the subtitles of a YouTube video by video ID through the Decodo Web Scraping API (`youtube_subtitles` target) and return them as JSON. Use it to read or summarise what is said in a video; set `language_code` for a specific language. Docs: https://help.decodo.com/docs/web-scraping-api-youtube-subtitles
- **youtube_search** — Search YouTube for videos through the Decodo Web Scraping API (`youtube_search` target) and return the results as JSON. Use it to find videos on a topic before fetching their metadata or subtitles. Docs: https://help.decodo.com/docs/web-scraping-api-youtube-search
- **bing_search** — Search Bing through the Decodo Web Scraping API (`bing_search` target) and return the parsed results page as JSON. Use it when Bing results are needed specifically, or to compare them with Google. Docs: https://help.decodo.com/docs/web-scraping-api-bing-search
- **chatgpt** — Send one prompt to ChatGPT through the Decodo Web Scraping API (`chatgpt` target) and return its answer parsed as JSON. Each call is a single prompt and answer, with no conversation history; set `search` to let ChatGPT use web search. Use it to see how ChatGPT answers a question, for example to check how it describes a brand. Docs: https://help.decodo.com/docs/web-scraping-api-chatgpt
- **perplexity** — Send one prompt to Perplexity through the Decodo Web Scraping API (`perplexity` target) and return its answer parsed as JSON. Each call is a single prompt and answer, with no conversation history. Use it to see how Perplexity answers a question and which sources it draws on. Docs: https://help.decodo.com/docs/web-scraping-api-perplexity

## 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": ""
    }
  }
}
```

**Requires environment variables:** `SCRAPER_API_TOKEN` — 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 does

Decodo MCP Server gives MCP clients access to Decodo's web data services. Agents can retrieve pages as Markdown, capture webpage screenshots, enumerate site URLs, run asynchronous crawls, and search supported web destinations. The tool collection also includes purpose-built operations for Google, Amazon, Walmart, Target, TikTok, and YouTube.

The returned data is suited to both text-based and structured workflows. Markdown can be passed into an LLM or retrieval pipeline, screenshots provide visual page context, and target-specific tools return parsed results for searches, products, listings, posts, channels, and videos.

## How it works

The server can be used through Decodo's hosted MCP endpoint at `https://mcp.decodo.com/mcp`, or run locally with the npm package or a build from the repository. Hosted connections send credentials in an `Authorization` header. Local connections provide the credential through the `SCRAPER_API_TOKEN` environment variable.

Web crawling is asynchronous. `crawl_start` returns a crawl identifier without waiting for completion; `crawl_status` reports discovered, completed, and failed pages; `crawl_results` reads completed pages in batches using a cursor; and `crawl_cancel` stops the crawl while keeping already collected pages available.

Tools are grouped into selectable toolsets. The documented groups include `web`, `search`, `ecommerce`, `social_media`, and `ai`. Hosted connections can select groups with the `toolsets` query parameter, while an unqualified connection registers all tools. The Claude connector exposes the `web` and `search` groups.

## Setup and configuration

Create a Decodo account, obtain a Web Data API key from the dashboard, and use an MCP-compatible client. The local server requires Node.js 18 or newer. A hosted client configuration uses the following structure:

```json
{
  "mcpServers": {
    "Decodo": {
      "url": "https://mcp.decodo.com/mcp",
      "headers": {
        "Authorization": "Bearer <api_key>"
      }
    }
  }
}
```

For a local npm configuration, run the package with `npx` and set `SCRAPER_API_TOKEN`:

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

Older Decodo plans can use a basic authentication token in place of the API key. The same local environment variable accepts either credential type, while hosted connections use `Bearer` for an API key or `Basic` for the older token.

## Tools and capabilities

- `scrape_as_markdown` fetches a URL and returns Markdown.
- `screenshot` captures a webpage as a PNG image.
- `map` lists URLs on a site without retrieving their content.
- `crawl_start`, `crawl_status`, `crawl_results`, and `crawl_cancel` manage multi-page crawls.
- `search` returns ranked web results.
- Google tools cover general search, ads, Lens, AI Mode, and Travel Hotels results.
- Amazon tools cover search, products, pricing, sellers, and bestsellers.
- Walmart and Target tools cover search and product pages.
- TikTok tools cover posts, Shop searches, Shop products, and Shop URLs.
- YouTube tools retrieve video metadata, channel videos, subtitles, and search results.

## Limitations and notes

Several operations require an API key, including site mapping, crawling, and the general `search` tool. Access depends on the Decodo credential and service configuration. The hosted connection and local process use different credential locations, so switching between them requires changing the MCP configuration. Crawl results are returned incrementally rather than as one immediate response, and pagination uses a cursor.

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