У каждого MCP-инструмента есть одноимённый метод API: profiles_list → profiles.list, page_click_at → page.clickAt. Параметры у них одинаковые.
Во всех инструментах для страниц передавайте profileId. Без него действие уйдёт в профиль, который сейчас открыт у человека, а он может переключиться в любой момент.
| Инструмент |
Что делает |
Главные параметры |
app_status |
Состояние приложения: версия, режим профилей, активная группа, остановлен ли агент. Вызывайте первым. |
— |
| Инструмент |
Что делает |
Главные параметры |
profiles_list |
Профили открытой группы: profileId, имя, адрес, язык, часовой пояс, прокси (без пароля). |
— |
profiles_get |
Один профиль целиком, включая revision для безопасного обновления. |
profileId |
profiles_create |
Создать профиль. Отпечаток приходит с сервиса Accovod, как при создании вручную. |
idempotencyKey, name, url, locale, timezone, browser, proxy |
profiles_create_many |
Создать от 1 до 20 профилей за раз, у каждого свой отпечаток. |
idempotencyKey, count, name (префикс), proxies (по одному на профиль) |
profiles_update |
Изменить имя, заметку, адрес, язык, часовой пояс, User-Agent, прокси. Меняется только переданное. |
profileId, expectedRevision |
profiles_check_proxy |
Реальный запрос через прокси: доступность, IP, страна, город, часовой пояс и совпадает ли он с профилем. |
profileId |
profiles_open |
Переключить приложение на профиль и дождаться готовности. Меняет то, что видит человек. |
profileId |
profiles_reload |
Пересоздать вкладку профиля: применяет изменения прокси и режима защиты. |
profileId (без него — вся группа) |
profiles_delete |
Удалить профиль навсегда, вместе с cookies. |
profileId, confirm: true |
| Инструмент |
Что делает |
Главные параметры |
profiles_import_cookies |
Импорт cookies: массив из Cookie-Editor, Playwright storageState и т. п. По умолчанию добавляет к существующим. |
profileId, cookies, replace |
profiles_export_cookies |
Выгрузить все cookies профиля. Только по явной просьбе человека. |
profileId |
profiles_export_many |
Выгрузить профили в текстовый формат окна «Группы». Содержит пароли прокси и cookies. |
profileIds |
profiles_import_many |
Загрузить от 1 до 100 профилей из такого файла, с новыми отпечатками. |
content, idempotencyKey |
В API группы называются sessions.
| Инструмент |
Что делает |
Главные параметры |
sessions_list |
Все группы аккаунта: локальные и облачные. |
— |
sessions_open |
Открыть другую группу. Все profileId прежней группы станут недействительны. |
sessionId |
sessions_create |
Создать группу и сразу открыть её. |
name, kind (local / cloud) |
sessions_rename |
Переименовать любую группу. |
sessionId, name |
sessions_delete |
Удалить группу со всеми профилями. Нельзя удалить открытую или последнюю. |
sessionId, confirm: true |
| Инструмент |
Что делает |
Главные параметры |
settings_get |
Общие настройки: режим защиты, режим профилей, блокировка картинок, звук. |
— |
settings_set |
Изменить режим защиты или режим профилей. Все профили перестроятся. |
fingerprintProtect (more_privacy / more_native), profileMode (all / activeOnly) |
| Инструмент |
Что делает |
Главные параметры |
page_navigate |
Открыть адрес и дождаться загрузки. В режиме all работает в фоне, не трогая экран. |
url, profileId |
page_reload |
Перезагрузить страницу. |
profileId, ignoreCache |
page_snapshot |
Список интерактивных элементов с готовыми target. Главный способ «увидеть» страницу. |
profileId, maxElements |
page_get_text |
Текст страницы или элемента. Гораздо дешевле снимка. |
profileId, target |
page_screenshot |
Скриншот страницы или элемента — картинкой. |
profileId, target |
page_click |
Настоящий клик по элементу. Если элемент перекрыт, ничего не нажимает и сообщает чем. |
target, profileId |
page_click_at |
Клик по точке — для того, чего нет в снимке: кнопки в чужих iframe, canvas, карты. |
x, y, screenshotWidth |
page_fill |
Ввести текст в поле. |
target, text, clear, mode |
page_select |
Выбрать вариант в <select>. |
target, value / values |
page_hover |
Навести курсор, например, чтобы открыть меню. |
target |
page_key |
Нажать клавишу: Enter, Tab, Escape, стрелки. |
key, target |
page_scroll |
Прокрутить на deltaY пикселей, к верху или низу, либо к элементу. |
deltaY, to, target |
page_upload |
Положить файл в поле загрузки без системного диалога. До 10 файлов. |
target, paths |
page_wait_for |
Ждать текст, адрес, элемент или завершение перехода. |
text / url / target / navigation |
page_eval |
Выполнить JavaScript в контексте страницы. |
expression |
page_upload без дополнительной настройки берёт файлы из папок «Загрузки», «Рабочий стол», «Документы», «Изображения», «Фильмы» и «Музыка».
| Инструмент |
Что делает |
Главные параметры |
request_human |
Показать человеку панель с просьбой — решить капчу, ввести код из SMS, подтвердить вход — и ждать ответа Done или Can’t do it. |
reason, profileId, untilText / untilUrl |
Запрос живёт дольше одного вызова: если человек не успел, агент получает pending и вызывает инструмент снова с тем же requestId.
| Инструмент |
Что делает |
operations_start |
Запустить любой метод как фоновую операцию со своим operationId. |
operations_get |
Узнать статус и результат операции. |
operations_cancel |
Попросить отменить операцию. |
Это нужно, когда клиент обрывает долгие вызовы по таймауту: результат не теряется, его можно забрать позже.
