Oxylabs Mcpサーバー

Oxylabs MCPとは？

Oxylabs MCP（Managed Cloud Proxy）は、住宅用およびデータセンターのプロキシネットワークを通じて、ユーザーにシームレスなウェブデータアクセスを提供するために設計された強力なソリューションです。このサービスは、信頼性が高く効率的なウェブスクレイピング機能を必要とする企業や開発者向けにカスタマイズされており、さまざまなオンラインソースからデータを収集する際にブロックや制限を受けることなく行えるようにします。

Oxylabs MCPの特徴

• 幅広いプロキシネットワーク：Oxylabs MCPは、1億以上の住宅用IPとデータセンタープロキシの広範なネットワークを誇り、ユーザーは地理的にターゲットを絞ったコンテンツにアクセスし、制限を回避できます。
• 高い匿名性：このサービスはユーザーの匿名性を確保し、ウェブサイトがスクレイピング活動を検出するのを困難にし、IPバンのリスクを低減します。
• ユーザーフレンドリーなダッシュボード：直感的なダッシュボードは、ユーザーがプロキシ設定、使用統計、請求情報を簡単に管理できるようにします。
• 柔軟な料金プラン：Oxylabsは、小規模プロジェクトから大規模なデータスクレイピング操作まで、さまざまなニーズに応じた料金プランを提供しています。
• 24時間年中無休のカスタマーサポート：ユーザーは、サービスに関する問題や問い合わせをサポートするための24時間体制のサポートにアクセスできます。

Oxylabs MCPの使い方

1. サインアップ：Oxylabsのウェブサイトでアカウントを作成し、MCPサービスにアクセスします。
2. プランを選択：データスクレイピングのニーズに合った料金プランを選びます。
3. プロキシを設定：ダッシュボードを使用して、必要なプロキシの種類（住宅用またはデータセンター）を選択し、プロキシ設定を構成します。
4. アプリケーションと統合：提供されたAPIまたは統合ツールを利用して、Oxylabs MCPをウェブスクレイピングアプリケーションに接続します。
5. スクレイピングを開始：データ収集プロセスを開始し、ダッシュボードを通じて使用状況とパフォーマンスを監視します。

よくある質問

Q: Oxylabs MCPはどのような種類のプロキシを提供していますか？

A: Oxylabs MCPは、住宅用プロキシとデータセンタープロキシの両方を提供しており、ユーザーは特定のスクレイピング要件に基づいて選択できます。

Q: どれくらいのデータをスクレイピングできますか？

A: 制限は選択した料金プランによって異なります。各プランには独自のデータ許容量があるため、スクレイピングのニーズに合ったものを選ぶことが重要です。

Q: Oxylabs MCPをSEO目的で使用できますか？

A: はい、多くのユーザーがOxylabs MCPを利用して、ランク追跡、競合分析、市場調査などのSEOタスクを行っています。これは、ローカライズされたデータにアクセスできるためです。

Q: IPがブロックされた場合はどうなりますか？

A: Oxylabs MCPは、設定された間隔または各リクエスト後に自動的にIPアドレスを変更するローテイティングプロキシ機能を通じて、IPバンのリスクを最小限に抑えるように設計されています。

Q: カスタマーサポートに連絡するにはどうすればよいですか？

A: Oxylabsのカスタマーサポートには、ウェブサイトの問い合わせフォームまたはダッシュボードにあるライブチャット機能を通じて連絡できます。

<p align="center"> <img src="https://storage.googleapis.com/oxylabs-public-assets/oxylabs_mcp.svg" alt="Oxylabs + MCP"> </p> <h1 align="center" style="border-bottom: none;"> Oxylabs MCP Server </h1> <p align="center"> <em>The missing link between AI models and the real‑world web: one API that delivers clean, structured data from any site.</em> </p> <div align="center">

<br/> <a href="https://glama.ai/mcp/servers/@oxylabs/oxylabs-mcp"> <img width="380" height="200" src="https://glama.ai/mcp/servers/@oxylabs/oxylabs-mcp/badge" alt="Oxylabs Server MCP server" /> </a> </div>

📖 Overview

The Oxylabs MCP server provides a bridge between AI models and the web. It enables them to scrape any URL, render JavaScript-heavy pages, extract and format content for AI use, bypass anti-scraping measures, and access geo-restricted web data from 195+ countries.

This implementation leverages the Model Context Protocol (MCP) to create a secure, standardized way for AI assistants to interact with web content.

Why Oxylabs MCP?  🕸️ ➜ 📦 ➜ 🤖

Imagine telling your LLM "Summarise the latest Hacker News discussion about GPT‑7" – and it simply answers.
MCP (Multi‑Client Proxy) makes that happen by doing the boring parts for you:

| What Oxylabs MCP does | Why it matters to you | |-|| | Bypasses anti‑bot walls with the Oxylabs global proxy network | Keeps you unblocked and anonymous | | Renders JavaScript in headless Chrome | Single‑page apps, sorted | | Cleans HTML → JSON | Drop straight into vector DBs or prompts | | Optional structured parsers (Google, Amazon, etc.) | One‑line access to popular targets |

✨ Key Features

<details> <summary><strong> Scrape content from any site</strong></summary> <br>

• Extract data from any URL, including complex single-page applications
• Fully render dynamic websites using headless browser support
• Choose full JavaScript rendering, HTML-only, or none
• Emulate Mobile and Desktop viewports for realistic rendering

</details> <details> <summary><strong> Automatically get AI-ready data</strong></summary> <br>

• Automatically clean and convert HTML to Markdown for improved readability
• Use automated parsers for popular targets like Google, Amazon, and etc.

</details> <details> <summary><strong> Bypass blocks & geo-restrictions</strong></summary> <br>

• Bypass sophisticated bot protection systems with high success rate
• Reliably scrape even the most complex websites
• Get automatically rotating IPs from a proxy pool covering 195+ countries

</details> <details> <summary><strong> Flexible setup & cross-platform support</strong></summary> <br>

• Set rendering and parsing options if needed
• Feed data directly into AI models or analytics tools
• Works on macOS, Windows, and Linux

</details> <details> <summary><strong> Built-in error handling and request management</strong></summary> <br>

• Comprehensive error handling and reporting
• Smart rate limiting and request management

</details>

🛠️ MCP Tools

Oxylabs MCP provides the following tools:

1. universal_scraper: Uses Oxylabs Web Scraper API for general website scraping.
2. google_search_scraper: Uses Oxylabs Web Scraper API to extract results from Google Search.
3. amazon_search_scraper: Uses Oxylabs Web Scraper API to scrape Amazon search result pages.
4. amazon_product_scraper: Uses Oxylabs Web Scraper API to extract data from individual Amazon product pages.

💡 Example Queries

When you've set up the MCP server with Claude, you can make requests like:

• Could you scrape https://www.google.com/search?q=ai page?
• Scrape https://www.amazon.de/-/en/Smartphone-Contract-Function-Manufacturer-Exclusive/dp/B0CNKD651V with parse enabled
• Scrape https://www.amazon.de/-/en/gp/bestsellers/beauty/ref=zg_bs_nav_beauty_0 with parse and render enabled
• Use web unblocker with render to scrape https://www.bestbuy.com/site/top-deals/all-electronics-on-sale/pcmcat1674241939957.c

✅ Prerequisites

Before you begin, make sure you have:

• Oxylabs Account: Obtain your username and password from Oxylabs (1-week free trial available)

Basic Usage

Via Smithery CLI:

• Node.js (v16+)
• npx command-line tool

Via uv:

• uv package manager – install it using this guide

Local/Dev Setup

• Python 3.12+
• uv package manager – install it using this guide

🧩 API Parameters

The Oxylabs MCP Universal Scraper accepts these parameters:

| Parameter | Description | Values | |-|-|| | url | The URL to scrape | Any valid URL | | render | Use headless browser rendering | html or None | | geo_location | Sets the proxy's geo location to retrieve data. | Brasil, Canada, etc. | | user_agent_type | Device type and browser | desktop, tablet, etc. | | output_format | The format of the output | links, md, html |

🔧 Configuration

<details> <summary><strong><code>smithery</code></strong></summary>

1. Go to https://smithery.ai/server/@oxylabs/oxylabs-mcp
2. Login with GitHub
3. Find the Install section
4. Follow the instructions to generate the config

Auto install with Smithery CLI

### example for Claude Desktop
npx -y @smithery/cli@latest install @upstash/context7-mcp --client claude --key <smithery_key>

</details> <details> <summary><strong><code>uvx</code></strong></summary>

1. Install the 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. Use the following config

{
  "mcpServers": {
    "oxylabs": {
      "command": "uvx",
      "args": ["oxylabs-mcp"],
      "env": {
        "OXYLABS_USERNAME": "OXYLABS_USERNAME",
        "OXYLABS_PASSWORD": "OXYLABS_PASSWORD"
      }
    }
  }
}

</details> <details> <summary><strong><code>uv</code></strong></summary>

1. Install the uvx

### 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. Use the following config

{
  "mcpServers": {
    "oxylabs": {
      "command": "uv",
      "args": [
        "--directory",
        "/<Absolute-path-to-folder>/oxylabs-mcp",
        "run",
        "oxylabs-mcp"
      ],
      "env": {
        "OXYLABS_USERNAME": "OXYLABS_USERNAME",
        "OXYLABS_PASSWORD": "OXYLABS_PASSWORD"
      }
    }
  }
}

</details>

Manual Setup with Claude Desktop

Navigate to Claude → Settings → Developer → Edit Config and add one of the configurations above to the claude_desktop_config.json file.

Manual Setup with Cursor AI

Navigate to Cursor → Settings → Cursor Settings → MCP. Click Add new global MCP server and add one of the configurations above.

⚙️ Environment variables

Oxylabs MCP server supports the following environment variables

| Name | Description | Mandatory | Default | |--|--||| | OXYLABS_USERNAME | Your Oxylabs username | true | | | OXYLABS_PASSWORD | Your Oxylabs password | true | | | LOG_LEVEL | Log level for the logs returned to the client | false | INFO |

📝 Logging

Server provides additional information about the tool calls in notification/message events

{
  "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"
  }
}

🛡️ License

Distributed under the MIT License – see LICENSE for details.

About Oxylabs

Established in 2015, Oxylabs is a market-leading web intelligence collection platform, driven by the highest business, ethics, and compliance standards, enabling companies worldwide to unlock data-driven insights.

<div align="center"> _{Made with ☕ by <a href="https://oxylabs.io">Oxylabs</a>. Feel free to give us a ⭐ if MCP saved you a weekend.} </div>