Oxylabs

公式

Oxylabs Web APIを使用してウェブサイトをスクレイピングし、動的レンダリングと解析をサポートして構造化データを抽出します。

GitHub

101

Oxylabs MCPで何ができますか？

OxylabsのスクレイピングおよびAIツールを使用して、構造化されたWebデータのスクレイピング、検索、抽出をAIアシスタントに依頼します。

任意のURLをスクレイピング — universal_scraperを使用して、オプションのJavaScriptレンダリングとジオターゲティングを備えたページを取得し、Markdown、HTML、またはリンクを返します。
Googleの結果を抽出 — google_search_scraperに検索結果を取得させ、構造化されたJSONに解析するよう依頼します。
AIを活用した抽出 — ai_scraperを使用して、任意のURLからJSON、CSV、Markdown、またはTOON形式でコンテンツを抽出します。
Webサイトをクロール — ai_crawlerに、プロンプトに基づいて開始URLからクロールし、複数のページにわたってデータを収集するよう依頼します。
ブラウザを操作 — ai_browser_agentを使用して、プロンプトに基づいて実際のブラウザでナビゲート、クリック、フォームへの入力を行います。

ドキュメント

Oxylabs + MCP

Oxylabs MCP サーバー

AIモデルと実世界のウェブをつなぐ欠けていたピース：あらゆるサイトからクリーンで構造化されたデータを届ける単一のAPI。

📖 概要

Oxylabs MCP サーバーは、AIモデルとウェブの間の橋渡しを提供します。あらゆるURLのスクレイピング、JavaScript主体のページのレンダリング、AI利用向けのコンテンツ抽出・整形、CAPTCHAの管理、195以上の国々からの地理的制限付きウェブデータへのアクセスを可能にします。

これは、AIアシスタントを外部ツールやデータに接続するためのオープン標準である Model Context Protocol (MCP) 上に構築されています。

🛠️ MCP ツール

Oxylabs MCP は、単独でも組み合わせても使用できる2セットのツールを提供します：

Oxylabs Web Scraper API ツール

universal_scraper：任意のURLをスクレイピングします。オプションでJavaScriptレンダリング、ジオターゲティング、Markdown/HTML/リンク出力に対応。
google_search_scraper：Google検索から結果を抽出します。オプションで構造化JSONへのパースに対応。
amazon_search_scraper：Amazonの検索結果ページをスクレイピングします。オプションで構造化JSONへのパースに対応。
amazon_product_scraper：個別のAmazon商品ページからデータを抽出します。

Oxylabs AI Studio ツール

ai_scraper：AI搭載の抽出機能で任意のURLからコンテンツをスクレイピングします。JSON、CSV、Markdown、TOON形式に対応。
ai_crawler：開始URLからプロンプトに基づいてウェブサイトをクロールし、複数ページにわたってデータを収集します。
ai_browser_agent：プロンプトに基づいて実際のブラウザを操作します — ナビゲート、クリック、フォーム入力 — 結果を返します。
ai_search：ウェブを検索し、オプションで各結果のMarkdownコンテンツを返します。
ai_map：キーワードまたはプロンプトでフィルタリングして、ウェブサイトのURLをマッピングします。
generate_schema：上記のAIツールで構造化抽出を行うためのOpenAPI形式のJSONスキーマを生成します。

✅ 前提条件

始める前に、以下の少なくとも1つを用意してください：

Oxylabs Web Scraper API アカウント：Oxylabs からユーザー名とパスワードを取得します（1週間の無料トライアルあり）。
Oxylabs AI Studio API キー：Oxylabs AI Studio からAPIキーを取得します（1000クレジット無料）。

サーバーを実行するには、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"

📦 設定

環境変数

Oxylabs MCP サーバーは以下の環境変数をサポートしています：

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

提供された認証情報に基づいて、サーバーは対応するツールを自動的に公開します：

OXYLABS_USERNAME と OXYLABS_PASSWORD のみが提供された場合、サーバーは Web Scraper API ツールを公開します。
OXYLABS_AI_STUDIO_API_KEY のみが提供された場合、サーバーは AI Studio ツールを公開します。
3つすべてが提供された場合、サーバーはすべてのツールを公開します。

❗ 重要：実際の認証情報がある環境変数のみを設定してください。プレースホルダー値を残すと、動作しないツールが公開されます。

uvx での設定

PyPI のパッケージをインストールして自動的に実行します：

{
  "mcpServers": {
    "oxylabs": {
      "command": "uvx",
      "args": ["oxylabs-mcp"],
      "env": {
        "OXYLABS_USERNAME": "YOUR_USERNAME",
        "OXYLABS_PASSWORD": "YOUR_PASSWORD",
        "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_USERNAME": "YOUR_USERNAME",
        "OXYLABS_PASSWORD": "YOUR_PASSWORD",
        "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: 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": "Basic <base64 of username:password>",
        "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 など）	人気ターゲットへのワンラインアクセス

🛡️ ライセンス

MIT ライセンスの下で配布されています — 詳細は LICENSE を参照してください。

Oxylabs について

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

_{☕ と Oxylabs によって作られました。MCP が週末を救ってくれたなら、ぜひ ⭐ をお願いします。}

mcp-name: io.oxylabs/oxylabs-mcp