Decodo MCP Server について
Decodo MCP Serverは、DecodoのWeb Scraping APIをMCPクライアントに接続し、最新のウェブデータを必要とするAIエージェントやチーム向けに提供します。構造化出力、JavaScriptレンダリング、プロキシローテーション、ボット対策を備えたスクレイピングと検索ツールを使えます。
主な機能
- 01JavaScriptレンダリング対応のスクレイピング
- 02JSON、Markdown、スクリーンショット出力
- 03ウェブや各種サービスの検索
- 04選択可能なツールセット
- 05プロキシローテーションとボット対策
活用シーン
- 01RAG用の最新ウェブデータ取得
- 02商品や出品者情報の収集
- 03TikTokやYouTubeのデータ収集
MCP 対応
Decodo Web Scraping APIの機能を、スクレイピング、検索、対象別ツールセットなどのツールとしてMCPクライアントに公開します。
設定
ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。
ツール
ローカルサーバーのツールはマシン上で起動して初めて取得できます。メンテナーはまだツール一覧を提供していません。
詳細
Decodo MCP Server
MCP(Model Context Protocol)を使って、LLMやAIエージェントをウェブの最新データに接続します。Decodo MCP Serverを使えば、スクレイピング基盤を一から構築することなく、Claude、Cursor、Windsurfなどの AIツールからウェブサイト、検索エンジン、eコマースプラットフォーム、ソーシャルメディアを直接スクレイピングできます。
- JSON、Markdown、スクリーンショットによる構造化出力
- サーバー側のJavaScriptレンダリングとボット対策
- 195以上のロケーションにまたがる1億2,500万以上のIP
Decodo MCP serverとは?
Decodo MCP Serverは、AIエージェント向けのウェブスクレイピングレイヤーです。MCP対応クライアントを DecodoのWeb Scraping APIに接続し、次のことを可能にします。
- LLM向けウェブスクレイピング
- RAG向けのリアルタイムデータ取得
- AIエージェントによるブラウジングと調査
- 動的なウェブサイトからの構造化データ抽出
プロキシ、パーサー、再試行ロジックを管理する代わりに、信頼性の高いウェブデータへのアクセスを 単一の統合ポイントで実現できます。
ウェブスクレイピングにMCPを使う理由
Model Context Protocol(MCP)は、AIエージェントを外部のツールやデータソースに接続するための 新たな標準です。MCPを使うと、次のことが可能になります。
- エージェントがツールを動的に呼び出せます
- 統合を標準化できます
- 環境をまたいでワークフローを拡張できます
Decodo MCP Serverは、この標準を通じてエージェントに信頼性の高い本番環境対応のウェブアクセスを提供します。
主な機能
インフラ不要のAIエージェント向けウェブスクレイピング。 プロキシのローテーション、CAPTCHAの解決、 ボット対策システムへの対応をすることなく、JavaScriptを多用するページを含むあらゆるウェブサイトをスクレイピングできます。
LLMワークフロー向けの構造化出力。 RAGパイプライン、AI調査エージェント、自動化ワークフロー向けに、 Markdown(LLM対応)、JSON(構造化パイプライン向け)、スクリーンショット(視覚的なコンテキスト向け)を提供します。
人気のターゲットに対応。 GoogleとBing(SERP)、Amazon、Walmart、Target(eコマース)、 TikTokとYouTube(ソーシャルメディア)、ChatGPTとPerplexity(AI検索)向けのツールをすぐに利用できます。
グローバルなプロキシインフラ。 1億1,500万以上の住宅用IP、195以上の地域ロケーションを備え、 保護が最も厳しいターゲットに対しても99.99%の成功率を実現します。
モジュール式のMCPツールセット。 web、search、ecommerce、social_media、
aiから必要なものだけを有効にできるため、ツール選択がすっきりし、エージェントのパフォーマンスが向上します。
すぐに価値を実感。 APIキーの取得から最初のスクレイピングまで数分で完了し、セットアップの手間はかかりません。
ユースケース
AIエージェント向けのウェブスクレイピング、大規模な構造化データの抽出、動的なウェブサイトへの 安定したアクセス、RAG向けのリアルタイムデータ、またはスクレイピング基盤を一から構築する代替手段が必要な場合は、 Decodo MCP Serverをご利用ください。よくあるシナリオは次のとおりです。
- AIを活用したウェブスクレイピング – 静的な学習データに頼らず、LLMが新しいデータを収集できるようにします。
- 最新データを使ったRAG – Google、Bing、AI検索の結果をリアルタイムで取得し、検索パイプラインに取り込みます。
- eコマースインテリジェンス – ブロックされることなく、複数のマーケットプレイスにわたる商品価格、出品情報、販売者を追跡します。
- ソーシャルメディアデータの収集 – TikTokとYouTubeから投稿、チャンネル、エンゲージメントデータを収集します。
- 旅行・価格集約 – ウェブサイトを横断して、最新の料金や空き状況を収集するツールを構築します。
クイックスタート
- dashboard.decodo.com で無料アカウントを作成します。クレジットカードは不要で、最大 10K 件の無料リクエストを利用できます。
- API キーを取得します。ダッシュボードの Web Data API サブスクリプションから Web Data API キーをコピーします。以前のプランでは基本認証トークンが使用されます。こちらも利用できます(認証を参照)。
- https://nodejs.org からNode.js 18 以降をダウンロードします。
- Claude Desktop、Cursor、Windsurf などの MCP 対応ツールといったMCP クライアントを用意します。
- AI クライアントでMCP サーバーを設定します(以下の設定例を参照)。
Decodo の MCP サーバーへの接続
使用する MCP クライアントを開き、次の設定を追加します(Claude Code、Cursor、Windsurf の例を参照してください)。
{
"mcpServers": {
"Decodo": {
"url": "https://mcp.decodo.com/mcp",
"headers": {
"Authorization": "Bearer <api_key>"
}
}
}
}
認証
| 認証情報 | 取得先 | ホスト型サーバーのヘッダー | ローカルサーバーの環境変数 |
|---|---|---|---|
| API キー(推奨) | ダッシュボードの Web Data API サブスクリプション | Authorization: Bearer <api_key> | SCRAPER_API_TOKEN=<api_key> |
| 基本認証トークン(以前のプラン) | ダッシュボードの Web Scraping API ページ | Authorization: Basic <basic_auth_token> | SCRAPER_API_TOKEN=<basic_auth_token> |
ローカルサーバーは SCRAPER_API_TOKEN からどちらの認証情報も読み取り、どちらを受け取ったかを判別します。
Claude Desktop
- Claude Desktop → Settings → Developer → Edit Config を開きます。
- claude_desktop_config.json に追加します。
{
"mcpServers": {
"Decodo": {
"command": "npx",
"args": ["-y", "@decodo/mcp-server"],
"env": {
"SCRAPER_API_TOKEN": "<api_key>",
"TOOLSETS": "web,ai"
}
}
}
}
- 保存して Claude Desktop を再起動します。
Cursor
- Settings → MCP を開きます。
- Add a new global MCP server をクリックします(mcp.json が開きます)。
- 上記と同じ設定を追加します。
- 保存し、Decodo の横に緑色のステータスインジケーターが表示されていることを確認します。
Windsurf
- Settings → Windsurf Settings を開きます。
- Cascade までスクロールし、Add custom server + をクリックします(mcp_config.json が開きます)。
- 上記と同じ設定を追加します。
- 保存して Windsurf を再起動します。
セットアップをテストする
接続したら、クライアントで次のプロンプトを試してください。
▎ 「Hacker News の上位 5 件の記事のタイトルをスクレイピングしてください」
数秒以内に構造化されたリストが返されます。認証エラーが表示された場合は、ダッシュボードで API キーを再確認してください。
ローカル開発
サーバーコードを変更する場合にのみ必要です。
このリポジトリからサーバーをビルドして実行する
前提条件
- Node.js 18.0+
- MCP クライアント。よく使われるものとして Claude Desktop や Cursor があります。
手順
- このリポジトリをクローンします。
git clone https://github.com/Decodo/mcp-server
- ターミナルで次のコマンドを実行します。
cd mcp-server
npm install
npm run build
- ビルド先の場所を確認します。
cd build/
pwd
このディレクトリの末尾に index.js を追加すると、ビルドファイルの場所は次のようになります。
/Users/your.user/projects/mcp-server/build/index.js
- サーバー情報を使って MCP クライアントを更新します。
{
"mcpServers": {
"decodo-mcp": {
"command": "node",
"args": ["/Users/your.user/projects/mcp-server/build/index.js"],
"env": {
"SCRAPER_API_TOKEN": "<api_key>"
}
}
}
}
ツールセット
ツールはツールセットにまとめられています。利用できるツールセットは、接続方法によって異なります。
Claude(公式コネクター)
Claude のコネクターディレクトリにある Decodo コネクターには、Web Data API ツールのみが含まれています。
| ツールセット | ツール |
|---|---|
web | scrape_as_markdown、screenshot、map、crawl_start、crawl_status、crawl_results、crawl_cancel |
search | search |
任意の MCP クライアント
toolsets クエリパラメーターにカンマ区切りのリストを渡すことで、特定のツールセットを選択して有効にできます。
"Decodo MCP Server": {
"url": "https://mcp.decodo.com/mcp?toolsets=web,ai",
"headers": {
"Authorization": "Bearer <api_key>"
}
}
ツールセットが指定されていない場合は、すべてのツールが登録されます。
| ツールセット | ツール |
|---|---|
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 |
ツール
サーバーは以下のツールを公開します。
| ツール | 説明 | プロンプトの例 |
|---|---|---|
scrape_as_markdown | 任意の対象 URL をスクレイピングします。プロンプトで URL を指定する必要があります。結果を Markdown 形式で返します。 | 米国の IP アドレスから peacock.com をスクレイピングして、料金を教えてください。 |
screenshot | 任意のウェブページのスクリーンショットを撮影し、PNG 画像として返します。 | 米国の IP アドレスから github.com のスクリーンショットを撮影してください。 |
map | ウェブサイトのコンテンツを取得せずに、URL を一覧表示します。API キーのみで利用できます。 | docs.decodo.com のマップを作成し、/scraping-api 配下のページを一覧表示してください。 |
crawl_start | ウェブサイトのクロールを開始し、待機せずにクロール ID を返します。API キーのみで利用できます。 | decodo.com/blog の最初の 10 ページをクロールしてください。 |
crawl_status | クロールの進行状況(検出済み、完了、失敗したページ数)を報告します。API キーのみで利用できます。 | クロールはもう完了しましたか? |
crawl_results | クロールしたページを Markdown 形式で、一度に数件ずつカーソル付きで返します。API キーのみで利用できます。 | クロールで見つかったページを表示してください。 |
crawl_cancel | 実行中のクロールを停止します。これまでにクロールしたページは引き続き閲覧できます。API キーのみで利用できます。 | クロールをキャンセルしてください。 |
search | ウェブを検索し、関連度順の結果を返します。API キーのみで利用できます。 | MCP サーバーのホスティング方法をウェブで検索してください。 |
google_search | 指定したクエリで Google Search をスクレイピングし、解析済みの結果を返します。 | Google Search で靴を検索し、最上位の結果を教えてください。 |
google_ads | Google Ads の検索結果をスクレイピングします。 | Google Ads で laptop を検索し、上位の広告を表示してください。 |
google_lens | Google Lens の画像検索結果をスクレイピングします。 | この画像を Google Lens で検索してください:https://example.com/image.jpg |
google_ai_mode | Google AI Mode(AI による検索)の結果をスクレイピングします。 | Google AI Mode に「人気の犬種を上位 3 つ教えてください」と質問してください。 |
google_travel_hotels | Google Travel Hotels の検索結果をスクレイピングします。 | Google Travel Hotels でパリのホテルを検索してください。 |
amazon_search | 指定したクエリで Amazon Search をスクレイピングし、解析済みの結果を返します。 | Amazon Search でワイヤレスキーボードをスクレイピングしてください。 |
amazon_product | Amazon の商品ページをスクレイピングします。 | Amazon 商品 B09H74FXNW をスクレイピングして、詳細を表示してください。 |
amazon_pricing | Amazon 商品の価格情報をスクレイピングします。 | Amazon 商品 B09H74FXNW の価格を取得してください。 |
amazon_sellers | Amazon の販売者情報をスクレイピングします。 | Amazon の販売者 A1R0Z7FJGTKESH の情報を取得してください。 |
amazon_bestsellers | Amazon のベストセラー一覧をスクレイピングします。 | Amazon のエレクトロニクスのベストセラーを表示してください。 |
walmart_search | 指定したクエリで Walmart Search をスクレイピングし、解析済みの結果を返します。 | Walmart Search でキャンプ用テントをスクレイピングしてください。 |
walmart_product | Walmart の商品ページをスクレイピングします。 | Walmart 商品 15296401808 をスクレイピングしてください。 |
target_search | 指定したクエリで Target Search をスクレイピングし、解析済みの結果を返します。 | Target Search でキッチン家電をスクレイピングしてください。 |
target_product | Target の商品ページをスクレイピングします。 | Target 商品 92186007 をスクレイピングしてください。 |
tiktok_post | TikTok の投稿 URL をスクレイピングし、エンゲージメント、キャプション、ハッシュタグなどの構造化データを取得します。 | この TikTok 投稿をスクレイピングしてください:https://www.tiktok.com/@nba/video/7393013274725403950 |
tiktok_shop_search | 指定したクエリで TikTok Shop Search をスクレイピングし、解析済みの結果を返します。 | TikTok Shop Search でスマートフォンケースをスクレイピングしてください。 |
tiktok_shop_product | TikTok Shop の商品ページをスクレイピングします。 | TikTok Shop 商品 1731541214379741272 をスクレイピングしてください。 |
tiktok_shop_url | URL を指定して TikTok Shop のページをスクレイピングします。 | この TikTok Shop URL をスクレイピングしてください:https://www.tiktok.com/shop/s?q=HEADPHONES |
youtube_metadata | YouTube 動画のメタデータをスクレイピングします。 | YouTube 動画 dFu9aKJoqGg のメタデータを取得してください。 |
youtube_channel | YouTube チャンネルの動画をスクレイピングします。 | YouTube チャンネル @decodo_official をスクレイピングしてください。 |
youtube_subtitles | YouTube 動画の字幕をスクレイピングします。 | YouTube 動画 L8zSWbQN-v8 の字幕を取得してください。 |
youtube_search | YouTube 動画を検索します。 | YouTube で「チンチラの飼い方」を検索してください。 |
bing_search | Bing Search の検索結果をスクレイピングします。 | Bing でノートパソコンのレビューを検索してください。 |
chatgpt | ChatGPT に単一のプロンプトを送信し、回答を返します(会話履歴はありません)。 | ChatGPT に量子コンピューティングを簡単な言葉で説明するよう依頼してください。 |
perplexity | Perplexity に単一のプロンプトを送信し、回答を返します(会話履歴はありません)。 | Perplexity にウェブ開発の最新トレンドを尋ねてください。 |
パラメーター
以下のパラメーターは、ユーザーのプロンプトから推測されます。
| パラメーター | 説明 |
|---|---|
jsRender | ヘッドレスブラウザーで対象の URL をレンダリングします。 |
geo | リクエストの送信元となる国を設定します。 |
locale | リクエストのロケールを設定します。 |
tokenLimit | 返される文字数の上限(デフォルトは45000)です。コンテキストウィンドウが小さい場合に便利です。 |
prompt | AI ツール(chatgpt、perplexity)に送信するプロンプトです。 |
search | ChatGPT のウェブ検索機能を有効にします(chatgpt のみ)。 |
xhr | true の場合、対応しているときはスクレイピング結果に XHR または fetch の応答を含めます(例:tiktok_post)。 |
deviceType | エミュレートするデバイスの種類(desktop、mobile、tablet)です。解析対象は制限が厳しく、Amazon ツールはデスクトップ専用のためこの項目を省略し、bing_search/google_ai_mode は desktop と mobile のみを受け付けます。 |
domain | リクエストに使用するドメイン(例:amazon.com、amazon.co.uk、bing.com)です。 |
pageFrom | ページネーションの開始ページ番号です。 |
deliveryZip | 配送先の ZIP コード(Target、Walmart)です。 |
storeId | 店舗在庫の店舗 ID(Walmart)です。 |
country | TikTok Shop リクエストの国です。 |
limit | 返される結果の上限数(例:YouTube チャンネルの動画)です。 |
language_code | 字幕の言語コード(例:en、es)です。 |
例
地域制限されたコンテンツのスクレイピング
次のプロンプトを使って、AI エージェントに問い合わせます。
Scrape peacock.com from a German IP address and tell me the pricing.
このプロンプトでは、peacock.com が地域制限されていると伝えます。地域制限を回避するには、次のようにします。
Scrape peacock.com from a US IP address and tell me the pricing.
レスポンストークン数の制限
エージェントのコンテキストウィンドウが小さい場合、コンテキストのオーバーフローを防ぐために、スクレイピングで返されるコンテンツは自動的に切り捨てられます。プロンプト内で、返されるトークン数を増やせます。
Scrape hacker news, return 50k tokens.
エージェントのコンテキストウィンドウが大きい場合は、full contentを返すように指示します。
Scrape hacker news, return full content.
Decodo エージェントスキルと併用する
このサーバーは、エージェントにスクレイピング用の ツール を提供します。
Decodo/agent-skills は、いつツールを使うか、どのインターフェースを使うか、どのように呼び出すかをエージェントに教えるため、推測に頼らず、適切なツールとパラメーターを自ら選択できます。
スキルは decodo CLI、このホスト型 MCP サーバー、未加工の HTTP API を使い分け、シェルを利用できない場合は自動的に MCP サーバーにフォールバックします。この2つを組み合わせることで、実行レイヤー(このサーバー)と判断レイヤー(スキル)の両方を、ひとつのセットアップでエージェントに提供できます。
クイックスタート(Claude Code):
/plugin marketplace add Decodo/agent-skills
/plugin install decodo@decodo-skills
手動インストールやその他のエージェント(Cursor、Codex、Gemini CLI、Windsurf)については、agent-skills README を参照してください。
関連リポジトリ
Web Scraping API、 Decodo agent skills、 Decodo OpenClaw skill
試してみる
数回クリックするだけで Decodo MCP Server を AI ワークフローに組み込み、AI エージェントにあらゆるウェブサイトのリアルタイムデータを提供できます。
ライセンス
すべてのコードは MIT License のもとで公開されています。
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。
