mcpField
D
Decodo MCP Server

Decodo MCP Server

リモート
github.com/DecodoAI・エージェント391 日前に更新

Decodo MCP Server について

Decodo MCP Serverは、DecodoのWeb Scraping APIをMCPクライアントに接続し、最新のウェブデータを必要とするAIエージェントやチーム向けに提供します。構造化出力、JavaScriptレンダリング、プロキシローテーション、ボット対策を備えたスクレイピングと検索ツールを使えます。

主な機能

  1. 01JavaScriptレンダリング対応のスクレイピング
  2. 02JSON、Markdown、スクリーンショット出力
  3. 03ウェブや各種サービスの検索
  4. 04選択可能なツールセット
  5. 05プロキシローテーションとボット対策

活用シーン

  1. 01RAG用の最新ウェブデータ取得
  2. 02商品や出品者情報の収集
  3. 03TikTokやYouTubeのデータ収集

MCP 対応

Decodo Web Scraping APIの機能を、スクレイピング、検索、対象別ツールセットなどのツールとしてMCPクライアントに公開します。

設定

ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。

mcp.json · 共通設定
{
"mcpServers": {
"decodo": {
"command": "npx",
"args": [
"-y",
"@decodo/mcp-server"
]
}
}
}
起動コマンドnpx -y @decodo/mcp-server

ローカルサーバーにはマシン上の実行環境(Node.js 18 以上など)が必要です。設定ファイルの場所はクライアントごとに異なります。

パッケージ
npm@decodo/mcp-server1.6.0

ツール

ツール一覧はまだ取得されていません

ローカルサーバーのツールはマシン上で起動して初めて取得できます。メンテナーはまだツール一覧を提供していません。

詳細

Decodo MCP Server

README の画像 MCP Server をインストール

Decodo:AI エージェントがワンクリックでウェブにアクセス

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から投稿、チャンネル、エンゲージメントデータを収集します。
  • 旅行・価格集約 – ウェブサイトを横断して、最新の料金や空き状況を収集するツールを構築します。

クイックスタート

  1. dashboard.decodo.com で無料アカウントを作成します。クレジットカードは不要で、最大 10K 件の無料リクエストを利用できます。
  2. API キーを取得します。ダッシュボードの Web Data API サブスクリプションから Web Data API キーをコピーします。以前のプランでは基本認証トークンが使用されます。こちらも利用できます(認証を参照)。
  3. https://nodejs.org からNode.js 18 以降をダウンロードします。
  4. Claude Desktop、Cursor、Windsurf などの MCP 対応ツールといったMCP クライアントを用意します。
  5. 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
  1. Claude Desktop → Settings → Developer → Edit Config を開きます。
  2. claude_desktop_config.json に追加します。
{
  "mcpServers": {
    "Decodo": {
      "command": "npx",
      "args": ["-y", "@decodo/mcp-server"],
      "env": {
        "SCRAPER_API_TOKEN": "<api_key>",
        "TOOLSETS": "web,ai"
      }
    }
  }
}
  1. 保存して Claude Desktop を再起動します。
Cursor
  1. Settings → MCP を開きます。
  2. Add a new global MCP server をクリックします(mcp.json が開きます)。
  3. 上記と同じ設定を追加します。
  4. 保存し、Decodo の横に緑色のステータスインジケーターが表示されていることを確認します。
Windsurf
  1. Settings → Windsurf Settings を開きます。
  2. Cascade までスクロールし、Add custom server + をクリックします(mcp_config.json が開きます)。
  3. 上記と同じ設定を追加します。
  4. 保存して Windsurf を再起動します。

セットアップをテストする

接続したら、クライアントで次のプロンプトを試してください。

▎ 「Hacker News の上位 5 件の記事のタイトルをスクレイピングしてください」

数秒以内に構造化されたリストが返されます。認証エラーが表示された場合は、ダッシュボードで API キーを再確認してください。

ローカル開発

サーバーコードを変更する場合にのみ必要です。

このリポジトリからサーバーをビルドして実行する
前提条件
  • Node.js 18.0+
  • MCP クライアント。よく使われるものとして Claude Desktop や Cursor があります。
手順
  1. このリポジトリをクローンします。
git clone https://github.com/Decodo/mcp-server
  1. ターミナルで次のコマンドを実行します。
cd mcp-server
npm install
npm run build
  1. ビルド先の場所を確認します。
cd build/
pwd

このディレクトリの末尾に index.js を追加すると、ビルドファイルの場所は次のようになります。

/Users/your.user/projects/mcp-server/build/index.js
  1. サーバー情報を使って 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 ツールのみが含まれています。

ツールセットツール
webscrape_as_markdown、screenshot、map、crawl_start、crawl_status、crawl_results、crawl_cancel
searchsearch
任意の MCP クライアント

toolsets クエリパラメーターにカンマ区切りのリストを渡すことで、特定のツールセットを選択して有効にできます。

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

ツールセットが指定されていない場合は、すべてのツールが登録されます。

ツールセットツール
webscrape_as_markdown、screenshot、map、crawl_start、crawl_status、crawl_results、crawl_cancel
searchsearch、google_search、google_ads、google_lens、google_travel_hotels、bing_search
ecommerceamazon_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_mediatiktok_post、youtube_metadata、youtube_channel、youtube_subtitles、youtube_search
aichatgpt、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_adsGoogle Ads の検索結果をスクレイピングします。Google Ads で laptop を検索し、上位の広告を表示してください。
google_lensGoogle Lens の画像検索結果をスクレイピングします。この画像を Google Lens で検索してください:https://example.com/image.jpg
google_ai_modeGoogle AI Mode(AI による検索)の結果をスクレイピングします。Google AI Mode に「人気の犬種を上位 3 つ教えてください」と質問してください。
google_travel_hotelsGoogle Travel Hotels の検索結果をスクレイピングします。Google Travel Hotels でパリのホテルを検索してください。
amazon_search指定したクエリで Amazon Search をスクレイピングし、解析済みの結果を返します。Amazon Search でワイヤレスキーボードをスクレイピングしてください。
amazon_productAmazon の商品ページをスクレイピングします。Amazon 商品 B09H74FXNW をスクレイピングして、詳細を表示してください。
amazon_pricingAmazon 商品の価格情報をスクレイピングします。Amazon 商品 B09H74FXNW の価格を取得してください。
amazon_sellersAmazon の販売者情報をスクレイピングします。Amazon の販売者 A1R0Z7FJGTKESH の情報を取得してください。
amazon_bestsellersAmazon のベストセラー一覧をスクレイピングします。Amazon のエレクトロニクスのベストセラーを表示してください。
walmart_search指定したクエリで Walmart Search をスクレイピングし、解析済みの結果を返します。Walmart Search でキャンプ用テントをスクレイピングしてください。
walmart_productWalmart の商品ページをスクレイピングします。Walmart 商品 15296401808 をスクレイピングしてください。
target_search指定したクエリで Target Search をスクレイピングし、解析済みの結果を返します。Target Search でキッチン家電をスクレイピングしてください。
target_productTarget の商品ページをスクレイピングします。Target 商品 92186007 をスクレイピングしてください。
tiktok_postTikTok の投稿 URL をスクレイピングし、エンゲージメント、キャプション、ハッシュタグなどの構造化データを取得します。この TikTok 投稿をスクレイピングしてください:https://www.tiktok.com/@nba/video/7393013274725403950
tiktok_shop_search指定したクエリで TikTok Shop Search をスクレイピングし、解析済みの結果を返します。TikTok Shop Search でスマートフォンケースをスクレイピングしてください。
tiktok_shop_productTikTok Shop の商品ページをスクレイピングします。TikTok Shop 商品 1731541214379741272 をスクレイピングしてください。
tiktok_shop_urlURL を指定して TikTok Shop のページをスクレイピングします。この TikTok Shop URL をスクレイピングしてください:https://www.tiktok.com/shop/s?q=HEADPHONES
youtube_metadataYouTube 動画のメタデータをスクレイピングします。YouTube 動画 dFu9aKJoqGg のメタデータを取得してください。
youtube_channelYouTube チャンネルの動画をスクレイピングします。YouTube チャンネル @decodo_official をスクレイピングしてください。
youtube_subtitlesYouTube 動画の字幕をスクレイピングします。YouTube 動画 L8zSWbQN-v8 の字幕を取得してください。
youtube_searchYouTube 動画を検索します。YouTube で「チンチラの飼い方」を検索してください。
bing_searchBing Search の検索結果をスクレイピングします。Bing でノートパソコンのレビューを検索してください。
chatgptChatGPT に単一のプロンプトを送信し、回答を返します(会話履歴はありません)。ChatGPT に量子コンピューティングを簡単な言葉で説明するよう依頼してください。
perplexityPerplexity に単一のプロンプトを送信し、回答を返します(会話履歴はありません)。Perplexity にウェブ開発の最新トレンドを尋ねてください。

パラメーター

以下のパラメーターは、ユーザーのプロンプトから推測されます。

パラメーター説明
jsRenderヘッドレスブラウザーで対象の URL をレンダリングします。
geoリクエストの送信元となる国を設定します。
localeリクエストのロケールを設定します。
tokenLimit返される文字数の上限(デフォルトは45000)です。コンテキストウィンドウが小さい場合に便利です。
promptAI ツール(chatgpt、perplexity)に送信するプロンプトです。
searchChatGPT のウェブ検索機能を有効にします(chatgpt のみ)。
xhrtrue の場合、対応しているときはスクレイピング結果に 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)です。
countryTikTok 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 エージェントにあらゆるウェブサイトのリアルタイムデータを提供できます。

無料で始める | ドキュメント | Discord

ライセンス

すべてのコードは MIT License のもとで公開されています。

コメント

MCP は初めてですか?

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。