Decodo
公式簡単なウェブデータアクセス。ウェブサイトやオンラインソースからの情報取得を簡素化します。
Decodo MCPで何ができますか?
- ページをMarkdownとしてスクレイピング — JavaScriptを多用したページを含む任意のURLをスクレイピングし、LLM向けのMarkdownを返すようアシスタントに依頼できます。
- スクリーンショットを取得 — 任意のウェブページのPNGスクリーンショットをリクエストできます。特定の国のIPアドレスからの取得も可能です。
- サイトをクロール — クロールを開始して進捗を確認し、クロール済みのページを数件ずつ取得したり、クロールをキャンセルしたりできます。
- 検索エンジン — ウェブ、Google、Bing、Google Ads、Google Lens、Google Travel Hotelsで検索し、解析済みの結果を取得できます。
- eコマースデータ — Amazon、Walmart、Target、TikTok Shopから商品、価格、販売者、ベストセラーのデータを取得できます。
- ソーシャルメディアとAIの回答 — TikTokの投稿やYouTubeのメタデータ、字幕、チャンネル、検索結果を収集したり、ChatGPTやPerplexityに問い合わせたりできます。
ドキュメント
Decodo MCP Server
MCP(Model Context Protocol)を使用して、LLMやAIエージェントをライブのWebデータに接続します。Decodo MCP Serverを使用すると、Claude、Cursor、WindsurfなどのAIツールから直接、Webサイト、検索エンジン、eコマースプラットフォーム、ソーシャルメディアをスクレイピングできます。スクレイピングインフラを ゼロから構築する必要はありません。
- JSON、Markdown、スクリーンショットによる構造化出力
- サーバー側のJavaScriptレンダリングとアンチボット処理
- 195以上のロケーションにまたがる1億2500万以上のIP
Decodo MCPサーバーとは?
Decodo MCP Serverは、AIエージェント向けのWebスクレイピングレイヤーです。MCP互換のクライアントを DecodoのWeb Scraping APIに接続し、以下を可能にします:
- LLM向けのWebスクレイピング
- RAG向けのリアルタイムデータ取得
- AIエージェントによるブラウジングとリサーチ
- 動的Webサイトからの構造化データ抽出
プロキシ、パーサー、リトライロジックを維持する代わりに、信頼性の高いWebデータアクセスのための 単一の統合ポイントが得られます。
WebスクレイピングにMCPを使用する理由
Model Context Protocol(MCP)は、AIエージェントを外部ツールやデータソースに接続するための 新たな標準です。MCPを使用すると:
- エージェントがツールを動的に呼び出せる
- 統合が標準化されたまま保たれる
- ワークフローが環境をまたいでスケールする
Decodo MCP Serverは、この標準を通じてエージェントに信頼性の高い本番環境対応のWebアクセスを提供します。
主な機能
AIエージェント向けのWebスクレイピング、インフラ不要。 プロキシローテーション、CAPTCHA解決、アンチボットシステムを 処理することなく、JavaScriptを多用するページを含むあらゆるWebサイトをスクレイピングできます。
LLMワークフロー向けの構造化出力。 Markdown(LLM対応)、JSON(構造化パイプライン向け)、 スクリーンショット(視覚的コンテキスト向け)を提供し、RAGパイプライン、AIリサーチエージェント、自動化フロー向けに構築されています。
人気のターゲットを標準サポート。 GoogleとBing(SERP)、Amazon、 Walmart、Target(eコマース)、TikTokとYouTube(ソーシャルメディア)、ChatGPTと Perplexity(AI検索)向けの既製ツールを提供します。
グローバルプロキシインフラ。 1億1500万以上のレジデンシャルIP、195以上のジオロケーション、そして 最も保護されたターゲットでも99.99%の成功率を実現します。
モジュール式のMCPツールセット。 必要なものだけを有効化できます:web、search、ecommerce、social_media、
ai により、ツール選択がクリーンになりエージェントのパフォーマンスが向上します。
迅速な価値実現。 APIキーから最初のスクレイピングまで数分で完了し、セットアップのオーバーヘッドはありません。
ユースケース
AIエージェント向けのWebスクレイピング、大規模な構造化データ抽出、 動的Webサイトへの信頼性の高いアクセス、RAG向けのリアルタイムデータ、またはスクレイピングインフラをゼロから構築する代わりの手段が必要な場合に、Decodo MCP Serverを使用してください。一般的なシナリオ:
- AI駆動のWebスクレイピング – 静的なトレーニングデータに依存する代わりに、LLMに 新鮮なデータを収集する能力を与えます。
- ライブデータによるRAG – リアルタイムのGoogle、Bing、AI検索結果を検索パイプラインに 取り込みます。
- eコマースインテリジェンス – ブロックされることなく、マーケットプレイス全体で商品の価格、リスティング、販売者を 追跡します。
- ソーシャルメディアデータ収集 – TikTokやYouTubeから投稿、チャンネル、エンゲージメントデータを 収集します。
- 旅行と価格の集約 – Webサイト全体でライブの価格と空き状況を収集するツールを 構築します。
クイックスタート
- dashboard.decodo.com で無料アカウントを作成 – 最大1万件の 無料リクエスト、クレジットカード不要。
- 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 | 任意のWebページのスクリーンショットを撮影し、PNG画像として返します。 | 米国のIPアドレスからgithub.comのスクリーンショットを撮影してください。 |
map | コンテンツを取得せずに、Webサイト上のURLを一覧表示します。APIキーのみ。 | docs.decodo.comをマッピングして、/scraping-api配下のページを一覧表示してください。 |
crawl_start | Webサイトのクロールを開始し、待機せずにクロールIDを返します。APIキーのみ。 | decodo.com/blogの最初の10ページをクロールしてください。 |
crawl_status | クロールの進捗(検出済み、完了、失敗したページ数)を報告します。APIキーのみ。 | クロールはもう完了しましたか? |
crawl_results | クロールしたページをMarkdownとして、カーソルを使って数ページずつ返します。APIキーのみ。 | クロールで見つかったページを表示してください。 |
crawl_cancel | 実行中のクロールを停止します。それまでにクロールしたページは引き続き閲覧できます。APIキーのみ。 | クロールをキャンセルしてください。 |
search | Webを検索し、ランク付けされた結果を返します。APIキーのみ。 | MCPサーバーのホスティングオプションについてWebを検索してください。 |
google_search | 指定したクエリでGoogle検索をスクレイピングし、解析済みの結果を返します。 | Google検索で靴をスクレイピングして、最上位の結果を教えてください。 |
google_ads | Google広告の検索結果をスクレイピングします。 | Google広告でノートパソコンをスクレイピングして、上位の広告を表示してください。 |
google_lens | Googleレンズの画像検索結果をスクレイピングします。 | この画像をGoogleレンズで検索してください: https://example.com/image.jpg |
google_ai_mode | Google AIモード(AIを使った検索)の結果をスクレイピングします。 | Google AIモードに質問してください: 犬種のトップ3は何ですか? |
google_travel_hotels | Googleトラベルホテルの検索結果をスクレイピングします。 | Googleトラベルホテルでパリのホテルを検索してください。 |
amazon_search | 指定したクエリでAmazon検索をスクレイピングし、解析済みの結果を返します。 | Amazon検索でワイヤレスキーボードをスクレイピングしてください。 |
amazon_product | Amazon商品ページをスクレイピングします。 | Amazon商品B09H74FXNWをスクレイピングして、詳細を表示してください。 |
amazon_pricing | Amazon商品の価格情報をスクレイピングします。 | Amazon商品B09H74FXNWの価格を取得してください。 |
amazon_sellers | Amazon出品者情報をスクレイピングします。 | Amazon出品者A1R0Z7FJGTKESHの情報を取得してください。 |
amazon_bestsellers | Amazonベストセラーリストをスクレイピングします。 | Amazonのエレクトロニクス部門のベストセラーを表示してください。 |
walmart_search | 指定したクエリでWalmart検索をスクレイピングし、解析済みの結果を返します。 | Walmart検索でキャンプ用テントをスクレイピングしてください。 |
walmart_product | Walmart商品ページをスクレイピングします。 | Walmart商品15296401808をスクレイピングしてください。 |
target_search | 指定したクエリでTarget検索をスクレイピングし、解析済みの結果を返します。 | Target検索でキッチン家電をスクレイピングしてください。 |
target_product | Target商品ページをスクレイピングします。 | Target商品92186007をスクレイピングしてください。 |
tiktok_post | TikTok投稿のURLをスクレイピングして構造化データ(エンゲージメント、キャプション、ハッシュタグなど)を取得します。 | このTikTok投稿をスクレイピングしてください: https://www.tiktok.com/@nba/video/7393013274725403950 |
tiktok_shop_search | 指定したクエリでTikTok Shop検索をスクレイピングし、解析済みの結果を返します。 | TikTok Shop検索でスマホケースをスクレイピングしてください。 |
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検索結果をスクレイピングします。 | Bingでノートパソコンのレビューを検索してください。 |
chatgpt | 単一のプロンプトをChatGPTに送信し、その回答を返します(会話履歴なし)。 | 量子コンピューティングを簡単な言葉で説明するようChatGPTに依頼してください。 |
perplexity | 単一のプロンプトをPerplexityに送信し、その回答を返します(会話履歴なし)。 | Web開発の最新トレンドについてPerplexityに尋ねてください。 |
パラメータ
以下のパラメータはユーザーのプロンプトから推測されます:
| パラメータ | 説明 |
|---|---|
jsRender | 対象URLをヘッドレスブラウザでレンダリングします。 |
geo | リクエストの発信元となる国を設定します。 |
locale | リクエストのロケールを設定します。 |
tokenLimit | 返す最大文字数(デフォルト45000)。コンテキストウィンドウが小さい場合に便利です。 |
prompt | AIツール(chatgpt、perplexity)に送信するプロンプト。 |
search | ChatGPTのWeb検索機能を有効にします(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つを組み合わせることで、エージェントは実行レイヤー(このサーバー)と意思決定レイヤー(スキル)の両方を1つのセットアップで手に入れることができます。
クイックスタート(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 エージェントスキル、 Decodo OpenClaw スキル
試してみる
Decodo MCP Server を数クリックで AI ワークフローに組み込み、AI エージェントにあらゆるウェブサイトからのリアルタイムデータを装備させましょう。
ライセンス
すべてのコードは MIT License の下でリリースされています。
