playwright-stealth — MCP-сервер для Claude Code
Сервер даёт агенту доступ к Playwright для управления браузером, снимков страниц и записи видео. Режим stealth можно включить отдельно.
claude mcp add --env STEALTH_MODE=<STEALTH_MODE> --env STEALTH_USER_AGENT=<STEALTH_USER_AGENT> --env STEALTH_MASK_LINUX=<STEALTH_MASK_LINUX> --env STEALTH_LOCALE=<STEALTH_LOCALE> --env HEADLESS=<HEADLESS> --transport stdio playwright-stealth -- npx -y playwright-stealth-mcp-serverЧто делает playwright-stealth
Агент выполняет JavaScript через инструмент browser_execute с доступом к объекту page. Сессия браузера сохраняется между вызовами, поэтому можно пройти несколько шагов подряд; отдельные инструменты делают скриншоты, показывают состояние браузера и управляют записью WebM-видео.
Stealth-режим настраивается через STEALTH_MODE и использует playwright-extra с плагином stealth. Также можно задать прокси и параметры браузера через переменные окружения. По умолчанию браузер работает в headless-режиме, а HTTPS-ошибки игнорируются; для более строгой проверки сертификатов значение IGNORE_HTTPS_ERRORS нужно установить в false. Разрешения браузера по умолчанию выданы все, поэтому проверьте конфигурацию перед запуском на реальных сайтах.
Какие задачи решает
- автоматизировать переходы и действия на веб-страницах
- сохранить состояние браузера между шагами сценария
- снять скриншот всей страницы или выбранного элемента
- записать взаимодействие с браузером в WebM
- проверить URL, заголовок и настройки текущей сессии
Примеры запросов агенту
- Открой страницу входа и проверь её заголовок через Playwright.
- Сделай скриншот элемента с CSS-селектором
#main-content. - Запиши действия в браузере и сохрани результат в WebM.
Как установить playwright-stealth
Командой платформы
claude mcp add --env STEALTH_MODE=<STEALTH_MODE> --env STEALTH_USER_AGENT=<STEALTH_USER_AGENT> --env STEALTH_MASK_LINUX=<STEALTH_MASK_LINUX> --env STEALTH_LOCALE=<STEALTH_LOCALE> --env HEADLESS=<HEADLESS> --transport stdio playwright-stealth -- npx -y playwright-stealth-mcp-serverВместо <…> подставьте свои значения. Ещё 10 переменных окружения — в README сервера
Командой платформы
codex mcp add playwright-stealth --env STEALTH_MODE=<STEALTH_MODE> --env STEALTH_USER_AGENT=<STEALTH_USER_AGENT> --env STEALTH_MASK_LINUX=<STEALTH_MASK_LINUX> --env STEALTH_LOCALE=<STEALTH_LOCALE> --env HEADLESS=<HEADLESS> -- npx -y playwright-stealth-mcp-serverВместо <…> подставьте свои значения. Ещё 10 переменных окружения — в README сервера
Файл настроек
{
"mcpServers": {
"playwright-stealth": {
"command": "npx",
"args": [
"-y",
"playwright-stealth-mcp-server"
],
"env": {
"STEALTH_MODE": "<STEALTH_MODE>",
"STEALTH_USER_AGENT": "<STEALTH_USER_AGENT>",
"STEALTH_MASK_LINUX": "<STEALTH_MASK_LINUX>",
"STEALTH_LOCALE": "<STEALTH_LOCALE>",
"HEADLESS": "<HEADLESS>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 10 переменных окружения — в README сервера
Файл настроек
{
"servers": {
"playwright-stealth": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"playwright-stealth-mcp-server"
],
"env": {
"STEALTH_MODE": "<STEALTH_MODE>",
"STEALTH_USER_AGENT": "<STEALTH_USER_AGENT>",
"STEALTH_MASK_LINUX": "<STEALTH_MASK_LINUX>",
"STEALTH_LOCALE": "<STEALTH_LOCALE>",
"HEADLESS": "<HEADLESS>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 10 переменных окружения — в README сервера
Командой платформы
gemini mcp add -e STEALTH_MODE=<STEALTH_MODE> -e STEALTH_USER_AGENT=<STEALTH_USER_AGENT> -e STEALTH_MASK_LINUX=<STEALTH_MASK_LINUX> -e STEALTH_LOCALE=<STEALTH_LOCALE> -e HEADLESS=<HEADLESS> playwright-stealth npx -y playwright-stealth-mcp-serverВместо <…> подставьте свои значения. Ещё 10 переменных окружения — в README сервера
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о playwright-stealth
Как установить playwright-stealth в Claude Code?
Выполните `claude mcp add --env STEALTH_MODE=<STEALTH_MODE> --env STEALTH_USER_AGENT=<STEALTH_USER_AGENT> --env STEALTH_MASK_LINUX=<STEALTH_MASK_LINUX> --env STEALTH_LOCALE=<STEALTH_LOCALE> --env HEADLESS=<HEADLESS> --transport stdio playwright-stealth -- npx -y playwright-stealth-mcp-server`.
Что делает playwright-stealth?
Он подключает Playwright к агенту через MCP. Агент может выполнять код в браузере, делать снимки страниц и записывать сессию в WebM.
Как включить stealth-режим?
Задайте STEALTH_MODE как true в настройках сервера. Для прокси предусмотрены переменные PROXY_URL, PROXY_USERNAME и PROXY_PASSWORD.
