Автоматизация антидетект браузера: Playwright, локальный API и MCP

• Компьютер с Windows и запущенным приложением AliasMode. Установщик есть только для Windows, на macOS и Linux AliasMode запускают из исходного кода.
• Хотя бы один профиль. Для локального API и CDP нужен Chromium-профиль: движок CloakBrowser AliasMode скачивает и проверяет сам.
• Для своего кода на Node.js — Playwright в проекте. Для библиотеки скриптов ставить ничего не нужно.
• Профиль должен храниться на том же компьютере, где работает скрипт или локальный MCP.

Профиль сохраняет cookies и сессии между запусками, поэтому автоматизация продолжает работу в уже авторизованном аккаунте. Повторно входить в аккаунт перед каждым запуском не нужно.

Приложение AliasMode поднимает локальный API по адресу http://127.0.0.1:50400. Он реализует часть эндпоинтов AdsPower /api/v1: проверку статуса, список, создание, изменение и удаление профилей, группы, запуск и остановку браузера, cookies и кэш. Если эндпоинта нет в документации, не рассчитывайте, что он работает.

Схема из трёх шагов. Найдите ID профиля через /api/v1/user/list. Запустите профиль запросом /api/v1/browser/start?user_id= и возьмите адрес CDP из поля data.ws.puppeteer в ответе. Подключитесь через chromium.connectOverCDP из Playwright. Браузер откроется со своими данными, прокси, cookies и активной сессией. Этот способ работает с Chromium-профилями.

Ответ приходит в формате { code, msg, data }, где code 0 означает успех. Даже при нормальном HTTP-статусе code может быть -1, поэтому проверяйте оба значения. В конце работы сначала отключите Playwright, затем вызовите browser/stop.

import { chromium } from 'playwright';

// ID профиля возьмите из: curl 'http://127.0.0.1:50400/api/v1/user/list'
const res = await fetch('http://127.0.0.1:50400/api/v1/browser/start?user_id=' + profileId);
const { data } = await res.json();
const browser = await chromium.connectOverCDP(data.ws.puppeteer);
const context = browser.contexts()[0];
// здесь ваша автоматизация в профиле с сохранённым входом

await browser.close();
await fetch('http://127.0.0.1:50400/api/v1/browser/stop?user_id=' + profileId);

1. Если запрос не проходит, убедитесь, что приложение AliasMode открыто, и проверьте, что curl http://127.0.0.1:50400/api/v1/status возвращает JSON.
2. Проверьте, что ID профиля взят из /api/v1/user/list и профиль не удалён.
3. Смотрите и HTTP-статус, и поля code и msg. Нет адреса CDP — значит, запуск не удался.
4. Останавливайте браузер перед удалением профиля. Один профиль в каждый момент должна вести одна программа, иначе действия будут мешать друг другу.

На странице «Скрипты» в приложении можно писать скрипты Playwright на JavaScript или Python. В версию для Windows уже входят Node.js, Python и Playwright, ставить ничего не нужно. Скрипты работают и в профилях AliasMode Firefox, и в Chromium-профилях.

Для запуска выберите один профиль, несколько профилей или целую папку. Укажите, сколько браузеров работает одновременно: по умолчанию 10, при значении 1 профили идут по очереди. Лог виден в реальном времени, запуск можно остановить в любой момент. При параллельной работе каждый браузер использует свою сессию и свой прокси. Это удобно для парсинга и повторяющихся задач на сотнях профилей.

В публичной библиотеке есть скрипты сообщества. Прочитайте исходный код, затем импортируйте себе личную копию.

async def run(page, profile, log, **_):
    await page.goto('https://example.com')
    log(profile['name'], await page.title())

MCP (Model Context Protocol) — открытый протокол, через который ИИ-клиенты вызывают внешние инструменты. MCP-сервер AliasMode входит в установщик. Он даёт инструменты для работы с профилями: список, создание, удаление, открытие и закрытие браузера. Также есть инструменты Playwright для кликов, ввода текста и скриншотов в выбранном браузере.

Локальный MCP работает через stdio на том же компьютере, где хранятся профили. Он подходит для Claude Code, Codex и других клиентов, а в локальном режиме не требует аккаунта. Чтобы зарегистрировать AliasMode во всех найденных клиентах, выполните в папке установки команду aliasmode-mcp setup --yes. Если приложение закрыто, MCP-сервер сам запустит его в фоне и дождётся готовности.

Удалённый MCP публикует те же инструменты через облако AliasMode. Claude.ai и ChatGPT подключаются по OAuth. Для этого нужен облачный режим и компьютер с Windows, на котором выполнен вход и запущен AliasMode. Открытый браузер сразу становится выбранным, и все действия Playwright идут в нём, со своими данными, прокси и отпечатком.

cd "%LOCALAPPDATA%\AliasMode"
aliasmode-mcp setup --yes

Если у вас уже есть код под API AdsPower, начните с локального API. Если нужно быстро прогнать один сценарий по многим профилям, используйте библиотеку скриптов. Если задачу проще описать словами, чем кодом, подключите MCP.

Способы можно сочетать. Например, ежедневную рутину гонять скриптами по расписанию, а разовые задачи отдавать ИИ-агенту через MCP. Следите только, чтобы один профиль в каждый момент вела одна программа.