Oxylabs MCP Server

📖 Обзор

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

В этой реализации используется протокол контекста модели (MCP) для создания безопасного, стандартизированного способа взаимодействия помощников на основе искусственного интеллекта с веб-контентом.

✨ Основные характеристики

• Извлечение данных из любого URL, включая сложные одностраничные приложения
• Полная визуализация динамических веб-сайтов с использованием поддержки headless-браузера
• Выберите полную визуализацию JavaScript, только HTML или ее отсутствие.
• Эмулируйте мобильные и настольные области просмотра для реалистичного рендеринга
• Автоматически очищайте и конвертируйте HTML в Markdown для улучшения читабельности
• Используйте автоматизированные парсеры для популярных целей, таких как Google, Amazon и т. д.
• Обход сложных систем защиты от ботов с высоким процентом успеха
• Надежный парсинг даже самых сложных веб-сайтов
• Получайте автоматически меняющиеся IP-адреса из пула прокси-адресов, охватывающего более 195 стран
• При необходимости задайте параметры рендеринга и анализа.
• Передавайте данные непосредственно в модели ИИ или аналитические инструменты
• Работает на macOS, Windows и Linux
• Комплексная обработка ошибок и отчетность
• Интеллектуальное ограничение скорости и управление запросами

💡 Примеры запросов

После настройки сервера MCP с помощью Клода вы сможете делать такие запросы:

• Можете ли вы скопировать страницу https://www.google.com/search?q=ai ?
• Соскребите https://www.amazon.de/-/en/Smartphone-Contract-Function-Manufacturer-Exclusive/dp/B0CNKD651V с включенным анализом
• Соскребите https://www.amazon.de/-/en/gp/bestsellers/beauty/ref=zg_bs_nav_beauty_0 с включенным анализом и рендерингом
• Используйте веб-разблокировщик с рендером для скрейпинга https://www.bestbuy.com/site/top-deals/all-electronics-on-sale/pcmcat1674241939957.c

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

Прежде чем начать, убедитесь, что у вас есть:

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

Базовое использование

Через интерфейс командной строки Smithery:

• Node.js (v16+)
• инструмент командной строки npx

Через УФ:

• Менеджер пакетов uv – установите его, используя это руководство

Локальная/разработческая настройка

• Питон 3.12+
• Менеджер пакетов uv – установите его, используя это руководство

🧩 Параметры API

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

⚙️ Основные инструкции по настройке

Установить через Smithery

Автоматическая установка сервера Oxylabs MCP через Smithery :

Список клиентов, поддерживаемых Oxylabs на данный момент:

• Клод
• курсор

Параметры ручной конфигурации MCP

1. Конфигурация с uvx . Установит клиент CLI и сервер Oxylabs MCP, который выполняет вызовы напрямую к API Oxylabs. Рекомендуемый и самый стабильный вариант на данный момент.
   { "mcpServers": { "oxylabs_scraper_uvx": { "command": "uvx", "args": [ "oxylabs-mcp" ], "env": { "OXYLABS_USERNAME": "OXYLABS_USERNAME", "OXYLABS_PASSWORD": "OXYLABS_PASSWORD" } } } }
2. Конфигурация с npx . Установит клиент Smithery CLI, который выполняет вызовы на сервер Oxylabs MCP, размещенный в Smithery.
   { "mcpServers": { "oxylabs-mcp": { "command": "npx", "args": [ "-y", "@smithery/cli@latest", "run", "@oxylabs/oxylabs-mcp", "--config", "\"{\\\"oxylabsUsername\\\":\\\"OXYLABS_USERNAME\\\",\\\"oxylabsPassword\\\":\\\"OXYLABS_PASSWORD\\\"}\"" ] } } }
3. Конфигурация с uv . Установит клиент CLI и сервер Oxylabs MCP, ссылающийся на локальный код. Для локальной разработки.
   { "mcpServers": { "oxylabs_scraper": { "command": "uv", "args": [ "--directory", "/<Absolute-path-to-folder>/oxylabs-mcp", "run", "oxylabs-mcp" ], "env": { "OXYLABS_USERNAME": "OXYLABS_USERNAME", "OXYLABS_PASSWORD": "OXYLABS_PASSWORD" } } } }

[!ПРИМЕЧАНИЕ] Если у вас нет утилиты uvx вам нужно сначала установить ее с помощью brew install uv

[!TIP] Если вы столкнулись с ошибками с uvx , попробуйте использовать полный путь к uvx в поле command . Например, /Users/my-user/.local/bin/uvx . Если вы используете Windows и испытываете проблемы с Cursor, обратитесь к рекомендациям, описанным здесь .

Ручная настройка с помощью Claude Desktop

Перейдите в Claude → Настройки → Разработчик → Изменить конфигурацию и добавьте одну из приведенных выше конфигураций в файл claude_desktop_config.json .

Ручная настройка с помощью курсора AI

Перейдите в Курсор → Настройки → Настройки курсора → MCP . Нажмите Добавить новый глобальный сервер MCP и добавьте одну из конфигураций выше.

💻 Инструкции по локальной/разработочной настройке

Клонировать репозиторий

Установить зависимости

Установите зависимости сервера MCP:

🐞 Отладка

Затем зайдите в MCP Inspector по адресу http://localhost:5173 . Возможно, вам придется добавить свое имя пользователя и пароль в качестве переменных среды в инспекторе под OXYLABS_USERNAME и OXYLABS_PASSWORD .

Лицензия

Данный проект лицензирован в соответствии с лицензией MIT .

О компании Oxylabs

Компания Oxylabs, основанная в 2015 году, является ведущей на рынке платформой для сбора веб-аналитики, которая соответствует самым высоким стандартам ведения бизнеса, этики и соответствия требованиям, позволяя компаниям по всему миру получать ценную информацию на основе данных.