Разработчикам

Сценарий, открывающий чистый Chromium, начинается с той машины, где он работает: её экран, её шрифты, её строка видеокарты, её часы.

Профиль ARMANOS несёт устройство с собой, на одном из пяти шаблонов, и значения подставляются внутри движка, а не рисуются поверх страницы.

Отдельный каталог данных разделяет куки и этого не умеет.

Обычные ответы это окно инкогнито, расширение подмены отпечатка или виртуальная машина на аккаунт.

Каждый останавливается в своём месте, а тот, что не останавливается нигде, стоит ноутбука памяти на личность.

Включите переключатель «Включить локальный API» в разделе «Для программистов» в левом столбце. Сервер слушает петлю и больше ничего, а до вашего включения он выключен.

При первом запуске программа кладёт рядом со своими данными токен доступа из 24 случайных байтов, читаемый только вашей учётной записью.

Петля сама по себе не граница: страницы, которые открывает человек, работают на этой же машине. Запрос с заголовком Origin, с чужим Host или с Sec-Fetch-Site не равным none получает 403.

Эта проверка идёт раньше хода состояния, который называет продукт и его точную версию.

Запуск идёт той же дорогой, что и кнопка в окне, а режим без окна просится на один прогон, не трогая галочку профиля «Запускать без окна (для автоматизации)».

На ARMANOS Browser в ответ приходит точка отладки, принадлежащая только этому профилю. Chromium берёт свободный порт на петле и записывает его в каталог профиля, а программа отдаёт вам этот адрес, если успела прочитать его за 4,5 секунды.

Открытый порт отладки обычно ставит navigator.webdriver в true, а это объявляет автоматизацию первой строкой большинства проверок. У вас значение остаётся ложным, и убедиться в этом можно на живой странице в самом движке.

На встроенном движке Electron порт отладки один на всю программу, поэтому ws приходит пустым.

1. 1

   Включите локальный API

   Раздел «Для программистов» в левом столбце, переключатель «Включить локальный API». «Токен доступа» лежит на том же экране.

2. 2

   Попросите профиль

   Запрос запуска с номером профиля и токеном.

3. 3

   Возьмите адрес ws

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

4. 4

   Подключитесь и работайте

   Отпечаток, куки, расширения и прокси уже на месте.

Попросите локальный API открыть профиль, возьмите из ответа адрес ws и отдайте его puppeteer.connect или Playwright через connect_over_cdp.

Оба клиента включают домены Runtime и Page при подключении, и Chromium ставит перехваты, которые страничный сценарий умеет заметить. Это свойство клиента, а не ARMANOS Browser.

Наш собственный исполнитель не включает домен Runtime. На время прогона он включает домен Page на вкладках прогона, чтобы ответить на alert или confirm страницы, и домен Network с первого шага ожидания запроса, а готовность опрашивается через document.readyState.

На экране «Сценарии» внутри программы девятнадцать видов шага, а повтор, ветвление и обход списка вкладываются до четырёх уровней. Переходы разрешены только по http, https и about:blank, и это проверяется при сохранении и при запуске.

В хранилище лежат клиент на Node и клиент на Python, причём питоновский обходится одной стандартной библиотекой.

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

В каждой ошибке лежат состояние HTTP и типовой код, поэтому обрыв связи и отвергнутый ключ различаются. Оба клиента проверяют подпись доставки и отвергают всё старше 300 секунд.

Сервер MCP это один файл на Node без зависимостей, и запускает его ваш клиент, а не программа. Он говорит по JSON-RPC 2.0 через stdin и stdout, а две переменные среды указывают ему на локальный API.

Инструментов десять, и каждый отображён на один ход, который у локального API есть на самом деле.

• get_status

  Отвечает ли локальный API и версия программы.

• list_profiles

  Все профили или страница по отбору, без заметок.

• get_active_profiles

  Номера открытых прямо сейчас.

• launch_profile

  Открывает профиль, отдаёт порт отладки.

• stop_profile

  Закрывает все окна профиля.

• create_profile

  Заводит профиль с группой и прокси.

• update_profile

  Меняет только присланные поля, в том числе ручные значения отпечатка, вход сайта и ключ 2FA, без заметок в ответе.

• delete_profile

  Переносит профиль в корзину.

• get_one_time_code

  Текущий код второго фактора.

• list_proxies

  Библиотека прокси, без паролей.

Ключ это дверь в учётную запись без пароля, поэтому тайную часть показывают один раз, а сервер держит только её свёртку и десять первых знаков.

Права проверяются на каждом ходе, и по умолчанию закрыто всё. Ход, не объявивший права, ключу недоступен вовсе, а открытых ключам ходов сегодня 18.

Ключи живут на платных тарифах, и тариф читается при каждом запросе. Подписки идут в обратную сторону, и заводит их только человек, вошедший с паролем.

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

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

Отправка устроена осторожно: десять секунд на попытку, три попытки, без перенаправлений, повтор только на 5xx и 429. Пятнадцать отказов подряд выключают подписку с записанной причиной.

Один предел накрывает весь серверный API: 300 запросов за 60 секунд, а вход и работа с паролем стянуты до тридцати в минуту.

Предела по тарифу нет. Тариф решает, сколько у вас профилей, машин и мест, а не с какой скоростью вам звонить.

Описание сервера собрано из тех же ходов, что и отвечают на запросы, поэтому пообещать несуществующий ход оно не может. Права у каждого хода в нём те же, что сервер и требует.