Oxylabs MCP Server

Oxylabs MCP Server

AI モデルと現実のウェブをつなぐ、欠けていたリンクです。あらゆるサイトからクリーンで構造化されたデータを提供する、1 つの API。

---

📖 概要

Oxylabs MCP サーバーは、AI モデルとウェブをつなぐブリッジを提供します。あらゆる URL のスクレイピング、JavaScript を多用するページのレンダリング、AI での利用に適したコンテンツの抽出とフォーマット、CAPTCHA への対応、195 か国以上のジオ制限されたウェブデータへのアクセスが可能になります。

これは、AI アシスタントを外部のツールやデータに接続するためのオープンスタンダードであるModel Context Protocol（MCP）を基盤としています。

mcp-name: io.oxylabs/oxylabs-mcp

🛠️ MCP ツール

Oxylabs MCP は、組み合わせて、または個別に使用できる 2 種類のツールを提供します。

Oxylabs Web Scraper API ツール

1. universal_scraper：あらゆる URL をスクレイピングします。JavaScript のレンダリング、ジオターゲティング、Markdown／HTML／リンク形式での出力をオプションで利用できます。
2. google_search_scraper：Google Search の検索結果を抽出します。構造化 JSON への解析をオプションで利用できます。
3. amazon_search_scraper：Amazon の検索結果ページをスクレイピングします。構造化 JSON への解析をオプションで利用できます。
4. amazon_product_scraper：個々の Amazon 商品ページからデータを抽出します。

Oxylabs AI Studio ツール

5. ai_scraper：AI による抽出を使ってあらゆる URL のコンテンツをスクレイピングし、JSON、CSV、Markdown、TOON 形式で出力します。
6. ai_crawler：プロンプトに基づき開始 URL からウェブサイトをクロールし、複数のページからデータを収集します。
7. ai_browser_agent：プロンプトに基づいて実際のブラウザーを操作し、ページの移動、クリック、フォーム入力などを行って結果を返します。
8. ai_search：ウェブを検索し、オプションで各検索結果の Markdown コンテンツを返します。
9. ai_map：キーワードまたはプロンプトで絞り込んで、ウェブサイトの URL をマッピングします。
10. generate_schema：上記の AI ツールを使った構造化抽出用に、OpenAPI 形式の JSON スキーマを生成します。

✅ 前提条件

始める前に、次のうち少なくとも 1 つを用意してください。

• Oxylabs Web Scraper API アカウント：Oxylabs ダッシュボードから API トークン（またはユーザー名とパスワード）を取得します（1 週間の無料トライアルを利用できます）。
• Oxylabs AI Studio API キー：Oxylabs AI Studioから API キーを取得します（1000 クレジットを無料で利用できます）。

サーバーをローカルで実行するには（以下のオプション 2）、uv パッケージマネージャーも必要です。

# macOS and Linux
curl -LsSf https://astral.sh/uv/install.sh | sh

# Windows
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

📦 設定

サーバーの利用方法は 2 つあります。ホストされたインスタンスに接続する（インストール不要）か、 環境変数に認証情報を設定してローカルで実行する方法です。

オプション 1：ホステッドサーバー（インストール不要）

Oxylabs は、次のホステッド MCP サーバーを運用しています。

https://mcp.oxylabs.io/mcp

認証情報はリクエストヘッダーで渡します。

認証情報	ヘッダー
Web Scraper API トークン（推奨）	Authorization: Bearer <token>
Web Scraper API トークン（別の方法）	X-Oxylabs-Api-Token
Web Scraper API ユーザー名とパスワード	Authorization: Basic <base64(username:password)>
Web Scraper API ユーザー名とパスワード（別の方法）	X-Oxylabs-Username and X-Oxylabs-Password
AI Studio	X-Oxylabs-AI-Studio-Api-Key

API トークンとユーザー名・パスワードの両方を渡した場合は、トークンが使用されます。

Claude Code でのセットアップ：

claude mcp add --transport http oxylabs https://mcp.oxylabs.io/mcp \
  --header "Authorization: Bearer YOUR_API_TOKEN" \
  --header "X-Oxylabs-AI-Studio-Api-Key: YOUR_API_KEY"

Cursor、またはカスタムヘッダー付きのリモート MCP サーバーに対応するクライアントでのセットアップ：

{
  "mcpServers": {
    "oxylabs": {
      "url": "https://mcp.oxylabs.io/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_TOKEN",
        "X-Oxylabs-AI-Studio-Api-Key": "YOUR_API_KEY"
      }
    }
  }
}

このサーバーは Smithery にも掲載されています。

注記： リモートサーバーへの OAuth のみをサポートするクライアント（たとえば、claude.ai のウェブ UI でカスタムコネクターを追加する場合）は、現時点ではヘッダーを渡せません。OAuth サインインは今後対応する予定です。 それまでは、これらのクライアントで以下のローカルセットアップを使用してください。

オプション 2：ローカルで実行

環境変数

Oxylabs MCP サーバーでは、次の環境変数をサポートしています。

名前	説明	デフォルト
OXYLABS_API_TOKEN	お使いの Oxylabs Web Scraper API トークン
OXYLABS_USERNAME	お使いの Oxylabs Web Scraper API ユーザー名
OXYLABS_PASSWORD	お使いの Oxylabs Web Scraper API パスワード
OXYLABS_AI_STUDIO_API_KEY	お使いの Oxylabs AI Studio API キー
LOG_LEVEL	クライアントに返されるログのログレベル	INFO

Web Scraper API ツールでは、OXYLABS_API_TOKEN、または OXYLABS_USERNAME と OXYLABS_PASSWORD の両方を設定してください。両方を設定した場合は、トークンが使用されます。AI Studio ツールでは、 OXYLABS_AI_STUDIO_API_KEY を設定してください。

すべてのツールは常に一覧に表示されます。必要な認証情報を設定せずにツールを呼び出すと、設定方法を説明するエラーメッセージが返されます。

❗ 重要：実際の認証情報がある環境変数のみを設定してください。 プレースホルダー値ではツールの呼び出しに失敗します。

uvx で設定

PyPI からパッケージをインストールし、自動的に実行します。

{
  "mcpServers": {
    "oxylabs": {
      "command": "uvx",
      "args": ["oxylabs-mcp"],
      "env": {
        "OXYLABS_API_TOKEN": "YOUR_API_TOKEN",
        "OXYLABS_AI_STUDIO_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

ローカルチェックアウトで設定

開発に便利です。このリポジトリのローカルクローンからサーバーを実行します。

{
  "mcpServers": {
    "oxylabs": {
      "command": "uv",
      "args": [
        "--directory",
        "/<absolute-path-to-folder>/oxylabs-mcp",
        "run",
        "oxylabs-mcp"
      ],
      "env": {
        "OXYLABS_API_TOKEN": "YOUR_API_TOKEN",
        "OXYLABS_AI_STUDIO_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

リモートHTTPサーバーとして実行（セルフホスト）

サーバーはMCPのストリーミング可能なHTTPトランスポートにも対応しています。次のコマンドで起動します。

MCP_TRANSPORT=streamable-http MCP_HOST=0.0.0.0 MCP_PORT=8000 uvx oxylabs-mcp

HTTPトランスポートでは、認証情報は環境変数ではなく、リクエストごとに渡します。

認証情報	渡し方
Web Scraper APIトークン（推奨）	Authorization: Bearer <token>
Web Scraper APIトークン（代替）	X-Oxylabs-Api-Token ヘッダー
Web Scraper APIのユーザー名とパスワード	Authorization: Basic <base64(username:password)>（HTTP Basic認証）
Web Scraper APIのユーザー名とパスワード（代替）	X-Oxylabs-Username および X-Oxylabs-Password ヘッダー
AI Studio	X-Oxylabs-AI-Studio-Api-Key ヘッダー

クライアント設定の例：

{
  "mcpServers": {
    "oxylabs": {
      "url": "https://your-host:8000/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_TOKEN",
        "X-Oxylabs-AI-Studio-Api-Key": "YOUR_API_KEY"
      }
    }
  }
}

認証情報の有無にかかわらず、すべてのツールが常に一覧に表示されます。必要な認証情報を設定せずにツールを呼び出すと、設定すべき内容を具体的に説明するエラーメッセージが返されます。

Claude Desktopのセットアップ

Claude → Settings → Developer → Edit Configに移動し、上記の設定のいずれかをclaude_desktop_config.jsonファイルに追加します。

Cursor AIのセットアップ

Cursor → Settings → Cursor Settings → MCPに移動します。Add new global MCP serverをクリックし、上記の設定のいずれかを追加します。

📝 ロギング

サーバーはnotification/messageイベントで、ツール呼び出しに関する追加情報を提供します。

{
  "method": "notifications/message",
  "params": {
    "level": "info",
    "data": "Create job with params: {\"url\": \"https://ip.oxylabs.io\"}"
  }
}

{
  "method": "notifications/message",
  "params": {
    "level": "info",
    "data": "Job info: job_id=7333113830223918081 job_status=done"
  }
}

{
  "method": "notifications/message",
  "params": {
    "level": "error",
    "data": "Error: request to Oxylabs API failed"
  }
}

✨ 主な機能

あらゆるサイトのコンテンツをスクレイピング

• 複雑なシングルページアプリケーションを含む、あらゆるURLからデータを抽出します
• ヘッドレスブラウザーに対応し、動的なウェブサイトを完全にレンダリングします
• JavaScriptを使った完全なレンダリング、HTMLのみのレンダリング、またはレンダリングなしを選択できます
• モバイルおよびデスクトップのビューポートをエミュレートし、実際の環境に近い表示を再現します

AIですぐに使えるデータを自動取得

• HTMLを自動的にクリーンアップしてMarkdownに変換し、読みやすさを向上させます
• GoogleやAmazonなどの一般的な対象に対応する自動パーサーを利用できます

CAPTCHAと地域制限に対応

• 高い成功率で高度な自動リクエスト管理システムに対応します
• 最も複雑なウェブサイトでも安定してスクレイピングできます
• 195か国以上をカバーするプロキシプールから、IPアドレスを自動でローテーションして取得します

柔軟なセットアップとクロスプラットフォーム対応

• 必要に応じてレンダリングと解析のオプションを設定できます
• データをAIモデルや分析ツールに直接渡せます
• macOS、Windows、Linuxで動作します

エラー処理とリクエスト管理を内蔵

• 包括的なエラー処理とレポート機能
• スマートなレート制限とリクエスト管理

## Oxylabs MCP を選ぶ理由  🕸️ ➜ 📦 ➜ 🤖

LLM に 「GPT‑5 に関する最新の Hacker News の議論を要約して」 と伝えるだけで、答えが返ってくるところを想像してみてください。 Oxylabs MCP サーバーは、面倒な作業を代わりに行うことで、それを実現します。

Oxylabs MCP が行うこと	それが役立つ理由
Oxylabs のグローバルプロキシネットワークで自動化されたリクエストブロックに対処します	ウェブサイトへのアクセスと匿名性を実現します
ヘッドレス Chrome でJavaScript をレンダリングします	シングルページアプリにも対応します
HTML を Markdown に変換します	ベクトル DB やプロンプトにすぐ使えます
オプションの構造化パーサー（Google、Amazon など）	人気のターゲットに1行でアクセスできます

---

🛡️ ライセンス

MIT License のもとで配布されています。詳細は LICENSE をご覧ください。

---

Oxylabs について

2015 年に設立された Oxylabs は、最高水準のビジネス、倫理、コンプライアンス基準に基づく、業界をリードするウェブインテリジェンス収集プラットフォームです。 世界中の企業がデータに基づくインサイトを得られるよう支援しています。

この MCP をもとに作られたソリューション：

Michelin Detour