scrapeunblocker-mcp

ScrapeUnblocker MCP サーバー

Model Context Protocol サーバーです。Claude（およびその他の MCP クライアント）が、ScrapeUnblocker スクレイピング API を通じて、あらゆるウェブページの HTML を取得したり、構造化 JSON を返す100種類以上の既製 サイトプラグイン を実行したりできます。ボット対策（Cloudflare、DataDome、PerimeterX、Akamai、Shape）を回避します。

ご自身の API キーをご用意ください。共有したり、当社経由でプロキシしたりすることはありません。

ツール

ツール	機能
fetch_html	URL のレンダリング済み HTML を取得します。
browse_page	ページ上でインタラクティブなブラウザー steps（クリック、入力、選択、スクロール、待機）を実行し、結果の HTML を返します。読み取り専用ではなく、ウェブサイト上で操作を行います。
list_elements	ページの主な要素を、それぞれすぐに使えるセレクターとともに一覧表示します（セレクターの検出）。
fetch_parsed	ページを取得し、AI が解析した構造化 JSON を返します。
google_search	Google 検索を実行し、オーガニック検索結果を JSON で返します。
fetch_markdown	ページを取得し、クリーンな Markdown として返します。スクリプト、スタイル、ナビゲーション、フッターを除いた、絶対リンク付きの主要コンテンツです。通常、HTML の2～25％のサイズになるため、モデルがページを読む際の低コストな方法です。
search_and_read	1回の呼び出しで Google 検索を行い、上位の結果を読み取ります。Google の AI Overview（表示されている場合）、最初の1～5件の検索結果ページの Markdown、およびその他の結果のタイトル、URL、スニペットを返します。検索1回と、読み取った各ページにつきリクエスト1回分として課金されます。
list_plugins	既製のサイトプラグイン（Amazon、Walmart、Zillow、Booking.com、Indeed、Google Trends、YouTube、App Store、Ahrefs など100種類以上）とそのパラメーターを一覧表示します。無料で、呼び出しは発生しません。
run_plugin	サイトプラグインを1つ実行し、構造化 JSON を返します。
amazon_search、amazon_product、amazon_reviews、walmart_search、ebay_search、google_shopping、google_local、maps_place_details、google_images、youtube_search、youtube_transcript、zillow_search、indeed_jobs、trustpilot_reviews、booking_hotels	よく使われるサイトプラグインを、それぞれ独立したツールとして利用できます。各ツールのスキーマにパラメーターが含まれているため、list_plugins で調べずに1回の呼び出しで実行できます。run_plugin と同じ JSON を返します。

サイトプラグイン（対応サイトの構造化 JSON）

人気の高い多くのサイトには、解析済みのデータを返すプラグインがあります。たとえば、Target の検索結果、Zillow の物件検索結果、アプリの App Store レビュー、いくつかのキーワードに関する Google Trends などです。モデルは list_plugins（必要に応じて search: "zillow" または category を指定）を呼び出して、プラグインとそのパラメーターを確認し、続いて name と params を指定して run_plugin を実行します（上の表に記載された、よく使われるプラグインは、それぞれ独立したツールとして直接呼び出すこともできます）。

{ "name": "target_search", "params": { "query": "coffee maker", "max_results": 20 } }

すべてのプラグインとパラメーターは、プラグインのページに記載されています。実行ごとに API リクエストと同様に課金されます。

ブラウザーの手順（操作してから取得）

必要な情報が、操作後に初めて表示されるページもあります。たとえば、Cookie バナーを承諾する、タブをクリックする、検索ボックスに入力して送信する、遅延読み込みを開始させるためにスクロールする、といった操作です。browse_page に steps 配列を渡すと、ページの読み込み後に、実際のブラウザーでアクションが順番に実行されます。その後、結果の HTML が返されます。

使用できるアクション：

アクション	フィールド
wait_for	selector、selector_type?（css／xPath／className／tagName）、timeout_ms?
wait_for_text	value、timeout_ms?
wait	value（ms）
click	selector、selector_type?、timeout_ms?
type	selector、selector_type?、value、clear?、timeout_ms?（人間らしい入力）
select	selector、selector_type?、value、timeout_ms?
press_key	value（Enter、Tab、Escape、Backspace、Delete、Space、Arrow*、Home、End、PageUp、PageDown）
scroll	value（"bottom" またはピクセル単位のオフセット）

手順は冪等ではありません。呼び出しごとに一度実行され、ウェブサイトを操作するため、browse_page は読み取り専用としてマークされていない唯一のツールです。手順が失敗すると、browse_page は失敗した手順、理由、そしてその時点のページ HTML を返すので、セレクターを修正して再試行できます。

要素の一覧表示（まずセレクターを見つける）

list_elements はページを読み込み、注目すべき要素（リンク、入力欄、ボタン、選択欄など）を JSON リストで返します。各要素には、そのまま使える selector と、tag、text、有用な属性（name、id、type、placeholder、aria_label、href など）が含まれます。

{ "url": "https://example.com", "count": 42, "elements": [ { "tag": "input", "selector": "#search", "type": "text", "placeholder": "Search", "aria_label": "Search" } ] }

一般的なワークフローは見つけてから操作することです。list_elements を呼び出して必要なセレクターを見つけ、その後、対応する steps を browse_page に渡して、クリック、入力、選択を行い、結果の HTML を取得します。

API キーを取得する

app.scrapeunblocker.com で登録してキーを取得してください。サーバーは SCRAPEUNBLOCKER_KEY 環境変数からキーを読み込みます。

インストール

Claude Code

最も簡単な方法は公式のプラグインを使うことです。このサーバーがインストールされ、API キーの入力が求められます（環境変数ではなく OS のキーチェーンに保存されます）。さらに、/scrape-url コマンドとリファレンススキルが追加されます。

/plugin marketplace add ScrapeUnblocker/claude-code-plugin
/plugin install scrapeunblocker@scrapeunblocker

ScrapeUnblocker/claude-code-plugin をご覧ください。

サーバー本体のみを追加するには、次のようにします。

claude mcp add scrapeunblocker \
  --env SCRAPEUNBLOCKER_KEY=your_api_key_here \
  -- npx -y scrapeunblocker-mcp

Claude Desktop

次の内容を claude_desktop_config.json に追加してください （Settings → Developer → Edit Config）：

{
  "mcpServers": {
    "scrapeunblocker": {
      "command": "npx",
      "args": ["-y", "scrapeunblocker-mcp"],
      "env": {
        "SCRAPEUNBLOCKER_KEY": "your_api_key_here"
      }
    }
  }
}

Claude Desktop を再起動すると、ScrapeUnblocker のツールが表示されます。

その他の MCP クライアント

stdio 経由でサーバーを実行します。

SCRAPEUNBLOCKER_KEY=your_api_key_here npx -y scrapeunblocker-mcp

プロンプトの例

• 「https://www.example-shop.com/product/123 の HTML を取得して、価格を一覧表示してください。」
• 「このページは何度アクセスしてもブロックされます：。fetch_html を使って取得してください。」
• 「 の要素を一覧表示してから、browse_page を使い、検索ボックスに「laptop」と入力して Enter キーを押し、結果を待って HTML を返してください。」
• 「Google で「best running shoes 2026」を検索して、上位 5 件のリンクを教えてください。」
• 「https://en.wikipedia.org/wiki/Web_scraping を Markdown として読み込み、5 つの箇条書きで要約してください。」
• 「Vilnius の現在の人口をウェブで検索して、参照したページを引用してください。」
• 「Target で 50 ドル未満のコーヒーメーカーを探し、Walmart の商品と比較してください。」
• 「米国における過去 1 年間の「coffee」と「tea」の Google トレンドを表示してください。」
• 「WhatsApp の最新の App Store レビューには何が書かれていますか？」

開発

npm install
npm run build      # bundles to dist/ with tsup
npm run typecheck
npm test           # builds, then runs the tools against a local stand-in API
SCRAPEUNBLOCKER_KEY=... node dist/index.js   # run the server

ライセンス

MIT