Decodo

- Scrape any webpage as Markdown— extract clean, LLM-ready content from a URL usingscrape_as_markdown.
- Capture webpage screenshots— take a visual snapshot of any site withscreenshot.
- Search Google and Bing— retrieve parsed SERP results viagoogle_searchandbing_search.
- Pull eCommerce product data— look up pricing, sellers, and bestsellers on Amazon, Walmart, or Target.
- Gather social media content— scrape Reddit posts, TikTok videos, or YouTube metadata and subtitles.
- Query AI search tools— interact with ChatGPT, Perplexity, or Google AI Mode for AI-powered answers.

Connect LLMs and AI agents to live web data using MCP (Model Context Protocol). The Decodo MCP Server lets you scrape websites, search engines, eCommerce platforms, and social media directly from AI tools like Claude, Cursor, and Windsurf, all without the need to build scraping infrastructure from scratch.

- Structured outputs in JSON, Markdown, and screenshots
- Server-side JavaScript rendering and anti-bot handling
- 125M+ IPs across 195+ locations

The Decodo MCP Server is a web scraping layer for AI agents. It connects MCP-compatible clients to Decodo's Web Scraping API, enabling:

- Web scraping for LLMs
- Real-time data retrieval for RAG
- AI agent browsing and research
- Structured data extraction from dynamic websites

Instead of maintaining proxies, parsers, and retry logic, you get a single integration point for reliable web data access.

Model Context Protocol (MCP) is the emerging standard for connecting AI agents to external tools and data sources. With MCP:

- Agents can call tools dynamically
- Integrations stay standardized
- Workflows scale across environments

The Decodo MCP Server gives your agents reliable, production-ready web access through this standard.

Web scraping for AI agents, no infrastructure required.Scrape any website, including JavaScript-heavy pages, without handling proxy rotation, CAPTCHA solving, or anti-bot systems.

Structured outputs for LLM workflows.Markdown (LLM-ready), JSON (for structured pipelines), and screenshots (for visual context), built for RAG pipelines, AI research agents, and automation flows.

Built-in support for popular targets.Ready-made tools for Google and Bing (SERPs), Amazon, Walmart, and Target (eCommerce), Reddit, TikTok, and YouTube (social media), and ChatGPT and Perplexity (AI search).

Global proxy infrastructure.125M+ residential IPs, 195+ geo-locations, and a 99.99% success rate on even the most protected targets.

Modular MCP toolsets.Enable only what you need:web,search,ecommerce,social_media,aifor cleaner tool selection and better agent performance.

Fast time to value.From API key to first scrape in minutes, no setup overhead.

Use the Decodo MCP Server when you need web scraping for AI agents, structured data extraction at scale, reliable access to dynamic websites, real-time data for RAG, or an alternative to building scraping infrastructure from scratch. Common scenarios:

- AI-powered web scraping– give LLMs the ability to collect fresh data instead of relying on static training data.
- RAG with live data– pull real-time Google, Bing, and AI search results into retrieval pipelines.
- eCommerce intelligence– track product prices, listings, and sellers across marketplaces without getting blocked.
- Social media data collection– gather posts, channels, and engagement data from Reddit, TikTok, and YouTube.
- Travel and price aggregation– build tools that collect live pricing and availability across websites.
- Create a free accountatdashboard.decodo.com– up to 2K free requests, no credit card required.
- Get your API key.Obtain a Web Scraping API basic authentication token from the dashboard.
- Download Node.js 18+fromhttps://nodejs.org.
- Get MCP clientlike Claude Desktop, Curson, Windsurf or other MCP-compatible tools..
- Configure the MCP serverin your AI client (see configuration examples below).

{ "mcpServers": { "Decodo": { "url": "https://mcp.decodo.com/mcp", "headers": { "Authorization": "Basic <basic_auth_token>" } } } }

{ "mcpServers": { "Decodo": { "command": "npx", "args": ["-y", "@decodo/mcp-server"], "env": { "SCRAPER_API_TOKEN": "<basic_auth_token>", "TOOLSETS": "web,ai" } } } }

- Open Settings → MCP.
- Click Add a new global MCP server (opens mcp.json).
- Add the same configuration as above.
- Save — look for a green status indicator next to Decodo.
- Open Settings → Windsurf Settings.
- Scroll to Cascade → Add custom server + (opens mcp_config.json).
- Add the same configuration as above.
- Save and restart Windsurf.

Once connected, try this prompt in your client:

▎ "Scrape the titles of the top 5 articles from Hacker News"

You should get a structured list back within seconds. If you see an auth error, double-check your token from the dashboard.

- Node.js 18.0+
- An MCP client - popular choices areClaude DesktopandCursor

git clone https://github.com/Decodo/mcp-server

cd decodo-mcp-server npm install npm run build

/Users/your.user/projects/decodo-mcp/build/index.js

{ "mcpServers": { "decodo-mcp": { "command": "node", "args": ["/Users/your.user/projects/decodo-mcp/build/index.js"], "env": { "SCRAPER_API_TOKEN": "<web_scraping_api_base64_token>" } } } }

Tools are organized into toolsets. You can selectively enable specific toolsets by passing a comma-separated list via thetoolsetsquery parameter:

"Decodo MCP Server": { "url": "https://mcp.decodo.com/mcp?toolsets=web,ai", "headers": { "Authorization": "Basic <your_auth_token>" } }

When no toolsets are specified, all tools are registered.

The following parameters are inferred from user prompts:

Query your AI agent with the following prompt:

Scrape peacock.com from a German IP address and tell me the pricing.

This prompt will say that peacock.com is geo-restricted. To bypass the geo-restriction:

Scrape peacock.com from a US IP address and tell me the pricing.

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 returnfull content:

Scrape hacker news, return full content.

This server gives your agent the scrapingtools.Decodo/agent-skillsteaches itwhento reach for them,whichsurface to use, andhowto call it — so the agent picks the right tool and parameters on its own instead of guessing.

/plugin marketplace add Decodo/agent-skills /plugin install decodo@decodo-skills

See theagent-skills READMEfor manual install and other agents (Cursor, Codex, Gemini CLI, Windsurf).

Web Scraping API,Decodo agent skills,Decodo OpenClaw skill

All code is released under theMIT License.

Extract clean, structured data from any URL — directly from Claude, Cursor, or any MCP-compatible AI.