oxylabs-mcp

oxylabs-mcp — официальный MCP-сервер от oxylabs. Загрузка и обработка страниц через Oxylabs Web Scraper API. Подключается как удалённый сервер. Лицензия MIT.

Опубликовано 13.11.2026 · Обновлено 14.11.2026 · Проверено 13.11.2026

Кратко о сервере

Разработчик
oxylabs
Лицензия
MIT
Транспорт
streamable_http
Авторизация
api_key
ОС
Не указана
Языки
python

Уровень риска: medium

Ключи Oxylabs расходуют баланс; запросы идут через прокси-сеть на любые сайты; браузерный агент может заполнять формы.

Настройка клиентов

cursor
{
    "code": "{\n  \"mcpServers\": {\n    \"oxylabs\": {\n      \"url\": \"https://mcp.oxylabs.io/mcp\",\n      \"headers\": {\n        \"Authorization\": \"Bearer YOUR_API_TOKEN\",\n        \"X-Oxylabs-AI-Studio-Api-Key\": \"YOUR_API_KEY\"\n      }\n    }\n  }\n}",
    "lang": "json",
    "notes": "Размещённый сервер с заголовками",
    "verified": "docs"
}

Важно. Репозиторий по-прежнему полностью поддерживается, но тем, кто пользуется Oxylabs Web API, README советует отдельный репозиторий Web API MCP.

Что умеет

Oxylabs MCP Server связывает языковые модели с вебом: скрапинг любых URL, рендеринг страниц с тяжёлым JavaScript, очистка и форматирование контента для ИИ, обход CAPTCHA и доступ к данным с гео-ограничениями из более чем 195 стран. Лицензия MIT.

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

  • universal_scraper — любой URL с рендерингом JavaScript, гео-таргетингом и выводом в Markdown, HTML или списком ссылок;
  • google_search_scraper — результаты Google Search, при желании в структурированном JSON;
  • amazon_search_scraper — страницы поиска Amazon;
  • amazon_product_scraper — данные отдельных товаров Amazon.

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

  • ai_scraper — извлечение данных с помощью ИИ в JSON, CSV, Markdown или TOON;
  • ai_crawler — обход сайта с начального URL по запросу и сбор данных со многих страниц;
  • ai_browser_agent — управление настоящим браузером по запросу: переходы, клики, заполнение форм;
  • ai_search — веб-поиск с Markdown-содержимым результатов;
  • ai_map — карта URL сайта с фильтром по ключевым словам или запросу;
  • generate_schema — JSON-схема в формате OpenAPI для структурированного извлечения.

Наборы работают вместе или по отдельности. Все инструменты видны всегда; если для вызова не хватает учётных данных, сервер возвращает сообщение о том, что настроить. Подробности вызовов приходят в событиях notifications/message. Среди возможностей — эмуляция мобильных и настольных экранов, автоматическая очистка HTML в Markdown, парсеры для Google и Amazon, ротация IP из пула прокси.

Кому подойдёт

  • Аналитикам и исследователям, собирающим данные с сайтов и из поисковой выдачи.
  • Командам электронной коммерции — мониторинг товаров Amazon.
  • Разработчикам RAG-систем — Markdown можно сразу отправлять в векторную базу.

Похожие серверы — в категории браузер и парсинг.

Установка

Нужен хотя бы один из доступов: токен Web Scraper API (или логин и пароль) из панели Oxylabs — есть пробная неделя, или ключ Oxylabs AI Studio — 1000 бесплатных кредитов. Есть два пути: размещённый сервер https://mcp.oxylabs.io/mcp без установки (учётные данные передаются в заголовках) или локальный запуск через uvx oxylabs-mcp с переменными OXYLABS_API_TOKEN (либо OXYLABS_USERNAME и OXYLABS_PASSWORD) и OXYLABS_AI_STUDIO_API_KEY. Задавайте только те переменные, для которых есть настоящие данные: значения-заглушки ломают вызовы. Для локального запуска нужен менеджер пакетов uv. Сервер можно поднять и как собственный HTTP-сервер (MCP_TRANSPORT=streamable-http).

Подключение к клиентам

Конфиги приведены дословно из README. Подробнее — в инструкции как подключить MCP.

claude mcp add --transport http oxylabs https://mcp.oxylabs.io/mcp \
  --header "Authorization: Bearer YOUR_API_TOKEN" \
  --header "X-Oxylabs-AI-Studio-Api-Key: YOUR_API_KEY"

В Claude Desktop конфиг добавляется в claude_desktop_config.json через Settings → Developer → Edit Config. Клиенты, которые для удалённых серверов поддерживают только OAuth (например, пользовательский коннектор в веб-версии claude.ai), пока не умеют передавать заголовки — для них README советует локальный запуск.

Проверка

Попросите: «Найди в Google три свежие статьи про MCP» — сработает google_search_scraper.

Примеры задач

Собери название, цену и рейтинг этого товара Amazon.
Обойди сайт документации и собери все страницы о ценах в Markdown.

Риски

  • Ключи доступа. Токен Oxylabs и ключ AI Studio расходуют ваш баланс; храните их в переменных окружения.
  • Сеть и прокси. Запросы уходят на серверы Oxylabs и через их прокси-сеть на любые сайты.
  • Браузерный агент может кликать и заполнять формы на сайтах — проверяйте запросы к нему.

Частые вопросы

Нужно ли что-то устанавливать?

Нет, если подключаться к размещённому серверу; для локального запуска нужен uv.

Что если передать и токен, и логин с паролем?

Используется токен.

Есть ли бесплатный доступ?

Пробная неделя Web Scraper API и 1000 кредитов AI Studio.

Основы протокола — на странице что такое MCP-сервер.

Похожие MCP-серверы

browser-use

Браузерные агенты и облачные браузеры для ИИ: выполнение задач на сайтах, заполнение форм и извлечение данных.

Риск: medium Лицензия: MIT ★ 121 451

Fetch

Эталонный сервер для загрузки веб-страниц и их преобразования в удобный для модели текст.

Риск: medium Лицензия: NOASSERTION ★ 92 089

Chrome DevTools MCP

Chrome DevTools для агентов: управление Chrome, отладка, сеть, консоль и замеры производительности.

Риск: medium Лицензия: Apache-2.0 ★ 55 015

browser

Безголовый браузер для ИИ и веб-автоматизации со встроенным MCP-сервером.

Риск: medium Лицензия: AGPL-3.0 ★ 41 461

Источники