scrapeunblocker-mcp-remote

ScrapeUnblocker リモート MCP サーバー

Vercel のサーバーレス関数としてデプロイされた、ScrapeUnblocker 用のホスト型（HTTP）Model Context Protocol サーバーです。claude.ai（ウェブ版とモバイル版）、Claude Desktop、Claude Code、その他あらゆる MCP クライアントから、ScrapeUnblocker のボット対策 API を介してウェブページの HTML、AI が解析した JSON、または Google の検索結果を取得できます。料金はお客様のアカウントに請求されます。

ホスティングなしのローカルインストールをご希望ですか？代わりに stdio パッケージをご利用ください： scrapeunblocker-mcp。

Smithery にも掲載されています。

エンドポイント

https://mcp.scrapeunblocker.com/mcp

ScrapeUnblocker アカウントが必要です。無料アカウントを作成してください。認証方法は 2 つあり、どちらか 1 つだけで十分です。

A. OAuth でサインインする（推奨） - コピーや貼り付けは不要です。このサーバーは Auth0 を基盤とする OAuth 2.1 リソースサーバーです。クライアントは標準の PKCE フローを実行し、サーバーはサインインしたアカウントから ScrapeUnblocker キーをサーバー側で解決します（RFC 8707 に従い、トークンがバックエンドに渡されることはありません）。

クライアント ID を求められた場合は、公開されているクライアント ID を使用してください。これは PKCE クライアントであるため、シークレットを含まず、安全に共有できます：

5BM5Wk2dE4ABkDITmuKfemPLnn3QQ8jd

クライアントシークレットの欄は空欄のままにしてください。

B. 独自の API キーを使用する - スクリプトや OAuth フローのないクライアントに便利です。次の 3 つの方法のいずれかでキーを指定してください：

1. URL の ?key=YOUR_KEY（または ?token=YOUR_KEY）。
2. Authorization: Bearer YOUR_KEY ヘッダー（JWT ではない値）。
3. x-scrapeunblocker-key: YOUR_KEY ヘッダー。

クライアントで設定できる場合は、常にヘッダー（または OAuth）を優先してください。?key= 形式は、URL しか受け付けないクライアント（ChatGPT、一部のコネクター UI）向けです。URL 内のキーがクライアントのログや履歴に残る可能性があるため、その URL はキーそのものと同様に扱い、漏えいした場合はダッシュボードでキーをローテーションしてください。

ツールの一覧表示（initialize、tools/list）には認証情報が不要です。そのため、MCP ディレクトリやインスペクターはサーバーの情報を取得できます。ただし、ツールを実際に実行するには認証が必要です。

OAuth 設定（メンテナー向け）

環境変数	用途
AUTH0_ISSUER	Auth0 発行者 URL（例：https://TENANT.auth0.com/、末尾のスラッシュを含む）。MCP_AUDIENCE と併せて OAuth を有効にします。
MCP_AUDIENCE	正規 MCP URI = Auth0 API Identifier、https://mcp.scrapeunblocker.com/mcp。トークンの aud はこれと一致する必要があります。
MCP_EMAIL_CLAIM	ユーザーのメールアドレスを含む任意の名前空間付きクレーム（Auth0 Post-Login Action で設定）。例：https://scrapeunblocker.com/email。標準の email クレームにフォールバックします。
MCP_RESOURCE_METADATA_URL	WWW-Authenticate で通知される RFC 9728 メタデータ URL の任意の上書き値。
UTILS_API_BASE_URL	email_to_key ルックアップに使用する utils-api のベース URL。例：https://utils-api.scrapeunblocker.com。
AWS_ACCESS_KEY_ID / AWS_SECRET_ACCESS_KEY / AWS_REGION	utils-api の呼び出しに使用する IAM 認証情報（SigV4、execute-api）。

提供されるディスカバリーエンドポイント（vercel.json のリライト経由）： /.well-known/oauth-protected-resource および /.well-known/oauth-protected-resource/mcp。

claude.ai に追加する

1. Customize → Connectors → + → Add custom connector。
2. URL: https://mcp.scrapeunblocker.com/mcp
3. Advanced settings で OAuth Client ID に 5BM5Wk2dE4ABkDITmuKfemPLnn3QQ8jd を設定し、OAuth Client Secret は空欄のままにします。
4. Add をクリックし、サインインして Authorize を選択します。ツールは claude.ai のウェブ版、モバイル版、Claude Desktop で使用できるようになります。

または、OAuth を使わずに、個人用 URL を貼り付けてください： https://mcp.scrapeunblocker.com/mcp?key=YOUR_API_KEY

Claude Code に追加する

claude mcp add --transport http scrapeunblocker "https://mcp.scrapeunblocker.com/mcp?key=YOUR_API_KEY"

ChatGPT に追加する

有料プラン（Plus／Pro／Business／Enterprise）で開発者モードを有効にしたうえで、デスクトップアプリではなくウェブ版の ChatGPT（chatgpt.com）を使用します。すべてのツールは読み取り専用なので、Plus で十分です。

1. 設定 → プラグインを開き、開発者モードをオンにします。
2. プラグインで + をクリックし、新しいプラグインを開きます。
3. 接続はサーバー URLのままにし、認証を認証なしに設定します。リスクの確認欄にチェックを入れ、キーを含む URL を貼り付けます。 https://mcp.scrapeunblocker.com/mcp?key=YOUR_API_KEY
4. 作成をクリックします。これで、どのチャットでもツールを利用できます。

スクリーンショット付きの詳しい手順： docs.scrapeunblocker.com/sdks/chatgpt。

ツール

ツール	機能
fetch_html	URL のレンダリング済み HTML を取得します。
browse_page	実際のブラウザーでページに対して steps を実行し（検索、クリック、入力、ページ送り）、処理後の HTML を返します。読み取り専用ではなく、ウェブサイト上で操作を行います。
fetch_parsed	ページを取得し、AI が解析した構造化 JSON を返します。
google_search	Google 検索を実行し、オーガニック検索結果を JSON で返します。
fetch_markdown	ページを取得し、クリーンな Markdown として返します。絶対リンクを含む主要コンテンツのみで、スクリプト、スタイル、ナビゲーション、フッターは含みません。通常、HTML の 2～25％のサイズなので、モデルがページを読み取るための低コストな方法です。
search_and_read	1 回の呼び出しで Google 検索を実行し、上位の結果を読み取ります。Google の AI による概要（表示される場合）、最初の 1～5 件の検索結果ページの Markdown、およびその他の結果のタイトル、URL、スニペットを返します。検索 1 回分と、読み取ったページごとに 1 回分のリクエスト料金がかかります。
list_elements	ページ上のインタラクティブ要素（ボタン、入力欄、選択欄、リンク、フォーム）を、steps の作成に使えるセレクターとともに JSON で返します。
list_plugins	すぐに使えるサイトプラグイン（100 以上：Amazon、Walmart、Zillow、Booking.com、Indeed、Google Trends、YouTube、App Store など）とそのパラメーターを一覧表示します。無料です。何も呼び出しません。
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 を返します。

ページの操作（steps）

browse_page は steps 配列を受け取ります。これは、ページの読み込み後、HTML の取得前に実際のブラウザーで実行される一連の操作です。サポートされる操作：wait_for、wait_for_text、wait、click、type（人間のようなキー入力）、select、press_key、scroll。一般的な流れは、list_elements を呼び出してセレクターを確認し、続いて steps を指定して browse_page を呼び出し、ページを操作する方法です。操作がウェブサイト上で実行されるため、読み取り専用としてマークされていない唯一のツールです。

steps は冪等ではありません。リクエストは一度だけ実行され、再試行されません。ステップが失敗した場合（セレクターが不正、要素が表示されないなど）、ツールは問題のステップ（step_index、action、reason、selector）を示す HTTP 422 の結果と、失敗時点のページ HTML を返すため、ステップを修正できます。

デプロイ（メンテナー向け）

これは標準的な Vercel プロジェクトで、ビルド手順はありません。関数は api/mcp.ts にあります。プッシュ前に、npm run typecheck と npm test（API のローカル代替環境に対するツールのテスト）で確認します。

vercel            # preview
vercel --prod     # production

次に、mcp.scrapeunblocker.com ドメインを Vercel プロジェクトに向けます。スクレイピングの呼び出しには時間がかかる場合があり、1 分以上かかるプラグインもあるため、vercel.json では関数の maxDuration を 300s に設定しています。

ライセンス

MIT