Oxylabs Mcp 服务器

什么是 Oxylabs MCP？

Oxylabs MCP（托管云代理）是一种强大的解决方案，旨在通过住宅和数据中心代理网络为用户提供无缝访问网络数据的能力。该服务专为需要可靠和高效网络爬虫功能的企业和开发人员量身定制，确保他们能够从各种在线来源收集数据，而不会被封锁或限制。

Oxylabs MCP 的特点

• 广泛的代理网络：Oxylabs MCP 拥有超过 1 亿个住宅 IP 和数据中心代理的庞大网络，使用户能够访问地理定位内容并绕过限制。
• 高匿名性：该服务确保用户匿名，使网站难以检测爬虫活动，从而降低 IP 被封的风险。
• 用户友好的仪表板：直观的仪表板使用户能够轻松管理其代理设置、使用统计和账单信息。
• 灵活的定价计划：Oxylabs 提供多种定价计划，以满足不同需求，无论是小型项目还是大规模数据爬取操作。
• 24/7 客户支持：用户可以随时获得支持，以协助解决与服务相关的任何问题或咨询。

如何使用 Oxylabs MCP

1. 注册：在 Oxylabs 网站上创建一个帐户，以获得 MCP 服务的访问权限。
2. 选择计划：选择适合您数据爬取需求的定价计划。
3. 配置您的代理：使用仪表板设置您的代理配置，包括选择所需的代理类型（住宅或数据中心）。
4. 与您的应用程序集成：利用提供的 API 或集成工具将 Oxylabs MCP 连接到您的网络爬虫应用程序。
5. 开始爬取：开始您的数据收集过程，并确保通过仪表板监控使用情况和性能。

常见问题解答

问：Oxylabs MCP 提供哪些类型的代理？

答：Oxylabs MCP 提供住宅和数据中心代理，允许用户根据其特定的爬虫需求进行选择。

问：我可以爬取多少数据？

答：限制取决于您选择的定价计划。每个计划都有自己的数据配额，因此选择一个与您的爬虫需求相符的计划至关重要。

问：我可以将 Oxylabs MCP 用于 SEO 目的吗？

答：是的，许多用户利用 Oxylabs MCP 进行 SEO 任务，例如排名跟踪、竞争对手分析和市场研究，得益于其访问本地化数据的能力。

问：如果我的 IP 被封怎么办？

答：Oxylabs MCP 旨在通过其旋转代理功能最小化 IP 被封的风险，该功能会在设定的时间间隔或每次请求后自动更改您的 IP 地址。

问：我如何联系客户支持？

答：您可以通过他们网站上的联系表单或仪表板中提供的实时聊天功能与 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>