База знаний

Подключить скрипт или ИИ-помощника

Этот экран даёт программе на вашем компьютере управлять ARMANOS: получать список профилей, открывать и закрывать их, заводить новые и запускать сценарии. Локальный API выключен, пока вы сами его не включите, и если вы не пишете скрипты и не подключаете ИИ-помощника, этот экран вам не нужен. Путь такой: «Для программистов» в левом столбце, затем «Включить локальный API».

Кому нужен этот экран

Он для тех, кто пишет скрипты или подключает к браузеру ИИ-помощника. Экран называется «Локальный API автоматизации», и под заголовком программа говорит то же самое простыми словами.

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

Как включить API

Выбор запоминается: API стартует вместе с программой, пока вы его не выключите.

1
Откройте «Для программистов»
Пункт под заголовком «Автоматизация» в левом столбце.
2
Нажмите на переключатель «Включить локальный API»
Переключатель вверху карточки.
3
Дождитесь надписи «Запущен»
Состояние справа от переключателя.
4
Скопируйте адрес и токен
Кнопки «Копировать» в строках «Адрес API» и «Токен доступа».

Когда обычный порт занят

Порт, на котором обычно работает API, может быть занят другой программой. Тогда API берёт свободный порт, экран называет оба, и адрес нужно поправить в ваших скриптах. Сервер MCP ищет новый порт сам.

Адрес и токен

API принимает запросы только с этого компьютера и отказывает запросам, пришедшим со страниц сайтов. Скрипт передаёт токен вместе с запросами: параметром token в адресе или заголовком x-api-token.

Кнопка «Обновить токен» выдаёт новый после подтверждения. Скрипты со старым токеном перестают работать, пока вы не вставите в них новый.

Что может скрипт

Список «Что можно вызвать» перечисляет запросы и для каждого одной строкой объясняет, что он делает. Скрипт может получить список профилей и узнать, какие из них запущены, открыть и закрыть профиль, завести новый, поправить профиль и переместить его в корзину.

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

Создание профиля принимает и поле geolocation с его местоположением, и поле webrtc с режимом WebRTC.

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

Профиль с паролем

Закрытый профиль отвечает profile_password_required, пока его не откроют. Пошлите пароль в теле browser/start или сперва откройте профиль ходом profile/unlock; keepUntilExit держит его открытым до закрытия ARMANOS.

Пароль в адресе отвергается ответом password_in_query, и попытка не тратится. Три неверных пароля подряд закрывают профиль на час: profile_password_wrong несёт attemptsLeft, profile_password_blocked несёт until.

flow/run запускает открытые профили и перечисляет закрытые в data.refused. Инструмент MCP launch_profile тоже принимает пароль.

POST /api/v1/browser/start: {"profileId": "…", "password": "…"}
POST /api/v1/profile/unlock: {"profileId": "…", "password": "…", "keepUntilExit": true}
POST /api/v1/profile/lock: {"profileId": "…"}
POST /api/v1/profile/password: {"profileId": "…", "password": "…", "currentPassword": "…"}
POST /api/v1/profile/password/remove: {"profileId": "…", "currentPassword": "…"}

Смена пароля требует текущего, даже с токеном. Сброс без старого пароля спрашивает пароль вашей учётной записи, поэтому его нет в местном API.

Сервер MCP

MCP это способ, которым ИИ-помощник вроде Claude Desktop вызывает внешние инструменты. Раздел «Сервер MCP» подключает его к ARMANOS через тот же локальный API, поэтому «Статус MCP» показывает «Готово», как только API запущен.

Через него помощник может получить список профилей и узнать, какие запущены, открыть, закрыть, завести и поправить профиль, переместить профиль в корзину, прочитать библиотеку прокси без паролей и взять код двухфакторной защиты профиля. Под заголовком «Что может ИИ-помощник» экран перечисляет эти инструменты, каждый своей строкой.

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

1
Включите локальный API
«Статус MCP» сменится на «Готово».
2
Нажмите «Копировать настройку»
Кнопка на блоке «Настройка клиента».
3
Вставьте её в настройки помощника
В Claude Desktop: «Настройки», затем «Разработчик», затем «Изменить конфигурацию».
4
Сохраните и перезапустите помощника
Он сам запустит сервер по пути из строки «Скрипт сервера».

Токен и ключи в личном кабинете

У токена доступа на этом экране нет отдельных прав: у кого он есть, тот может всё из списка выше, включая коды двухфакторной защиты. Храните его так же, как пароль.

Ключи с выбранными правами это другое. Их выдают на платном тарифе в личном кабинете на сайте, в разделе «Ключи API», и работают они с вашим аккаунтом на нашем сервере, а не с этим компьютером.

Чего это не делает

Это не принимает вызовы с других компьютеров. API принимает запросы только с этой машины.
Это не делит токен на права. Один токен открывает весь список.
Это не выдаёт пароли прокси. Список прокси приходит без них.
Это не запускает сценарии через сервер MCP. Помощник работает с профилями, а сценарии запускаются из скрипта или из окна.
Это не ставит Node.js. Серверу MCP он нужен на этом компьютере, а запускает сервер сам помощник.

Где это решается

У каждой строки ниже назван стенд, который её проверяет.

Страница сайта получает отказ даже с токеном, а скрипт без токена тоже получает отказ: apps/desktop/test/local-api-gate.js
Если программа стартовала с выключенным API, общий порт отладки не открывается ни при каком движке: apps/desktop/test/cdp-port-only-when-needed.js
Пример запроса с экрана выполняется в sh и в PowerShell, строки экрана MCP совпадают с инструментами сервера, а причина неподнятого API и просьба о перезапуске видны на экране: apps/desktop/test/движок-и-api-говорят-правду.js
Путь в строке «Скрипт сервера» остаётся прежним после перезапуска программы: apps/desktop/test/путь-mcp-переживает-перезапуск.js
Ключ с правом читать профили не запускает браузер: apps/server/test/api-keys.js

Вопросы

Мне нужен этот экран?: Нет, если вы не пишете скрипты и не подключаете ИИ-помощника. Остальная программа с выключенным API работает так же.
Переключатель включён, а состояние «Остановлен».: API не смог запуститься, и причина написана прямо под переключателем. Когда она устранена, выключите и снова включите переключатель.
Я обновил токен, и помощник перестал работать.: Токен лежит внутри настройки клиента. Снова нажмите «Копировать настройку», вставьте блок вместо старого и перезапустите помощника.
Может ли открытый мной сайт достучаться до API?: Запрос, пришедший со страницы сайта, получает отказ даже с верным токеном. Скрипты и помощник на этом компьютере не страницы сайта, поэтому с токеном они проходят.
Видит ли помощник мои пароли?: Пароли прокси не видит: список прокси приходит без них. А текущий код двухфакторной защиты у профиля с сохранённым ключом он прочитать может.
Как быстро попробовать?: Скопируйте запрос в блоке «Пример запроса» кнопкой «Копировать» рядом с ним и выполните его в терминале: на macOS и Linux в обычном, на Windows в PowerShell. Он запросит список ваших профилей, а адрес и токен в нём уже ваши.

Рядом с этим

Попробуйте на одном скрипте

Бесплатный тариф даёт два профиля, без срока и без карты.

Скачивание откроется при запуске База знаний