Oxylabs Mcp Сервер
Обзор
Что такое Oxylabs MCP?
Oxylabs MCP (Управляемый облачный прокси) — это надежное решение, разработанное для обеспечения пользователей беспрепятственным доступом к веб-данным через сеть жилых и дата-центр прокси. Эта услуга предназначена для бизнеса и разработчиков, которым необходимы надежные и эффективные возможности веб-скрейпинга, что позволяет им собирать данные из различных онлайн-источников без блокировок или ограничений.
Особенности Oxylabs MCP
- Обширная сеть прокси: Oxylabs MCP располагает огромной сетью из более чем 100 миллионов жилых IP-адресов и дата-центр прокси, что позволяет пользователям получать доступ к гео-ориентированному контенту и обходить ограничения.
- Высокая анонимность: Услуга обеспечивает анонимность пользователей, что затрудняет веб-сайтам обнаружение скрейпинг-активностей, тем самым снижая риск блокировки IP.
- Удобная панель управления: Интуитивно понятная панель управления предоставляет пользователям легкое управление настройками прокси, статистикой использования и информацией о выставлении счетов.
- Гибкие тарифные планы: Oxylabs предлагает различные тарифные планы, чтобы удовлетворить разные потребности, будь то для небольших проектов или масштабных операций по сбору данных.
- Круглосуточная поддержка клиентов: Пользователи имеют доступ к круглосуточной поддержке для помощи с любыми проблемами или запросами, касающимися услуги.
Как использовать Oxylabs MCP
- Зарегистрируйтесь: Создайте учетную запись на сайте Oxylabs, чтобы получить доступ к услуге MCP.
- Выберите план: Выберите тарифный план, который соответствует вашим потребностям в сборе данных.
- Настройте свои прокси: Используйте панель управления для настройки конфигураций прокси, включая выбор типа прокси, который вам нужен (жилой или дата-центр).
- Интегрируйте с вашим приложением: Используйте предоставленный API или инструменты интеграции, чтобы подключить Oxylabs MCP к вашему приложению для веб-скрейпинга.
- Начните сбор данных: Начните процесс сбора данных, следя за использованием и производительностью через панель управления.
Часто задаваемые вопросы
В: Какие типы прокси предлагает Oxylabs MCP?
О: Oxylabs MCP предоставляет как жилые, так и дата-центр прокси, позволяя пользователям выбирать в зависимости от их конкретных требований к скрейпингу.
В: Есть ли ограничение на количество данных, которые я могу собрать?
О: Ограничения зависят от выбранного вами тарифного плана. Каждый план имеет свои собственные лимиты на данные, поэтому важно выбрать тот, который соответствует вашим потребностям в скрейпинге.
В: Могу ли я использовать Oxylabs MCP для SEO-целей?
О: Да, многие пользователи используют Oxylabs MCP для SEO-задач, таких как отслеживание позиций, анализ конкурентов и исследование рынка, благодаря его способности получать доступ к локализованным данным.
В: Что произойдет, если мой IP будет заблокирован?
О: Oxylabs MCP разработан для минимизации риска блокировки IP с помощью функции ротации прокси, которая автоматически изменяет ваш IP-адрес через заданные интервалы или после каждого запроса.
В: Как я могу связаться с поддержкой клиентов?
О: Вы можете обратиться в службу поддержки клиентов Oxylabs через контактную форму на их сайте или через функцию живого чата, доступную на панели управления.
Деталь
📖 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
- Automatically clean and convert HTML to Markdown for improved readability
- Use automated parsers for popular targets like Google, Amazon, and etc.
- 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
- Set rendering and parsing options if needed
- Feed data directly into AI models or analytics tools
- Works on macOS, Windows, and Linux
- Comprehensive error handling and reporting
- Smart rate limiting and request management
🛠️ MCP Tools
Oxylabs MCP provides the following tools:
- universal_scraper: Uses Oxylabs Web Scraper API for general website scraping.
- google_search_scraper: Uses Oxylabs Web Scraper API to extract results from Google Search.
- amazon_search_scraper: Uses Oxylabs Web Scraper API to scrape Amazon search result pages.
- 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>- Go to https://smithery.ai/server/@oxylabs/oxylabs-mcp
- Login with GitHub
- Find the Install section
- 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>
- 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"
- 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>
- 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"
- 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"> <sub> Made with ☕ by <a href="https://oxylabs.io">Oxylabs</a>. Feel free to give us a ⭐ if MCP saved you a weekend. </sub> </div>Конфигурация сервера
{
"mcpServers": {
"oxylabs-mcp": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/metorial/mcp-container--oxylabs--oxylabs-mcp--oxylabs-mcp",
"oxylabs-mcp"
],
"env": {
"OXYLABS_USERNAME": "oxylabs-username",
"OXYLABS_PASSWORD": "oxylabs-password"
}
}
}
}