Skip to main content
Glama
Oxylabs MCP Server

Oxylabs MCP Server

Official

pypi package Licence Coverage badge


📖 概要

Oxylabs MCPサーバーは、AIモデルとウェブの間のブリッジを提供します。これにより、AIモデルはあらゆるURLのスクレイピング、JavaScriptを多用したページのレンダリング、AI利用のためのコンテンツの抽出と整形、CAPTCHAの管理、そして195以上の国々からの地理的制限のあるウェブデータへのアクセスが可能になります。

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

Related MCP server: Decodo MCP Server

🛠️ MCPツール

Oxylabs MCPは、一緒に使うことも独立して使うこともできる2つのツールセットを提供します:

Oxylabs Web Scraper APIツール

  1. universal_scraper: 任意のURLをスクレイピングします。オプションでJavaScriptレンダリング、ジオターゲティング、Markdown/HTML/リンク出力に対応;

  2. google_search_scraper: Google検索から結果を抽出します。オプションで構造化JSONへのパースに対応;

  3. amazon_search_scraper: Amazonの検索結果ページをスクレイピングします。オプションで構造化JSONへのパースに対応;

  4. amazon_product_scraper: 個々のAmazon商品ページからデータを抽出します。

Oxylabs AI Studioツール

  1. ai_scraper: AIを活用した抽出により、任意のURLからJSON、CSV、Markdown、またはTOON形式でコンテンツをスクレイピングします;

  2. ai_crawler: プロンプトに基づいて開始URLからウェブサイトをクロールし、複数のページにわたってデータを収集します;

  3. ai_browser_agent: プロンプトに基づいて実際のブラウザを操作します — ナビゲート、クリック、フォーム入力 — そして結果を返します;

  4. ai_search: ウェブを検索し、オプションで各結果のMarkdownコンテンツを返します;

  5. ai_map: キーワードまたはプロンプトでフィルタリングして、ウェブサイトのURLをマッピングします;

  6. generate_schema: 上記のAIツールによる構造化抽出のためのOpenAPI形式のJSONスキーマを生成します。

✅ 前提条件

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

  • Oxylabs Web Scraper APIアカウント: Oxylabsからユーザー名とパスワードを取得します(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: Basic <base64(username:password)>

Web Scraper API (代替)

X-Oxylabs-Username と X-Oxylabs-Password

AI Studio

X-Oxylabs-AI-Studio-Api-Key

Claude Codeでの設定:

claude mcp add --transport http oxylabs https://mcp.oxylabs.io/mcp \
  --header "Authorization: Basic $(echo -n 'YOUR_USERNAME:YOUR_PASSWORD' | base64)" \
  --header "X-Oxylabs-AI-Studio-Api-Key: YOUR_API_KEY"

CursorまたはカスタムヘッダーをサポートするリモートMCPサーバー対応クライアントでの設定:

{
  "mcpServers": {
    "oxylabs": {
      "url": "https://mcp.oxylabs.io/mcp",
      "headers": {
        "Authorization": "Basic <base64 of username:password>",
        "X-Oxylabs-AI-Studio-Api-Key": "YOUR_API_KEY"
      }
    }
  }
}

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

注: リモートサーバーでOAuthのみをサポートするクライアント(たとえば、claude.aiウェブUIでカスタムコネクタを追加する場合)は、まだヘッダーを渡すことができません — OAuthサインインはロードマップに含まれています。 それまでの間は、そのようなクライアントでは下記のローカル設定を使用してください。

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

環境変数

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のstreamable-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のみ、またはレンダリングなしを選択可能

  • モバイルおよびデスクトップのビューポートをエミュレートして、現実的なレンダリングを実現

  • HTMLを自動的にクリーンアップしてMarkdownに変換し、可読性を向上

  • Google、Amazonなどの人気ターゲット向けの自動パーサーを使用

  • 高度な自動リクエスト管理システムを高い成功率でナビゲート

  • 最も複雑なウェブサイトでも確実にスクレイピング

  • 195以上の国々をカバーするプロキシプールから自動ローテーションIPを取得

  • 必要に応じてレンダリングおよびパースオプションを設定

  • データをAIモデルや分析ツールに直接フィード

  • macOS、Windows、Linuxで動作

  • 包括的なエラーハンドリングとレポート

  • スマートなレート制限とリクエスト管理

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

LLMに*「GPT‑5に関する最新のHacker Newsの議論を要約して」*と伝えることを想像してみてください – そしてそれが単純に答えてくれるのです。 Oxylabs MCPサーバーは、面倒な部分を代行することでそれを実現します:

Oxylabs MCPが行うこと

あなたにとっての重要性

自動リクエスト対策を管理 — Oxylabsグローバルプロキシネットワークで

ウェブサイトへのアクセスと匿名性を実現

JavaScriptをレンダリング — ヘッドレスChromeで

シングルページアプリもお手のもの

HTMLをクリーンアップしてMarkdownに変換

ベクターDBやプロンプトに直接投入可能

オプションの構造化パーサー (Google、Amazonなど)

人気ターゲットへのワンラインアクセス


🛡️ ライセンス

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


Oxylabsについて

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

image

mcp-name: io.oxylabs/oxylabs-mcp

Available Tools

10 tools
ai_browser_agentC
Read-only
Inspect

Run the browser agent and return the data in the specified format.

This tool is useful if you need navigate around the website and do some actions. It allows navigating to any url, clicking on links, filling forms, scrolling, etc. Finally it returns the data in the specified format. Schema is required only if output_format is json, csv or toon. 'task_prompt' describes what browser agent should achieve

Inputs: url (required), task_prompt (required), schema, geo_location, +1 more. Returns: result

ai_crawlerC
Read-only
Inspect

Tool useful for crawling a website from starting url and returning data in a specified format.

Schema is required only if output_format is json, csv or toon. 'render_javascript' is used to render javascript heavy websites. 'return_sources_limit' is used to limit the number of sources to return, for example if you expect results from single source, you can set it to 1.

Inputs: url (required), user_prompt (required), schema, geo_location, +3 more. Returns: result

ai_mapD
Read-only
Inspect

Tool useful for mapping website's URLs.

Inputs: url (required), limit, user_prompt, geo_location, +5 more. Returns: result

ai_scraperA
Read-only
Inspect

Scrape the contents of the web page and return the data in the specified format.

Schema is required only if output_format is json or csv. 'render_javascript' is used to render javascript heavy websites.

Inputs: url (required), schema, geo_location, output_format, +1 more. Returns: result

amazon_product_scraperA
Read-only
Inspect

Scrape Amazon products.

Supports content parsing, different user agent types, domain, geolocation, locale parameters and different output formats. Supports Amazon specific parameters such as currency and getting more accurate pricing data with auto select variant.

Inputs: query (required), parse, domain, locale, +6 more. Returns: result

amazon_search_scraperB
Read-only
Inspect

Scrape Amazon search results.

Supports content parsing, different user agent types, pagination, domain, geolocation, locale parameters and different output formats. Supports Amazon specific parameters such as category id, merchant id, currency.

Inputs: query (required), pages, parse, domain, +9 more. Returns: result

generate_schemaC
Read-only
Inspect

Generate a json schema in openapi format.

Inputs: app_name (required), user_prompt (required). Returns: result

google_search_scraperA
Read-only
Inspect

Scrape Google Search results.

Supports content parsing, different user agent types, pagination, domain, geolocation, locale parameters and different output formats.

Inputs: query (required), limit, pages, parse, +8 more. Returns: result

universal_scraperB
Read-only
Inspect

Get a content of any webpage.

Supports browser rendering, parsing of certain webpages and different output formats.

Inputs: url (required), render, geo_location, output_format, +1 more. Returns: result

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3/5.0

    Scored across 10 tools

    Disambiguation2/5

    Several tools have heavily overlapping purposes: ai_scraper and universal_scraper both claim to scrape any webpage content, while ai_crawler and ai_browser_agent both navigate websites and extract data. ai_search and google_search_scraper also cover similar territory, making selection ambiguous without very careful reading.

    Naming Consistency3/5

    Names are descriptive and readable, but they follow two different conventions: an ai_ prefix group (ai_crawler, ai_scraper, ai_search, ai_map, ai_browser_agent) and a target_suffix group (google_search_scraper, amazon_search_scraper, amazon_product_scraper, universal_scraper). Only generate_schema stands apart with a clear verb_noun pattern.

    Tool Count5/5

    Ten tools is well-scoped for a web scraping and search server covering generic scraping, search, browser automation, URL mapping, schema generation, and Amazon-specific extraction. Each tool represents a distinct product capability, even if some overlap exists.

    Completeness5/5

    The tool surface covers the core needs of the domain: general search, Google-specific search, generic page scraping, crawling, browser-driven interaction, site mapping, and Amazon search/product scraping. There are no obvious dead ends for common web data acquisition workflows.

    Maintenance

    ActivityNo data
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables web scraping and document processing with JavaScript execution, anti-detection measures, batch processing, and structured data extraction. Supports multiple formats including markdown, HTML, screenshots, and handles PDFs with OCR capabilities.
      44 PyPI
      4
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      Enables web scraping and data extraction from websites with geographic flexibility, privacy features, and anti-detection capabilities. Supports scraping general websites, Google Search, Amazon Search, and Reddit with customizable parameters for rendering, geolocation, and locale.
      33
      859 npm
      41
      ISC
    • A
      license
      A
      quality
      D
      maintenance
      Enables AI agents to scrape any website by providing tools for JavaScript rendering, antibot bypass, and automatic captcha solving. It supports synchronous, asynchronous, and batch scraping operations with built-in proxy rotation.
      5
      35 PyPI
      MIT
    • A
      license
      A
      quality
      A
      maintenance
      Enables web scraping, structured data extraction, and screenshot capture with automatic anti-bot bypass, supporting JavaScript rendering, proxy rotation, and tiered pricing.
      26
      2,618 npm
      2
      MIT