AlterLab MCP Server
Предоставьте Claude, Cursor и Windsurf возможность сканировать любой сайт, извлекать структурированные данные и делать скриншоты — с автоматическим обходом антибот-защиты.
Начать бесплатно → $1 бесплатный баланс при регистрации — до 5 000 скрап-запросов.
Установка за одну строку
Claude Code
claude mcp add alterlab -- npx -y alterlab-mcp-server@latest
Затем укажите ваш API-ключ: export ALTERLAB_API_KEY=sk_live_... или добавьте его в .claude.json (см. полную настройку ниже).
Cursor
# Добавьте в .cursor/mcp.json — см. полную конфигурацию ниже
Smithery
npx -y @smithery/cli install alterlab-mcp-server --client claude
Почему AlterLab вместо WebFetch или Browser MCP?
Встроенный инструмент Claude WebFetch и открытые серверы browser MCP чаще всего не работают на реальных сайтах. Они не способны обходить Cloudflare, рендерить JavaScript SPA и извлекать структурированные данные.
AlterLab заменяет неисправные инструменты получения данных одним MCP сервером, который действительно работает:
| Возможность | WebFetch / fetch() | Browser MCP | AlterLab MCP |
|---|---|---|---|
| обход анти-бот защиты (Cloudflare, DataDome, Akamai) | Нет | Частично | Да — автоматический |
| рендеринг JavaScript (React, Angular, Vue SPAs) | Нет | Да (медленно) | Да — headless Chromium |
| извлечение структурированных данных (JSON, Schema.org) | Нет | Нет | Да — встроенные профили |
| умное увеличение уровня обработки (сначала самый дешевый метод) | N/A | N/A | Да — экономит 60-80% |
| ротация резидентских прокси (195+ стран) | Нет | Нет | Да |
| захват скриншотов и PDF | Нет | Только скриншот | Да — и то, и другое |
| OCR-извлечение текста из изображений | Нет | Нет | Да |
| стоимость за запрос | Бесплатно (но не работает) | Бесплатно (но медленно) | От $0.0002 |
Как работает веб-скрапинг AlterLab?
AlterLab использует многоуровневую архитектуру скрапинга. Он автоматически выбирает самый дешевый метод, способный получить доступ к каждому URL:
-
Curl ($0.0002/запрос) — прямой HTTP для статических страниц, RSS, открытых API
-
HTTP ($0.0003/запрос) — ротация TLS fingerprint для умеренно защищённых сайтов
-
Stealth ($0.0005/запрос) — имитация браузера для сайтов под Cloudflare/DataDome
-
Light JS ($0.0007/запрос) — лёгкая выборка JS из серверно-отображаемого HTML
-
Browser ($0.001/запрос) — полный headless Chromium для JavaScript‑нагруженных SPAs
Авто-режим начинает с Tier 1 и эскалируется только при блокировке. Большинство сайтов укладываются на Tier 1-2, поэтому за 1$ вы получаете от 1 000 до 5 000 скрап-запросов, в зависимости от целей.
Установка
Установка в Claude Desktop / Claude Code
Добавьте в файл конфигурации Claude (~/.claude.json для Claude Code, или настройки для Claude Desktop):
{
"mcpServers": {
"alterlab": {
"command": "npx",
"args": ["-y", "alterlab-mcp-server@latest"],
"env": {
"ALTERLAB_API_KEY": "sk_live_your_key_here"
}
}
}
}
Установка в Cursor
Добавьте в .cursor/mcp.json в корневой директории проекта:
{
"mcpServers": {
"alterlab": {
"command": "npx",
"args": ["-y", "alterlab-mcp-server@latest"],
"env": {
"ALTERLAB_API_KEY": "sk_live_your_key_here"
}
}
}
}
Установка в Windsurf
Добавьте в настройки Windsurf MCP (~/.codeium/windsurf/mcp_config.json):
{
"mcpServers": {
"alterlab": {
"command": "npx",
"args": ["-y", "alterlab-mcp-server@latest"],
"env": {
"ALTERLAB_API_KEY": "sk_live_your_key_here"
}
}
}
}
Установка через Smithery
npx -y @smithery/cli install alterlab-mcp-server --client claude
Получение API-ключа
-
Зарегистрируйтесь бесплатно — $1 бесплатный баланс при регистрации
-
Перейдите в Dashboard → API Keys и скопируйте ваш ключ
-
Вставьте его в поле
ALTERLAB_API_KEYв вашей MCP-конфигурации
Инструменты
alterlab_scrape — Скрапинг любой веб-страницы
Скрапируйте URL и возвращайте содержимое в формате markdown, text, HTML или JSON. Автоматически обходит анти-бот-защиты с escalatioйнм до нужного уровня. По умолчанию возвращает markdown — оптимизирован для контекстных окон LLM.
"Скрапить https://www.amazon.com/dp/B0BSHF7WHW и суммировать товар"
| Параметр | Тип | По умолчанию | Описание |
|---|---|---|---|
| url | string | обязательно | URL для скрапинга |
| mode | auto | html | js |
| formats | (text | json | html |
| render_js | boolean | false | Использовать headless-браузер (+3 кредита) |
| use_proxy | boolean | false | Премиум-прокси (+1 кредит) |
| proxy_country | string | — | ISO-код страны для геотаргетинга (например, US, DE) |
| wait_for | string | — | CSS-селектор, ожидать перед извлечением |
| timeout | number | 90 | Тайм-аут в секундах (1-300) |
| include_raw_html | boolean | false | Включать исходный HTML вместе с отформатированным контентом |
| session_id | string (UUID) | — | Идентификатор сохранённой сессии для аутентифицированного скрапинга |
| cookies | Record | — | Встроенные cookies для одноразовых запросов с аутентификацией |
alterlab_extract — Извлечение структурированных данных
Извлекайте структурированные поля с любой веб-страницы, используя готовые профили или настраиваемую JSON Schema. Возвращает чистый JSON — готов к базам данных, таблицам и дальнейшей обработке.
"Extract the product name, price, and rating from this Amazon page"
| Параметр | Тип | По умолчанию | Описание |
|---|---|---|---|
| url | string | обязательно | URL для извлечения |
| extraction_profile | enum | auto | Профиль: product, article, job_posting, faq, recipe, event |
| extraction_schema | object | — | Пользовательская JSON Schema для структурированного вывода |
| extraction_prompt | string | — | Инструкция на естественном языке для извлечения |
| render_js | boolean | false | Использовать headless-браузер |
| use_proxy | boolean | false | Премиум-прокси |
Профили извлечения:
-
Product — название, цена, валюта, рейтинг, отзывы, наличие, изображения, описание
-
Article — заголовок, автор, дата публикации, текст, изображение-обложка
-
Job Posting — заголовок, компания, местоположение, зарплата, описание, требования
-
FAQ — пары вопрос-ответ
-
Recipe — ингредиенты, инструкции, время подготовки, порции
-
Event — название, дата, место, описание, организатор
alterlab_screenshot — Скриншот любой страницы
Сделайте полноразмерный скриншот любого URL. Возвращает PNG-изображение прямо в беседе — без необходимости копировать ссылки или скачивать файлы.
"Take a screenshot of our landing page at https://alterlab.io"
| Параметр | Тип | По умолчанию | Описание |
|---|---|---|---|
| url | string | обязательно | URL для скриншота |
| wait_for | string | — | CSS-селектор для ожидания перед захватом |
| wait_until | enum | networkidle | networkidle, domcontentLoaded, или load |
alterlab_estimate_cost — Оценка перед скрапингом
Проверьте, сколько обойдётся скрапинг до его выполнения. Возвращает предсказанный tier, стоимость за запрос и уровень уверенности.
"How much would it cost to scrape linkedin.com?"
| Параметр | Тип | По умолчанию | Описание |
|---|---|---|---|
| url | string | обязательно | URL для оценки |
| mode | enum | auto | Режим скрапинга |
| render_js | boolean | false | Включить стоимость рендера JS |
| use_proxy | boolean | false | Включить стоимость прокси |
alterlab_check_balance — Проверить ваши кредиты
Проверка баланса аккаунта, общей суммы пополнений и общей суммы затрат. Параметров нет.
"Check my AlterLab balance"
alterlab_list_sessions — Список сохранённых сессий
Перечень всех сохранённых сессий для аутентифицированного скрапинга. Сессии содержат cookies для конкретных доменов, позволяя скрапить контент за входом.
"List my stored sessions"
alterlab_create_session — Создать сессию
Создайте новую сохранённую сессию с cookies из залогиненного браузера. Сессия хранится безопасно и может использоваться повторно в нескольких запросах скрапинга.
"Create an Amazon session with these cookies: session-id=abc123, session-token=xyz789"
| Параметр | Тип | По умолчанию | Описание |
|---|---|---|---|
| name | string | обязательно | Человеко-читаемое имя (напр., "Мой аккаунт Amazon") |
| domain | string | обязательно | Домен (напр., "amazon.com") |
| cookies | Record | обязательно | Пары ключ-значение cookies |
| user_agent | string | — | User-Agent браузера, который следует использовать с этой сессией |
alterlab_validate_session — Проверить сессию
Проверьте, активна ли сохранённая сессия и валидны ли её cookies.
"Is my Amazon session still valid?"
| Параметр | Тип | По умолчанию | Описание |
|---|---|---|---|
| session_id | string (UUID) | обязательно | ID сессии для проверки |
alterlab_delete_session — Удалить сессию
Безвозвратно удалить сохранённую сессию и её cookies.
"Delete session abc-123-def"
| Параметр | Тип | По умолчанию | Описание |
|---|---|---|---|
| session_id | string (UUID) | обязательно | ID сессии для удаления |
Аутентифицированный скрапинг
AlterLab MCP поддерживает скрапинг страниц, требующих аутентификации. Это позволяет AI-агентам получать доступ к контенту пользователя, например к истории заказов, панелям управления аккаунтом и цене для членов.
Как это работает
-
Создайте сессию с cookies из залогиненного браузера, используя
alterlab_create_session -
Скрапайте страницы с аутентификацией передавая
session_idвalterlab_scrape -
Управляйте сессиями с помощью инструментов list, validate и delete
Пример: проверка цены Amazon Prime
User: "What's my Prime member price for this product?"
Claude: [calls alterlab_list_sessions → finds Amazon session]
Claude: [calls alterlab_scrape with session_id for authenticated pricing]
Claude: "The Prime member price is $24.99 (public price: $34.99)"
Встроенные cookies vs сохранённые сессии
-
Сохранённые сессии (
session_id): лучше подходит для повторного доступа к одному и тому же домену. Создайте одну и используйте повторно в запросах. -
Встроенные cookies (
cookies): лучше для однократных аутентифицированных запросов, когда сессию сохранять не нужно.
Что можно делать с AlterLab MCP?
Исследование и анализ
Попросите Claude скрапить и анализировать сайты в реальном времени:
-
"Sкрап топ-5 результатов этого запроса в Google и суммируй их"
-
"Извлеки все цены на продукты с этой страницы категорий Amazon"
-
"Сравни страницы ценообразования трех конкурентов"
Генерация кода на основе реальных данных
Позвольте Cursor или Windsurf получать живые данные во время работы над кодом:
-
"Скрапни страницу с документацией API и сгенерируй из неё TypeScript-типы"
-
"Извлеки палитру цветов с этого сайта и создай конфиг Tailwind"
-
"Сделай скриншот этого дизайна и воспроизведи его в React"
Контент и SEO
Используйте Claude для анализа контента в большом объёме:
-
"Скрапни эту блог-публикацию и предложи улучшения для SEO"
-
"Извлеки все элементы FAQ из этого раздела поддержки и создай структурированный набор данных"
-
"Сравни нашу лендинг-страницу с конкурентной и выяви пропуски"
Мониторинг и оповещения
Стройте агентские рабочие процессы, которые следят за вебом:
-
"Проверяй, вернулся ли этот товар в наличие"
-
"Скрапь эту страницу ежедневно и уведомляй, когда цена упадёт ниже $50"
-
"Мониторь этот джоб-борд на наличие новых вакансий уровня senior"
Ценообразование — Pay-As-You-Go веб-скрапинг
Без подписок. Без ежемесячного минимума. Пополняйте баланс и используйте по мере необходимости.
Базовые затраты на скрапинг
| Tier | Метод | Стоимость за запрос | Применение |
|---|---|---|---|
| Curl | Direct HTTP | $0.0002 | Статические страницы, RSS, открытые API |
| HTTP | TLS fingerprinting | $0.0003 | Сайты с базовым обнаружением ботов |
| Stealth | Browser impersonation | $0.0005 | Сайты под Cloudflare, DataDome, PerimeterX |
| Light JS | JSON Extraction | $0.0007 | Серверно-сгенерированные страницы с необходимостью структурированных данных |
| Browser | Headless Chromium | $0.001 | Полные JS-SPAs (React, Angular, Vue) |
Дополнительные опции
| Дополнение | Дополнительная стоимость | Описание |
|---|---|---|
| Рендеринг JavaScript | +$0.0006 | Headless Chromium для динамического контента |
| Захват скриншотов | +$0.0002 | Полный PNG-скриншот всей страницы |
| Премиум-прокси | +$0.0002 | Гео-таргетинг резидентного прокси (195+ стран) |
| Извлечение текста OCR | +$0.001 | Извлечение текста из изображений на странице |
$1 = 5 000 лёгких скрапов. Новые аккаунты получают $1 бесплатного баланса при регистрации.
Переменные окружения
| Переменная | Обязательна | По умолчанию | Описание |
|---|---|---|---|
| ALTERLAB_API_KEY | Да | — | Ваш API-ключ (получить можно бесплатно) |
| ALTERLAB_API_URL | Нет | https://api.alterlab.io | Базовый URL API (для self-hosted или разработки) |
Часто задаваемые вопросы
Как добавить веб-скрапинг в Claude, Cursor или Windsurf?
Установите MCP сервер AlterLab. Для Claude Code выполните claude mcp add alterlab -- npx -y alterlab-mcp-server@latest и задайте ваш ALTERLAB_API_KEY. Для Claude Desktop, Cursor или Windsurf добавьте JSON-блок конфигурации в настройки MCP. После настройки ваш AI-ассистент сможет скрапить любой URL, извлекать структурированные данные и делать скриншоты прямо в беседе.
Может ли Claude скрапить сайты, скрытые за Cloudflare или антибот-защитой?
Да. AlterLab автоматически обходит Cloudflare, DataDome, PerimeterX, Akamai и другие системы антибот-защиты. Применяется многоуровневый подход: начинается с самого дешевого метода и эскалируется только при блокировке. Ничего настраивать не нужно — обход антибот-защиты полностью автоматический.
Что такое MCP-сервер и как он работает с Claude?
MCP (Model Context Protocol) — открытый стандарт Anthropic для подключения AI‑помощников к внешним инструментам и данным. MCP-сервер — это небольшая программа, которая выставляет инструменты — такие как веб-скрапинг — чтобы Claude, Cursor или Windsurf могли вызывать их во время беседы. AlterLab MCP-сервер предоставляет вашему AI‑помощнику 23 инструмента: скрапинг, извлечение, скриншоты, краулинг, поиск, построение карт, пакетный скрапинг, управление сессиями, бета-функции и многое другое.
Чем AlterLab отличается от Firecrawl, ScrapingBee или Apify MCP серверов?
AlterLab начинается с $0.0002 за запрос — на 5–20x дешевле большинства scraping API — потому что он использует дорогой рендеринг браузера только там, где это реально требуется. Умное эскалирование уровней означает плату за то, что требуется конкретному сайту, а не за максимум. Также в комплект входит встроенное извлечение структурированных данных с готовыми профилями (product, article, job posting и т. д.) без доп. затрат.
Можно ли скрапить Amazon, Walmart и другие сайты электронной коммерции через Claude?
Да. AlterLab обходит все основные защиты в этой нише. Используйте инструмент alterlab_extract с extraction_profile: "product" для получения структурированного JSON: название товара, цена, валюта, рейтинг, число отзывов, наличие и изображения — готово к анализу, сравнению или загрузке в пайплайны.
Может ли Cursor скрапить документацию и генерировать код по ней?
Да. С установленным в Cursor AlterLab MCP вы можете попросить его скрапить документацию API, документацию библиотек или любую справочную страницу и сгенерировать живые TypeScript-типы, клиенты API или код компонентов на основе актуального контента. Это надёжнее, чем полагаться на данные из обучающих наборов модели, которые могут устаревать.
Работает ли AlterLab MCP с сайтами на JavaScript (React, Angular, Vue)?
Да. Используйте render_js: true или mode: "js", чтобы включить полноценный headless Chromium. AlterLab рендерит страницу полностью, включая все JavaScript, дожидается загрузки динамического контента и извлекает контент из полностью отрисованного DOM. Это работает для React, Angular, Vue, Next.js и любых других JS‑фреймворков.
Какой выходной формат лучше для контекста AI и окон LLM?
Используйте markdown (по умолчанию). Он сохраняет структуру документа — заголовки, таблицы, списки, ссылки — и при этом на 60-80% меньше чем raw HTML. Claude, GPT-4 и другие LLM лучше обрабатывают markdown, чем HTML. Выход AlterLab в markdown специально оптимизирован под контекстные окна LLM.
Есть ли ограничение по скорости?
У бесплатных аккаунтов есть лимиты скорости. Добавление баланса снимает ограничения по скорости. MCP-сервер поддерживает автоматическую повторную попытку с экспоненциальной задержкой при временных ошибках (429).
Можно ли использовать этот MCP-сервер для крупномасштабного скрапинга?
Да. Для параллельного скрапинга используйте alterlab_batch для скрапинга до 100 URL в одном запросе — значительно быстрее последовательных вызовов. Для обхода всего домена используйте alterlab_crawl. Можно также строить агентские рабочие процессы, которые скрапят множество URL последовательно, или воспользоваться интеграцией n8n для автоматизации рабочих процессов.
Обработка ошибок
MCP-сервер возвращает понятные сообщения об ошибках с предложениями дальнейших действий:
| Ошибка | Что происходит | Предложенное действие |
|---|---|---|
| 401 Unauthorized | Неверный API-ключ | Убедитесь, что ALTERLAB_API_KEY установлен корректно |
| 402 Insufficient Credits | Баланс слишком мал | Запустите alterlab_check_balance, пополните баланс |
| 403 Forbidden | Сайт заблокировал запрос | Попробуйте render_js: true + use_proxy: true |
| 429 Rate Limited | Слишком много запросов | Автоматическая повторная попытка с экспоненциальной задержкой |
| 504 Gateway Timeout | Скрапинг занял слишком долго | Установите больший timeout, упростите запрос |
Агентские рабочие процессы — AI-агенты, скрапящие интернет
AlterLab MCP превращает любой AI‑агент в веб‑агента. Вместо использования устаревших данных обучения ваш агент может получать живую информацию с любого сайта во время выполнения.
Примеры применения AI-агентов
-
Агенты для исследований — скрапинг нескольких источников, перекрёстная проверка фактов, формирование отчётов с цитированиями
-
Агенты для обработки данных — извлечение структурированных данных о продуктах/ценообразовании/работе по расписанию
-
Конкурентная разведка — мониторинг страниц конкурентов, отслеживание изменений цен, поиск новых функций
-
Контент и SEO — анализ контента в больших объёмах
-
Обогащение лидов — скрапинг сайтов компаний для обновления CRM
-
Соблюдение требований — мониторинг регуляторных страниц, условий использования и обновлений политики
Совместимые AI‑фреймворки и клиенты
Работает с любым инструментом, поддерживающим MCP (Model Context Protocol):
-
Claude Desktop / Claude Code — помощник от Anthropic
-
Cursor — редактор кода с искусственным интеллектом
-
Windsurf — AI‑IDE от Codeium
-
Cline — AI‑помощник в VS Code
-
GitHub Copilot — через конфигурацию MCP
-
Пользовательские агенты — любой фреймворк, использующий MCP SDK (Python, TypeScript, Go)
-
n8n — автоматизация рабочих процессов через n8n-nodes-alterlab
Как внести вклад
git clone https://github.com/RapierCraft/alterlab-mcp-server.git
cd alterlab-mcp-server
npm install
npm run build