Настройка Playwright MCP в Claude Code: Управление браузером и подключение прокси

Обычные скрипты для парсинга и автотестов часто падают, стоит сайту слегка обновить вёрстку или переименовать классы в коде. Подключение пакета playwright-mcp к консольному клиенту Claude Code решает эту проблему. Через протокол Model Context Protocol (MCP) браузер передаёт нейросети готовую текстовую схему страницы. Подбирать CSS-селекторы вручную или пересылать в модель тяжёлые скриншоты больше не нужно. Тестировщики (QA), разработчики парсеров и аналитики управляют браузерами Chromium, Firefox, WebKit и Microsoft Edge прямо из терминала, направляя запросы через прокси.

Коротко о главном: как работает связка Claude Playwright MCP

• Принцип работы: пакет playwright-mcp передаёт в Claude Code лёгкое текстовое дерево доступности Playwright MCP (browser_snapshot) вместо картинок и экономит до 80% токенов.

• Установка одной командой: консольная команда claude mcp add playwright -- npx @playwright/mcp@latest регистрирует официальный playwright mcp server для одной папки, командного проекта или всего компьютера.

• Разделение профилей: запуск с флагом --isolated в паре с файлом кук --storage-state (или отдельными папками --user-data-dir) позволяет открывать несколько браузеров параллельно без конфликтов блокировки кэша.

• Работа через прокси: параметры --proxy-server и HTTP_PROXY в файле .mcp.json направляют трафик браузера через мобильные LTE/5G, статичные резидентские ISP или ротационные резидентские прокси.

• Проверка IP до запуска: перед стартом парсинга или тестов чистоту IP-адреса легко проверить через встроенный чекер Fraud Score в личном кабинете CyberYozh App.

👉 Перейти в каталог прокси CyberYozh App с выбором по странам и типам провайдеров

Что делает Playwright MCP внутри браузера

Чтобы понять, что делает Playwright MCP на практике, сравним способы чтения веб-страницы. Прежние визуальные ИИ-агенты делали скриншот экрана и кликали по примерным координатам X и Y. Стоило всплыть рекламному баннеру или сдвинуться мобильной вёрстке - агент промахивался мимо кнопки.

Официальный playwright mcp server от Microsoft (пакет @playwright/mcp) работает напрямую с DOM. По команде browser_snapshot он считывает дерево доступности Playwright MCP (accessibility tree), где каждой кнопке, ссылке и полю ввода присвоены роль и короткая точная метка: например, поле поиска textbox "Поиск по каталогу" [ref=e5] или кнопка button "Применить фильтр" [ref=e12]. Для ввода текста или клика Claude Code передаёт метку ref=e5 в команду browser_type или browser_click. Промахи по координатам исключены. Параллельно сервер отслеживает фоновые запросы сайта к API (browser_network_requests), читает логи консоли разработчика (browser_console_messages), переключает вкладки и выгружает страницу в PDF или скриншот.

Такой подход связывает воедино три этапа сбора данных. Обычный веб-скрейпинг скачивает исходный HTML-код по ссылке. Скрин-скрейпинг (screen scraping, или скрейпинг экрана) считывает данные из визуального интерфейса (отрисованного DOM в браузере, старой программы на ПК или картинки через OCR). А парсинг разбирает и очищает найденные поля для выгрузки в CSV, Excel или XML-фид. С сервером playwright-mcp нейросеть читает живую страницу сразу после выполнения клиентского JavaScript и забирает структурированные данные без ручной вёрстки селекторов.

👉 Изучить прокси-инфраструктуру для ИИ-агентов и браузерной автоматизации в CyberYozh App

Как использовать Playwright MCP с Claude Code в терминале

Перед тем как использовать Playwright MCP с Claude Code на рабочих проектах, проверьте три базовых компонента на компьютере: установленный Node.js версии 18 или новее (рекомендуется 20+ LTS), авторизованный консольный клиент Claude Code (@anthropic-ai/claude-code) и активные доступы к прокси для защиты от лимитов на частые запросы.

Как добавить Playwright MCP в Claude Code: три режима настройки

Чтобы добавить Playwright MCP в Claude Code, выполните одну команду в терминале. Флаг --scope задаёт область действия: только для текущей папки (local), в общем файле проекта для команды (project) или глобально для всех папок на компьютере (user). При совпадении имён локальные настройки папки всегда перекрывают командные и глобальные.

Выполните эти команды в терминале, чтобы проверить версии программ, заранее скачать браузер Chromium и зарегистрировать сервер в нужном режиме:

# 1. Проверка установленных версий Node.js и Claude Code
node --version
claude --version

# 2. Предварительная установка пакета и браузера Chromium
npx @playwright/mcp@latest --version
npx playwright install chromium

# 3. Регистрация сервера (выберите один из трёх вариантов)
# Вариант А: только для текущей открытой папки
claude mcp add playwright -- npx @playwright/mcp@latest

# Вариант Б: глобально для всех ваших проектов на компьютере
claude mcp add playwright --scope user -- npx @playwright/mcp@latest

# Вариант В: создание общего файла .mcp.json в корне проекта для команды
claude mcp add playwright --scope project -- npx @playwright/mcp@latest

# 4. Проверка списка подключённых MCP-серверов
claude mcp list

Для проверки мобильной адаптивности вместо стандартного пакета можно установить сборку ExecuteAutomation (@executeautomation/playwright-mcp-server) с готовыми профилями экранов под 143 модели смартфонов и мониторов. А для быстрого парсинга сайтов через Claude AI без ручной правки конфигов подойдёт наш бесплатный опенсорсный инструмент Yozh Scraper на GitHub - он автоматически направляет запросы через прокси из вашего кабинета CyberYozh App.

👉 Подобрать мобильные и статичные ISP-прокси с безлимитным трафиком для веб-скрейпинга

Настройка Playwright MCP и прокси для Playwright MCP в файле .mcp.json

После того как базовая настройка Playwright MCP в терминале завершена, привяжем к браузеру внешний сетевой адрес. Когда вы через консоль проверяете посадочные страницы рекламы в других странах, сверяете региональные цены или парсите карточки товаров в каталогах, частые запросы с одного офисного IP быстро вызывают капчу. Чтобы подключить прокси для Playwright MCP, пропишите адрес шлюза и доступы в файле .mcp.json (или в глобальном файле ~/.claude.json):

{
  "mcpServers": {
    "playwright": {
      "command": "npx",
      "args": [
        "-y",
        "@playwright/mcp@latest",
        "--browser",
        "chromium",
        "--isolated",
        "--proxy-server=http://proxy.cyberyozh.com:8080"
      ],
      "env": {
        "HTTP_PROXY": "http://username:password@proxy.cyberyozh.com:8080",
        "HTTPS_PROXY": "http://username:password@proxy.cyberyozh.com:8080",
        "PLAYWRIGHT_MCP_PING_TIMEOUT_MS": "15000"
      }
    }
  }
}

Обратите внимание: адрес сервера (proxy.cyberyozh.com), порт (8080), логин и пароль в примере выше приведены для образца. При настройке подставьте актуальный хост, порт и данные для входа из карточки вашего купленного прокси в личном кабинете CyberYozh App.

Как управлять профилями браузера, файлами cookie и IP-адресом прокси

Чтобы при параллельном запуске нескольких задач браузер не падал с ошибкой, а сайты не сбрасывали авторизацию, разделяйте два независимых механизма:

1. Хранение кук и сессий браузера: по умолчанию сервер playwright-mcp пишет все файлы cookie в одну общую системную папку на диске. При попытке открыть второе окно терминала Claude Code и запустить ещё один браузер параллельно возникнет ошибка блокировки этой папки. Для одновременной работы нескольких окон включайте изолированный профиль Playwright MCP флагом --isolated (создаёт чистую среду в оперативной памяти), а сохранённые куки авторизации подгружайте в такой изолированный профиль Playwright MCP через параметр --storage-state=./auth.json. Если же под проект нужен постоянный профиль на диске, задайте для него отдельную папку флагом --user-data-dir.

2. Постоянство IP-адреса прокси: сохранённые куки и внешний IP работают в паре, но не заменяют друг друга. Постоянный IP не продлит истёкший токен в куках, а сохранённые куки не спасут от сброса сессии, если посреди оформления заказа сменился внешний IP. Учитывайте и особенность Chromium: стандартный флаг --proxy-server принимает логин и пароль только для протокола HTTP/HTTPS. Каналы SOCKS5 напрямую в Chromium работают только без пароля (по привязке к вашему основному IP в панели управления), а для SOCKS5 с паролем нужен локальный туннель или сторонний проксификатор.

👉 Выбрать ротационные резидентские прокси от $4.00 за ГБ со sticky-сессиями до 24 часов

Какие прокси CyberYozh App выбрать для работы с playwright-mcp

Выбор линейки зависит от целевой площадки и длительности одной сессии. На платформе CyberYozh App под каждую задачу браузерной автоматизации предусмотрен свой тип прокси:

• Мобильные прокси (LTE / 4G / 5G) по цене от $1.70 в сутки с безлимитным трафиком: работают через физические модемы и реальные SIM-карты сотовых операторов. Поскольку на одном мобильном IP сотового оператора по технологии CGNAT одновременно работают сотни обычных абонентов, антифрод-системам и поисковику Google сложнее пометить такой адрес как подозрительный, и запросы при многопоточном парсинге выдачи или проверке рекламных кабинетов реже попадают под ограничения. Доступны приватные (выделенные) и общие (shared) каналы: на приватных вы сами меняете IP по ссылке в панели управления или через API, а на общих адрес обновляется по таймеру каждые 5 или 30 минут. Поддерживаются HTTP/HTTPS, SOCKS5, UDP, конфигурации VPN/VLESS и смена сетевого отпечатка ОС (TCP/IP OS fingerprint). Учитывайте деталь сотовых сетей: даже на приватном канале вышки оператора периодически обновляют IP на своей стороне, поэтому для многочасовых задач сначала возьмите посуточный тариф и проверьте длину сессии.

• Статичные резидентские ISP-прокси по цене от $5.29 в месяц с безлимитным трафиком: закрепляют за вами один выделенный домашний IP от реального интернет-провайдера (ISP) на весь срок аренды с аптаймом 99.9% и поддержкой HTTP/HTTPS и SOCKS5. Подходят для длительных сессий на недели и месяцы: для сопровождения клиентских и брендовых проектов, для регулярной работы в рекламных кабинетах, панелях управления и интернет-магазинах, а также для разделения сетевой среды разных заказчиков. Под каждого клиента создаётся отдельная папка профиля (--user-data-dir), куда один раз прописывается выделенный статичный ISP-прокси - сотрудники открывают готовый профиль проекта и сразу выходят в сеть с закреплённого IP, не смешивая куки разных заказчиков.

• Ротационные резидентские прокси по цене от $4.00 за ГБ (минимальный пакет - 3 ГБ; при объёме 100 ГБ цена снижается до $2.50 за ГБ): открывают доступ к пулу более 100 млн резидентских IP в 195+ странах. Включают бесплатный геотаргетинг (страна, штат/регион, город), предварительную фильтрацию IP (Advanced IP filtering), аптайм 99.9% и проходимость запросов до 99.99%. Вы можете включить ротацию на каждый запрос либо удерживать один IP до 24 часов через sticky-сессии. Неизрасходованный остаток трафика автоматически переносится на следующий расчётный месяц, а для команд предусмотрены массовый генератор доступов (Mass Credentials Generator) и управление по API. Sticky-сессии закрывают задачи дневного мониторинга цен и пошаговой проверки вёрстки интернет-магазинов.

• Серверные (дата-центр) прокси по цене от $1.77 в месяц: предоставляют выделенные и совместные (shared) каналы IPv4/IPv6 с безлимитным трафиком на выделенных тарифах и аптаймом 99.99%. Подходят для скоростных браузерных автотестов сайтов, мониторинга доступности и работы с открытыми API.

👉 Арендовать мобильные прокси LTE/5G от $1.70 в сутки с безлимитным трафиком

Проверка чистоты IP через чекер Fraud Score и решение частых ошибок

Перед запуском сценариев playwright-mcp проверьте выделенный IP-адрес через встроенные чекеры предварительной оценки рисков. Разовая проверка IP стоит $0.15, а единая подписка за $19.00 в месяц включает 1500 проверок IP-адресов, 1500 проверок телефонных номеров и 500 проверок банковских карт (экономия до $600 в месяц). Чекер опрашивает базы IPQualityScore (IPQS), CyberSource, ThreatMetrix, Stripe Radar, PerimeterX и 118 чёрных списков OSINT. Ещё до старта браузера вы видите строку провайдера (ISP/ASN), оценку риска мошенничества и отсутствие метки аномальной активности (Abuse Velocity).

Для проверки связки claude playwright mcp запустите терминальный клиент командой claude. При самом первом старте утилита npx скачивает файлы сервера в кэш, поэтому при долгом отклике запускайте клиент с увеличенным таймаутом: MCP_TIMEOUT=10000 claude. Внутри чата введите /mcp и убедитесь, что напротив playwright горит статус connected. В первом сообщении явно укажите название инструмента, чтобы агент сам открыл браузер, а не сгенерировал код скрипта в ответ:

Используй Playwright MCP: открой страницу https://app.cyberyozh.com/checkers/, считай структуру страницы и выведи список доступных чекеров для проверки IP-адресов, номеров и карт.

Если ваши браузерные автотесты сайтов включают проверку форм регистрации по SMS или тестовую оплату, в панели управления CyberYozh App можно арендовать виртуальные номера для приёма SMS и выпустить виртуальные карты.

👉 Проверить репутацию IP и Fraud Score перед запуском браузера

С чего начать работу с браузерным сервером в Claude Code

Связка playwright-mcp и Claude Code переводит текстовые команды терминала в точные действия внутри реального браузера: агент открывает страницы, находит элементы по дереву доступности и собирает данные без сбоев на динамической вёрстке. А подключив мобильные LTE/5G, статичные резидентские ISP или ротационные резидентские прокси от сервиса CyberYozh App, вы сможете запускать браузерные автотесты сайтов, проверять региональные витрины и парсить каталоги из одного личного кабинета.

👉 Подключить виртуальные номера для приёма SMS при тестировании форм регистрации