Skip to main content
Glama
Oxylabs MCP Server

Oxylabs MCP Server

Official

pypi package Licence Coverage badge


📖 Обзор

Сервер Oxylabs MCP обеспечивает мост между ИИ-моделями и вебом. Он позволяет им извлекать данные с любого URL, рендерить страницы с большим количеством JavaScript, извлекать и форматировать контент для использования ИИ, управлять CAPTCHA и получать доступ к гео-ограниченным веб-данным из 195+ стран.

Он построен на Model Context Protocol (MCP) — открытом стандарте для подключения ИИ-ассистентов к внешним инструментам и данным.

Related MCP server: Decodo MCP Server

🛠️ Инструменты MCP

Oxylabs MCP предоставляет два набора инструментов, которые можно использовать вместе или независимо:

Инструменты Oxylabs Web Scraper API

  1. universal_scraper: извлекает данные с любого URL, с опциональным рендерингом JavaScript, геотаргетингом и выводом в Markdown/HTML/ссылках;

  2. google_search_scraper: извлекает результаты из Google Search, с опциональным парсингом в структурированный JSON;

  3. amazon_search_scraper: извлекает данные со страниц результатов поиска Amazon, с опциональным парсингом в структурированный JSON;

  4. amazon_product_scraper: извлекает данные с отдельных страниц товаров Amazon.

Инструменты Oxylabs AI Studio

  1. ai_scraper: извлекает контент с любого URL с помощью ИИ, в форматах JSON, CSV, Markdown или TOON;

  2. ai_crawler: обходит веб-сайт, начиная с заданного URL, на основе промпта и собирает данные с нескольких страниц;

  3. ai_browser_agent: управляет реальным браузером на основе промпта — переходит по ссылкам, кликает, заполняет формы — и возвращает результат;

  4. ai_search: выполняет поиск в интернете и опционально возвращает Markdown-содержимое каждого результата;

  5. ai_map: составляет карту URL-адресов веб-сайта, фильтруя по ключевым словам или промпту;

  6. generate_schema: генерирует JSON-схему в формате OpenAPI для структурированного извлечения данных с помощью указанных выше ИИ-инструментов.

✅ Предварительные требования

Перед началом убедитесь, что у вас есть хотя бы одно из следующего:

  • Учётная запись Oxylabs Web Scraper API: получите имя пользователя и пароль на Oxylabs (доступна бесплатная пробная версия на 1 неделю);

  • Ключ API Oxylabs AI Studio: получите ключ API в Oxylabs AI Studio (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"

📦 Конфигурация

Есть два способа использования сервера: подключиться к размещённому экземпляру (без установки) или запустить его локально с учётными данными в переменных окружения.

Вариант 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), пока не могут передавать заголовки — вход через OAuth в наших планах. Используйте локальную настройку ниже с такими клиентами.

Вариант 2: Локальный запуск

Переменные окружения

Сервер Oxylabs MCP поддерживает следующие переменные окружения:

Имя

Описание

По умолчанию

OXYLABS_USERNAME

Ваше имя пользователя Oxylabs Web Scraper API

OXYLABS_PASSWORD

Ваш пароль Oxylabs Web Scraper API

OXYLABS_AI_STUDIO_API_KEY

Ваш ключ API Oxylabs AI Studio

LOG_LEVEL

Уровень логирования для логов, возвращаемых клиенту

INFO

В зависимости от предоставленных учётных данных сервер автоматически открывает соответствующие инструменты:

  • Если указаны только OXYLABS_USERNAME и OXYLABS_PASSWORD, сервер открывает инструменты Web Scraper API;

  • Если указан только OXYLABS_AI_STUDIO_API_KEY, сервер открывает инструменты AI Studio;

  • Если указаны все три, сервер открывает все инструменты.

❗ Важно: устанавливайте только те переменные окружения, для которых у вас есть реальные учётные данные. Оставление значений-заглушек приведёт к тому, что открытые инструменты не будут работать.

Настройка с помощью 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-сервера (самостоятельное размещение)

Сервер также поддерживает потоковый HTTP-транспорт MCP. Запустите его с помощью:

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 и другие

  • Обходите сложные системы автоматического управления запросами с высоким процентом успеха

  • Надёжно извлекайте данные даже с самых сложных веб-сайтов

  • Получайте автоматически ротируемые IP-адреса из пула прокси, охватывающего 195+ стран

  • Настраивайте параметры рендеринга и парсинга при необходимости

  • Передавайте данные напрямую в ИИ-модели или аналитические инструменты

  • Работает на macOS, Windows и Linux

  • Комплексная обработка ошибок и отчётность

  • Умное ограничение частоты запросов и управление запросами

Почему Oxylabs MCP? 🕸️ ➜ 📦 ➜ 🤖

Представьте, что вы говорите своей LLM «Суммируй последнее обсуждение на Hacker News о GPT‑5» — и она просто отвечает. Сервер Oxylabs MCP делает это возможным, выполняя скучную работу за вас:

Что делает Oxylabs MCP

Почему это важно для вас

Управляет автоматическими запросными стенами с помощью глобальной прокси-сети Oxylabs

Обеспечивает доступ к веб-сайтам и анонимность

Рендерит JavaScript в безголовом Chrome

Одностраничные приложения — решено

Очищает HTML → Markdown

Помещайте прямо в векторные БД или промпты

Опциональные структурированные парсеры (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