# MCP-сервер для веб-скрапинга с OAuth | QuantumProxies.io

MCP-сервер для веб-скрапинга в Claude, Cursor и любом MCP-клиенте. Вход через OAuth 2.1 без копирования API-ключа и 29 инструментов для парсинга и краулинга.

## MCP-сервер для веб-скрапинга и ИИ-агентов

MCP-сервер QuantumProxies.io даёт Claude, Cursor и любому MCP-клиенту 29 инструментов для скрапинга, поиска, картирования и краулинга живого веба через резидентные прокси. Добавьте https://api.quantumproxies.io/mcp в клиент с поддержкой входа через OAuth, войдите в аккаунт и нажмите «Allow access». Копировать API-ключ не нужно.

- Вход через OAuth 2.1
- Бесплатно, оплачивается только использование API
- 29 инструментов
- Любой MCP-клиент

## Подключение через OAuth в четыре шага

Для MCP-клиентов с поддержкой входа через OAuth: процесс авторизации по спецификации MCP.

1. **Добавьте URL сервера**: Вставьте https://api.quantumproxies.io/mcp в свой клиент, например как пользовательский коннектор в Claude.
2. **Войдите**: Клиент откроет страницу входа QuantumProxies.io. Войдите в аккаунт или создайте бесплатный.
3. **Разрешите доступ**: На экране согласия нужно подтвердить действие. Нажмите «Allow access», и клиент подключён.
4. **Поставьте задачу агенту**: Все 29 инструментов доступны сразу. Использование списывается с баланса аккаунта, как при работе с любым API-ключом.

Каждое подключение получает собственный API-ключ с именем MCP · \<client name> на странице API-ключей в панели управления. Удалите этот ключ, и клиент будет отключён.

## OAuth или API-ключ?

Оба способа ведут к одному эндпоинту и тем же 29 инструментам.

### Вход через OAuth

Для чат-приложений и десктопных клиентов. Ничего не нужно копировать и хранить: клиент держит короткоживущие токены, а каждое подключение отображается как отдельный ключ, который можно удалить.

### API-ключ

Для скриптов, CI и headless-агентов, а также для локального npx-пакета. Передайте ключ qp_live_ в Authorization: Bearer или X-Api-Key на хостинговый эндпоинт либо задайте QUANTUMPROXIES_API_KEY для локального сервера.

## Скиллы для ИИ-агентов

Пять файлов SKILL.md учат Claude Code, Claude.ai, Codex, Cursor, Gemini CLI и любого агента, читающего открытый формат Agent Skills, правильно использовать QuantumProxies.io. Установите их один раз; агент загрузит нужный, когда этого потребует задача.

Установка одной командой: `npx skills add https://quantumproxies.io`. Работает с CLI skills в более чем 70 агентах. Claude Code также загружает папку скилла, скопированную в ~/.claude/skills; Codex, Cursor и Gemini CLI читают ~/.agents/skills.

- [`use-data-api`](https://quantumproxies.io/.well-known/agent-skills/use-data-api/SKILL.md): Вызов REST Data API: аутентификация, конверт ответа, асинхронные задания, справочники
- [`use-mcp-server`](https://quantumproxies.io/.well-known/agent-skills/use-mcp-server/SKILL.md): Подключение любого MCP-клиента: размещённый OAuth-эндпоинт или локальный npm-пакет, пресеты инструментов
- [`scrape-to-markdown`](https://quantumproxies.io/.well-known/agent-skills/scrape-to-markdown/SKILL.md): Из одного URL в чистый Markdown или структурированные поля; batch, map и crawl для многих страниц
- [`generate-proxies`](https://quantumproxies.io/.well-known/agent-skills/generate-proxies/SKILL.md): Строки прокси из ваших планов: геотаргетинг, sticky-сессии, белые списки IP
- [`find-business-leads`](https://quantumproxies.io/.well-known/agent-skills/find-business-leads/SKILL.md): Списки компаний и датасеты: Collectors, AI Places Finder, конструктор датасетов

[Индекс обнаружения (/.well-known/agent-skills/)](https://quantumproxies.io/.well-known/agent-skills/index.json) · [Исходники и плагин для Claude Code на GitHub](https://github.com/quantumproxies/quantumproxies-skills)

Хостинговый эндпоинт следует разделу об авторизации в спецификации MCP: это защищённый ресурс OAuth 2.1, и запрос без учётных данных получает ответ 401, который сообщает клиенту, где пройти вход. Ключи по-прежнему работают на том же URL, поэтому существующие настройки не ломаются.

## URL удалённого MCP-сервера и обнаружение

Хостинговый сервер доступен по адресу https://api.quantumproxies.io/mcp и работает по Streamable HTTP. Он публикует метаданные защищённого ресурса OAuth (RFC 9728) по адресу https://api.quantumproxies.io/.well-known/oauth-protected-resource/mcp, где сервером авторизации указан https://app.quantumproxies.io. Тот, в свою очередь, публикует собственные метаданные (RFC 8414) по пути /.well-known/oauth-authorization-server. Клиент с поддержкой авторизации MCP находит всё это сам, начиная с ответа 401.

## Как защищён вход через OAuth 2.1

PKCE с методом S256 обязателен для каждой авторизации. Клиенты могут зарегистрироваться через Dynamic Client Registration (RFC 7591) или представиться с помощью Client ID Metadata Document. Access-токены действуют один час; refresh-токены действуют 30 дней и обновляются при каждом использовании. Токены привязаны к MCP-эндпоинту через resource indicators (RFC 8707) и никогда не передаются другим сервисам.

## Управление клиентами и их отключение

Каждый клиент, которому вы дали доступ, получает отдельный API-ключ с именем MCP · \<client name> на странице API-ключей в панели управления. Его использование списывается с баланса аккаунта, как у любого другого API-ключа. Удалите ключ, и этот клиент будет отключён, а остальные клиенты и ключи продолжат работать.

## Подключение по API-ключу

API-ключи по-прежнему работают на том же эндпоинте: передайте ключ qp_live_ в Authorization: Bearer или в заголовке X-Api-Key. Локальный пакет, npx -y quantumproxies-mcp, работает через stdio на вашей машине и читает ключ из переменной окружения QUANTUMPROXIES_API_KEY. Используйте ключ везде, где нет браузера для входа: в скриптах, CI и headless-агентах.

## 29 инструментов для вашего агента

Поиск, чтение, краулинг и превращение живого веба в контекст с источниками или в валидированные строки данных. Для долгих задач есть вызовы статуса, поэтому агент может опрашивать прогресс, не скачивая одни и те же данные дважды.

- `scrape`: Один URL в чистый Markdown, HTML или текст через резидентный прокси с TLS-отпечатком реального браузера. Опционально: извлечение в структурированный JSON по CSS-селекторам или с помощью ИИ.
- `search`: Структурированные результаты Google, Bing или DuckDuckGo, включая вертикали конкретной поисковой системы, расширенные блоки и метаданные пагинации.
- `search_and_read`: Ищет в живом вебе, загружает главные источники и возвращает готовый к цитированию контекст в пределах токен-бюджета вашего агента.
- `read_video`: Читает видео с YouTube как единую временную шкалу: метаданные, главы, расшифровку на языке оригинала и небольшие кадры там, где спикер показывает на экран, называет цену или начинает главу.
- `map`: За секунды находит URL сайта по sitemap и ссылкам с главной страницы, чтобы выбрать нужные страницы до скрапинга, без полного краулинга.
- `crawl` + `crawl_status`: Асинхронный краулинг от стартового URL, каждая страница конвертируется в Markdown. Фильтры включения и исключения, контроль глубины, прогресс через crawl_status.
- `batch` + `batch_status`: Асинхронный скрапинг до 1000 URL с общими параметрами и инкрементальным получением результатов по каждому URL.
- `search_bulk` + `search_bulk_status`: Асинхронно собирает несколько страниц выдачи, сохраняя расширенные блоки первой страницы и объединяя дубли органических результатов.
- `unlock`: Web Unlocker как инструмент: повторяет любой HTTP-запрос (метод, заголовки, тело) через резидентный выход, пробует заново со свежим IP и передаёт заблокированный GET настоящему браузеру. Всё ещё заблокированная страница возвращается с пометкой, а не как тихий 200.
- `create_dataset` + `dataset_status`: Превращает запрос на обычном языке в валидированный датасет с инкрементальными строками и подписанными ссылками на выгрузку CSV/JSON.
- `seo_audit`: Сравнивает SEO-представление страницы без JS и после рендеринга: различия в метаданных, canonical, заголовках, контенте и структурированных данных.
- `ai_visibility`: Могут ли ChatGPT, Claude, Perplexity, Google AI Overview и Bing Copilot прочитать и процитировать страницу? Аудит страницы с оценкой по каждому критерию, блокерами и исправлениями, плюс необязательная панель цитирований с опросом движков.
- `generate_parser` + `save_parser_preset` + `list_parser_presets` + `parser_preset_stats` + `heal_parser_preset`: Один раз подбирает CSS-селекторы для шаблона страницы с помощью LLM, а затем использует их для бесплатного детерминированного извлечения. Пять инструментов создают, сохраняют, перечисляют, оценивают и автоматически чинят парсеры, когда сайт меняется.
- `list_collectors` + `run_collector` + `collector_run_status`: list_collectors, run_collector и collector_run_status: смысловые входные данные вроде ключевого слова и локации вместо URL. Amazon, Google Maps, вакансии LinkedIn, магазины приложений и ещё 70 источников, оплата за каждую выданную строку.
- `list_proxies` + `generate_proxies` + `proxy_locations` + `whitelist_ip`: list_proxies, generate_proxies, proxy_locations и whitelist_ip дают агенту готовые прокси-эндпоинты всех типов с геотаргетингом вплоть до города, провайдера или ASN.
- `report`: Отправьте отзыв команде прямо из агента: ошибка, недостающая функция или коллектор, вопрос. Работает без API-ключа.

## Часто задаваемые вопросы

### Что такое MCP-сервер QuantumProxies.io?

Это бесплатный сервер Model Context Protocol, который подключает Scraper API QuantumProxies.io к Claude, Cursor и любому MCP-клиенту. Ваш агент получает 29 инструментов для скрапинга, поиска, картирования и краулинга веба через резидентные прокси с TLS-отпечатками реальных браузеров. Используйте хостинговый эндпоинт со входом через OAuth или запустите npx-пакет локально.

### Поддерживает ли MCP-сервер OAuth?

Да. Хостинговый эндпоинт https://api.quantumproxies.io/mcp поддерживает вход через OAuth 2.1 в соответствии со спецификацией авторизации MCP. Добавьте URL в клиент с поддержкой входа через OAuth, войдите в QuantumProxies.io и нажмите «Allow access». PKCE обязателен, access-токены действуют один час, refresh-токены ротируются.

### Как подключить MCP-сервер к Claude?

В Claude добавьте https://api.quantumproxies.io/mcp как пользовательский коннектор и войдите, когда откроется страница QuantumProxies.io. В Claude Code выполните claude mcp add --transport http quantumproxies https://api.quantumproxies.io/mcp, затем /mcp для входа. Claude Desktop также может запускать локальный npx-пакет с API-ключом.

### Как отключить клиент?

Откройте страницу API-ключей в панели управления. У каждого клиента, подключённого через OAuth, есть собственный ключ с именем MCP · \<client name>. Удалите этот ключ, и клиент потеряет доступ; остальные клиенты и API-ключи это не затронет. Чтобы подключить его снова, добавьте URL сервера и войдите ещё раз.

### Можно ли по-прежнему использовать API-ключ?

Да. Передайте ключ qp_live_ в Authorization: Bearer или X-Api-Key на https://api.quantumproxies.io/mcp либо запустите локальный пакет командой npx -y quantumproxies-mcp с переменной окружения QUANTUMPROXIES_API_KEY. Ключ проще использовать в скриптах, CI и headless-агентах, где нет браузера для входа.

### Сколько это стоит?

Сам MCP-сервер бесплатный. Вы платите только за вызовы API, которые он выполняет, по стандартным тарифам pay-as-you-go, тем же, что и при прямых запросах к Scraper API. Оплата списывается с баланса аккаунта независимо от того, подключаетесь вы через OAuth или по ключу. Новые аккаунты получают бесплатные кредиты для теста, карта не нужна.

### Есть удалённый MCP-сервер или только локальный пакет?

Есть оба варианта. Хостинговый эндпоинт https://api.quantumproxies.io/mcp работает по Streamable HTTP для клиентов, которым удобнее URL, со входом через OAuth или по API-ключу, и предоставляет те же 29 инструментов. Npx-пакет работает на вашей машине через stdio и аутентифицируется вашим API-ключом.

### Где он работает? Видите ли вы мои данные?

Локальный пакет запускается на вашей машине через npx и обращается к публичному API QuantumProxies.io с вашим собственным ключом qp_live_: в пакете нет внутренних секретов и нет лишнего промежуточного узла. Хостинговый эндпоинт выполняет те же вызовы API с ключом, привязанным к вашему подключению; OAuth-токены никогда не передаются другим сервисам.

### Какие MCP-клиенты поддерживаются?

Любой клиент, работающий по Model Context Protocol. Клиенты, которые подключаются к удалённым серверам по Streamable HTTP и поддерживают вход через OAuth, используют хостинговый URL; stdio-клиенты, такие как Claude Desktop, Claude Code, Cursor, Windsurf, VS Code и Zed, могут запускать локальный пакет с тем же JSON из пяти строк.

### Какие инструменты получает агент?

Двадцать девять инструментов: scrape, unlock, seo_audit, ai_visibility, search, search_and_read, read_video, map, crawl и batch с опросом статуса, search_bulk и create_dataset со своими инструментами статуса, generate_parser и ещё четыре инструмента для пресетов с самовосстановлением, три инструмента Collector поверх готовых скраперов, четыре прокси-инструмента для эндпоинтов, геотаргетинга и белых списков IP, а также report для отправки отзыва команде.

### Почему бы агенту не загружать страницы самому?

Обычные HTTP-запросы агента блокируются антибот-системами именно на тех страницах, которые стоит читать. MCP-сервер направляет каждый запрос через резидентные IP с TLS-отпечатками уровня браузера, автоматическим повтором при блокировке и запасным stealth-браузером, поэтому агент видит настоящую страницу, а не капчу.

## Похожие продукты

- [Extract API: любая страница в Markdown или JSON](https://quantumproxies.io/ru/extract-api)
- [Веб-данные для LLM и RAG](https://quantumproxies.io/ru/web-data-for-llms)
- [SERP API для Google, Bing и DuckDuckGo](https://quantumproxies.io/ru/serp-api)
- [Web Unlocker для сайтов с защитой от ботов](https://quantumproxies.io/ru/web-unlocker)
- [Резидентные прокси](https://quantumproxies.io/ru/residential-proxies)

## Sources

- [What is the Model Context Protocol (MCP)?](https://modelcontextprotocol.io/docs/2026-07-28/getting-started/intro)
- [Model Context Protocol Specification](https://modelcontextprotocol.io/specification/2025-06-18)
- [Introducing the Model Context Protocol (Anthropic)](https://www.anthropic.com/news/model-context-protocol)
- [modelcontextprotocol/modelcontextprotocol (GitHub)](https://github.com/modelcontextprotocol/modelcontextprotocol)
- [Model Context Protocol (Wikipedia)](https://en.wikipedia.org/wiki/Model_Context_Protocol)
