Decodo Web Scraping APIを通じて、AI agentによるウェブページのスクレイピング、検索、サイトのクロール、およびeCommerceやソーシャルメディアからのデータ取得を可能にします。
別名 Decodo/mcp-server, @decodo/mcp-server
- スター
- 41
- ツール
- 33
- ダウンロード数(30日間)
- 2,738
- 最新バージョン
- 1.7.0
- 最終コミット
- 2026年11月10日
- ライセンス
- —
Decodo MCPとは
Decodo Web Scraping APIを通じて、AI agentによるウェブページのスクレイピング、検索、サイトのクロール、およびeCommerceやソーシャルメディアからのデータ取得を可能にします。 33個のツールを提供しており、scrape_as_markdown, screenshot, mapなどがあります。
プロジェクトのREADMEから生成された概要
Decodo MCP server について
このサーバーは、Claude、Cursor、Windsurfなどのツールを使用する開発者が、AI agentをライブのウェブデータに接続することを可能にします。Decodo Web Scraping APIと統合することで、LLMはカスタムのスクレイピングインフラ、プロキシ管理、またはCAPTCHAの解決を必要とせずにデータを取得できます。ユーザーは、標準化されたインターフェースを通じて、検索エンジン、ソーシャルメディアプラットフォーム、および主要なeCommerceサイトから情報を取得できます。
セットアップにはDecodo APIキーと互換性のあるMCPクライアントが必要です。サーバーはNode.js経由でローカルで実行するか、ホストされたURLに接続できます。RAGパイプラインや自動リサーチをサポートするために、Markdown、JSON、またはスクリーンショット形式で構造化されたデータを提供します。開発者は、web、search、ecommerce、social_media、aiなどの特定のツールセットを選択して、agentのパフォーマンスを最適化し、利用可能なツールの範囲を制限できます。
できること
- 1リアルタイムRAG統合GoogleやBingの検索結果からのライブデータを、検索拡張生成(RAG)パイプラインに提供します。
- 2自動eCommerceインテリジェンスAmazon、Walmart、Targetなどのマーケットプレイスにおける製品リスティングや価格を追跡します。
- 3ソーシャルメディアのデータ収集YouTubeやTikTokからエンゲージメント指標やコンテンツを収集します。
- 4動的なウェブサイトのスクレイピングプロキシのローテーションやアンチボットシステムを管理することなく、JavaScriptを多用するウェブサイトからコンテンツを抽出します。
プロジェクトの README から作成されています。すべてのユースケースは、その引用と照らし合わせて確認されています。
Decodo MCPのインストール方法
フォーマット検証日 2026年11月10日Cursor に追加Gooseに追加Claude CodeにDecodo MCPをインストール
$ claude mcp add mcp-server -- npx -y @decodo/mcp-serverCursorにDecodo MCPをインストール
~/.cursor/mcp.json
{
"mcpServers": {
"mcp-server": {
"command": "npx",
"args": [
"-y",
"@decodo/mcp-server"
]
}
}
}VS CodeにDecodo MCPをインストール
.vscode/mcp.json
{
"servers": {
"mcp-server": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@decodo/mcp-server"
]
}
}
}VS Code CLIにDecodo MCPをインストール
$ code --add-mcp '{"name":"mcp-server","type":"stdio","command":"npx","args":["-y","@decodo/mcp-server"]}'Claude DesktopにDecodo MCPをインストール
claude_desktop_config.json
{
"mcpServers": {
"mcp-server": {
"command": "npx",
"args": [
"-y",
"@decodo/mcp-server"
]
}
}
}CodexにDecodo MCPをインストール
$ codex mcp add mcp-server -- npx -y @decodo/mcp-serverCodex config.tomlにDecodo MCPをインストール
~/.codex/config.toml
[mcp_servers.mcp-server] command = "npx" args = ["-y", "@decodo/mcp-server"]
Gemini CLIにDecodo MCPをインストール
$ gemini mcp add -s user mcp-server npx -- -y @decodo/mcp-serverGemini settings.jsonにDecodo MCPをインストール
~/.gemini/settings.json
{
"mcpServers": {
"mcp-server": {
"command": "npx",
"args": [
"-y",
"@decodo/mcp-server"
]
}
}
}Decodo MCPツール 33
READMEから検出scrape_as_markdownscreenshotmapcrawl_startcrawl_statuscrawl_resultscrawl_cancelsearchgoogle_searchgoogle_adsgoogle_lensgoogle_ai_mode
| scrape_as_markdown | — | |
| screenshot | — | |
| map | — | |
| crawl_start | — | |
| crawl_status | — | |
| crawl_results | — | |
| crawl_cancel | — | |
| search | — | |
| google_search | — | |
| google_ads | — | |
| google_lens | — | |
| google_ai_mode | — |
33個のツールをすべて表示ツールを折りたたむ
google_travel_hotelsamazon_searchamazon_productamazon_pricingamazon_sellersamazon_bestsellerswalmart_searchwalmart_producttarget_searchtarget_producttiktok_posttiktok_shop_searchtiktok_shop_producttiktok_shop_urlyoutube_metadatayoutube_channelyoutube_subtitlesyoutube_searchbing_searchchatgptperplexity
| google_travel_hotels | — | |
| amazon_search | — | |
| amazon_product | — | |
| amazon_pricing | — | |
| amazon_sellers | — | |
| amazon_bestsellers | — | |
| walmart_search | — | |
| walmart_product | — | |
| target_search | — | |
| target_product | — | |
| tiktok_post | — | |
| tiktok_shop_search | — | |
| tiktok_shop_product | — | |
| tiktok_shop_url | — | |
| youtube_metadata | — | |
| youtube_channel | — | |
| youtube_subtitles | — | |
| youtube_search | — | |
| bing_search | — | |
| chatgpt | — | |
| perplexity | — |
設定
SCRAPER_API_TOKEN
| 名前 | 説明 | 種類 |
|---|---|---|
| SCRAPER_API_TOKEN | — |
自動チェック
実行日 2026年11月12日完全なレポート →自動チェックに合格しました。これはセキュリティ監査ではありません。コードを読み、サーバーに必要最小限のアクセス権を与えてください。 チェックの仕組み · 点数を上げるための改善点
- ソースリポジトリがリンクされており、アクセス可能合格
- オープンソースライセンス (OSI)No license検出事項
- 過去1年以内にコミットまたはリリースあり合格
- パッケージ名が有名なパッケージに酷似していない合格
- リモートエンドポイントがHTTPSを使用未チェック
- 破壊的なツールがラベル付けされている合格
- モデルへの隠れた指示がない合格
- パッケージおよびその依存関係に重大な勧告なし合格
README
GitHubで見るDecodo MCP Server
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
What is Decodo MCP server?
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.
Why use MCP for web scraping?
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.
Key features
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), TikTok and YouTube (social media), and ChatGPT and Perplexity (AI search).
Global proxy infrastructure. 115M+ 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,
ai for cleaner tool selection and better agent performance.
Fast time to value. From API key to first scrape in minutes, no setup overhead.
Use cases
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 TikTok and YouTube.
- Travel and price aggregation – build tools that collect live pricing and availability across websites.
Quick start
- Create a free account at dashboard.decodo.com – up to 10K free requests, no credit card required.
- Get your API key. Copy your Web Data API key from your Web Data API subscription on the dashboard. Older plans have a basic authentication token, which also works (see Authentication).
- Download Node.js 18+ from https://nodejs.org.
- Get MCP client like Claude Desktop, Cursor, Windsurf or other MCP-compatible tools.
- Configure the MCP server in your AI client (see configuration examples below).
Connecting to Decodo's MCP server
Open your preferred MCP client and add the following configuration (see examples for Claude Code, Cursor, Windsurf bellow):
{
"mcpServers": {
"Decodo": {
"url": "https://mcp.decodo.com/mcp",
"headers": {
"Authorization": "Bearer <api_key>"
}
}
}
}
Authentication
| Credential | Where to get it | Hosted server header | Local server env |
|---|---|---|---|
| API key (recommended) | Web Data API subscription on the dashboard | Authorization: Bearer <api_key> |
SCRAPER_API_TOKEN=<api_key> |
| Basic authentication token (older plans) | Web Scraping API page on the dashboard | Authorization: Basic <basic_auth_token> |
SCRAPER_API_TOKEN=<basic_auth_token> |
The local server reads either credential from SCRAPER_API_TOKEN and works out which one it got.
Claude Desktop
- Open Claude Desktop → Settings → Developer → Edit Config.
- Add to claude_desktop_config.json:
{
"mcpServers": {
"Decodo": {
"command": "npx",
"args": ["-y", "@decodo/mcp-server"],
"env": {
"SCRAPER_API_TOKEN": "<api_key>",
"TOOLSETS": "web,ai"
}
}
}
}
- Save and restart Claude Desktop.
Cursor
- 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.
Windsurf
- Open Settings → Windsurf Settings.
- Scroll to Cascade → Add custom server + (opens mcp_config.json).
- Add the same configuration as above.
- Save and restart Windsurf.
eve (Vercel)
- In your eve agent project, run
eve add connection/decodo, or createagent/connections/decodo.ts:
import { always } from 'eve/tools/approval';
import { defineMcpClientConnection } from 'eve/connections';
export default defineMcpClientConnection({
url: 'https://mcp.decodo.com/mcp',
description:
'Decodo: scrape web pages as Markdown, search the web, map and crawl sites, and read e-commerce and YouTube data.',
headers: () => ({
Authorization: `Bearer ${process.env.DECODO_API_KEY!}`,
}),
approval: always(),
});
- Set
DECODO_API_KEY=<api_key>in the agent's server-side environment (.env.locallocally, project env vars on Vercel). approval: always()asks before every call, since calls use your plan; relax it with eve's approval rules if you prefer.
Test your setup
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 API key on the dashboard.
Local development
Only needed if you want to change the server code.
Prerequisites
- Node.js 18.0+
- An MCP client - popular choices are Claude Desktop and Cursor
Step-by-step guide
- Clone this repository:
git clone https://github.com/Decodo/mcp-server
- Run the following commands in the terminal:
cd mcp-server
npm install
npm run build
- Take note of your build location:
cd build/
pwd
Adding index.js to the end of this directory, your build file location should look something like
this:
/Users/your.user/projects/mcp-server/build/index.js
- Update your MCP client with the server information:
{
"mcpServers": {
"decodo-mcp": {
"command": "node",
"args": ["/Users/your.user/projects/mcp-server/build/index.js"],
"env": {
"SCRAPER_API_TOKEN": "<api_key>"
}
}
}
}
Toolsets
Tools are organized into toolsets. Which ones you get depends on how you connect.
Claude (official connector)
The Decodo connector in Claude's connector directory includes the Web Data API tools only:
| Toolset | Tools |
|---|---|
web |
scrape_as_markdown, screenshot, map, crawl_start, crawl_status, crawl_results, crawl_cancel |
search |
search |
Any MCP client
You can selectively enable specific toolsets by passing a comma-separated list via the toolsets
query parameter:
"Decodo MCP Server": {
"url": "https://mcp.decodo.com/mcp?toolsets=web,ai",
"headers": {
"Authorization": "Bearer <api_key>"
}
}
When no toolsets are specified, all tools are registered.
| Toolset | Tools |
|---|---|
web |
scrape_as_markdown, screenshot, map, crawl_start, crawl_status, crawl_results, crawl_cancel |
search |
search, google_search, google_ads, google_lens, google_travel_hotels, bing_search |
ecommerce |
amazon_search, amazon_product, amazon_pricing, amazon_sellers, amazon_bestsellers, walmart_search, walmart_product, target_search, target_product, tiktok_shop_search, tiktok_shop_product, tiktok_shop_url |
social_media |
tiktok_post, youtube_metadata, youtube_channel, youtube_subtitles, youtube_search |
ai |
chatgpt, perplexity, google_ai_mode |
Tools
The server exposes the following tools:
| Tool | Description | Example prompt |
|---|---|---|
scrape_as_markdown |
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. |
screenshot |
Captures a screenshot of any webpage and returns it as a PNG image. | Take a screenshot of github.com from a US IP address. |
map |
Lists the URLs on a website without fetching their content. API key only. | Map docs.decodo.com and list the pages under /scraping-api. |
crawl_start |
Starts crawling a website and returns the crawl id without waiting. API key only. | Crawl the first 10 pages of decodo.com/blog. |
crawl_status |
Reports a crawl's progress: pages discovered, completed and failed. API key only. | Is my crawl finished yet? |
crawl_results |
Returns crawled pages as Markdown, a few at a time with a cursor. API key only. | Show me the pages my crawl found. |
crawl_cancel |
Stops a running crawl; pages crawled so far stay readable. API key only. | Cancel my crawl. |
search |
Searches the web and returns ranked results. API key only. | Search the web for MCP server hosting options. |
google_search |
Scrapes Google Search for a given query, and returns parsed results. | Scrape Google Search for shoes and tell me the top position. |
google_ads |
Scrapes Google Ads search results. | Scrape Google Ads for laptop and show me the top ads. |
google_lens |
Scrapes Google Lens image search results. | Search Google Lens for this image: https://example.com/image.jpg |
google_ai_mode |
Scrapes Google AI Mode (Search with AI) results. | Ask Google AI Mode: What are the top three dog breeds? |
google_travel_hotels |
Scrapes Google Travel Hotels search results. | Search Google Travel Hotels for hotels in Paris. |
amazon_search |
Scrapes Amazon Search for a given query, and returns parsed results. | Scrape Amazon Search for wireless keyboard. |
amazon_product |
Scrapes Amazon Product page. | Scrape Amazon product B09H74FXNW and show me the details. |
amazon_pricing |
Scrapes Amazon Product pricing information. | Get pricing for Amazon product B09H74FXNW. |
amazon_sellers |
Scrapes Amazon Seller information. | Get information about Amazon seller A1R0Z7FJGTKESH. |
amazon_bestsellers |
Scrapes Amazon Bestsellers list. | Show me Amazon bestsellers in electronics. |
walmart_search |
Scrapes Walmart Search for a given query, and returns parsed results. | Scrape Walmart Search for camping tent. |
walmart_product |
Scrapes Walmart Product page. | Scrape Walmart product 15296401808. |
target_search |
Scrapes Target Search for a given query, and returns parsed results. | Scrape Target Search for kitchen appliances. |
target_product |
Scrapes Target Product page. | Scrape Target product 92186007. |
tiktok_post |
Scrapes a TikTok post URL for structured data (e.g. engagement, caption, hashtags). | Scrape this TikTok post: https://www.tiktok.com/@nba/video/7393013274725403950 |
tiktok_shop_search |
Scrapes TikTok Shop Search for a given query, and returns parsed results. | Scrape TikTok Shop Search for phone cases. |
tiktok_shop_product |
Scrapes TikTok Shop Product page. | Scrape TikTok Shop product 1731541214379741272. |
tiktok_shop_url |
Scrapes TikTok Shop page by URL. | Scrape this TikTok Shop URL: https://www.tiktok.com/shop/s?q=HEADPHONES |
youtube_metadata |
Scrapes YouTube video metadata. | Get metadata for YouTube video dFu9aKJoqGg. |
youtube_channel |
Scrapes YouTube channel videos. | Scrape YouTube channel @decodo_official. |
youtube_subtitles |
Scrapes YouTube video subtitles. | Get subtitles for YouTube video L8zSWbQN-v8. |
youtube_search |
Search YouTube videos. | Search YouTube for "How to care for chinchillas". |
bing_search |
Scrapes Bing Search results. | Search Bing for laptop reviews. |
chatgpt |
Sends a single prompt to ChatGPT and returns its answer (no conversation history). | Ask ChatGPT to explain quantum computing in simple terms. |
perplexity |
Sends a single prompt to Perplexity and returns its answer (no conversation history). | Ask Perplexity what the latest trends in web development are. |
Parameters
The following parameters are inferred from user prompts:
| Parameter | Description |
|---|---|
jsRender |
Renders target URL in a headless browser. |
geo |
Sets the country from which the request will originate. |
locale |
Sets the locale of the request. |
tokenLimit |
Maximum number of characters to return (default 45000). Useful if the context window is small. |
prompt |
Prompt to send to AI tools (chatgpt, perplexity). |
search |
Activates ChatGPT's web search functionality (chatgpt only). |
xhr |
When true, includes XHR or fetch responses in the scrape result where supported (e.g. tiktok_post). |
deviceType |
Device type to emulate (desktop, mobile, tablet). Parsed targets are stricter: Amazon tools are desktop-only so they omit it, and bing_search/google_ai_mode accept desktop and mobile only. |
domain |
Domain to use for the request (e.g., amazon.com, amazon.co.uk, bing.com). |
pageFrom |
Starting page number for pagination. |
deliveryZip |
ZIP code for delivery location (Target, Walmart). |
storeId |
Store ID for local inventory (Walmart). |
country |
Country for TikTok Shop requests. |
limit |
Maximum number of results to return (e.g., YouTube channel videos). |
language_code |
Language code for subtitles (e.g., en, es). |
Examples
Scraping geo-restricted content
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.
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:
Scrape hacker news, return 50k tokens.
If your agent has a big context window, tell it to return full content:
Scrape hacker news, return full content.
Decodo MCPのよくある質問
Decodo MCPをClaude Codeに追加するには
ターミナルでclaude mcp add mcp-server -- npx -y @decodo/mcp-serverを実行します。すべてのプロジェクトで利用するには--scope userを追加します。
Decodo MCPをCursorに追加するには
~/.cursor/mcp.jsonを開き、上記のインストールセクションに示すCursor設定を使ってmcpServersの下にサーバーを追加します。
Decodo MCPが提供するツールは
33個のツールを提供しており、scrape_as_markdown, screenshot, map, crawl_start, crawl_statusなどがあります。
Decodo MCP serverの認証方法はどうなっていますか?
AuthorizationヘッダーにBearer tokenとして送信するAPIキーを使用して接続します。古いプランではBasic認証トークンを使用することも可能です。
Decodo MCPはどのような出力形式を返せますか?
使用するツールに応じて、JSON、Markdown、またはスクリーンショットの構造化されたデータを出力します。
Decodo MCPの一部のツールのみを有効にすることはできますか?
はい。ツールはツールセット(web、search、ecommerce、social_media、ai)にグループ化されており、toolsetsクエリパラメータにカンマ区切りのリストを渡すことで指定できます。
Decodo MCPはJavaScriptを多用するサイトや保護されたサイトに対応していますか?
はい。サーバーサイドでのJavaScriptレンダリングとアンチボット機能を提供しているため、ブロックされたページや動的なページもスクレイピング可能です。
Decodo APIキーはどのように取得しますか?
Decodoダッシュボードで無料アカウントを作成し、サブスクリプションページからWeb Data APIキーをコピーしてください。