# RPA для браузера

RPA для браузера автоматизирует повторяющиеся задачи в локальном профиле браузера Chromium: открывает страницы, работает с элементами, считывает результаты и управляет ходом выполнения с помощью условий и циклов. Вы собираете сценарий в виде шаблона, сохраняете его в своём аккаунте MoreLogin и запускаете в профиле браузера: в настольном клиенте или через Local API RPA для браузера.

Этот раздел предназначен для разработчиков и AI-агентов, которые создают и запускают шаблоны программно. Чтобы автоматизировать облачные телефоны Android, см. раздел [RPA для облачных телефонов](/ru/rparobotic-process-automation/01-overview/01-rpa-introduction).

## Требования

- Запущен настольный клиент MoreLogin V2.73.0 или новее, и в нём выполнен вход в аккаунт. Шаблоны хранятся в этом аккаунте и отображаются в клиенте в разделе **Пользовательские шаблоны**.
- Local API доступен по адресу `http://127.0.0.1:<port>/api/rpa/browser/v1`. Используйте порт Local API, указанный в настройках клиента; по умолчанию это `40000`.
- Аутентификация работает так же, как и в остальном Local API. См. [Аутентификация](/ru/api-reference/getting-started/authentication).
- Для запусков нужен профиль браузера Chromium (`browserTypeId: 1`).
- `GET /capabilities` возвращает операции, лимиты и URL документации, доступные вашему клиенту и аккаунту. Проверьте этот ответ, прежде чем собирать шаблон.


## Основные понятия

| Понятие | Значение |
|  --- | --- |
| Шаблон | Сохранённый сценарий с названием, описанием и зависимостями от дочерних шаблонов. Каждое сохранение создаёт новую версию. |
| Сценарий | Упорядоченное дерево узлов шаблона. Сценарий начинается с одного узла `start` и заканчивается одним узлом `end`. |
| Узел | Один шаг, например открытие URL или нажатие на элемент. У каждого типа узла есть контракт, который определяет его входные и выходные данные. |
| Окружение | Профиль браузера, в котором выполняется запуск. В `environmentId` передаётся `envId` профиля из [Local API профилей браузера](/ru/api-reference/browser/local-api). |
| Запуск | Одно выполнение сохранённой версии шаблона в окружении. У запуска есть записи о выполнении узлов и артефакты. |
| Квитанция запроса | Сохранённый результат запроса на запись, отправленного с `Idempotency-Key`. По ней можно выяснить, что произошло после тайм-аута. |


## Чем этот API отличается от других эндпоинтов Local API

Эндпоинты RPA для браузера не используют формат `{code, msg, data}`, описанный в разделе [Общий формат ответа](/ru/api-reference/getting-started/response-format).

- Они возвращают реальные коды состояния HTTP, например 201, 202, 409, 412, 422, 429 и 503.
- Успешный ответ содержит тело `{data, meta}`, а ответ с ошибкой содержит тело `{error, meta}`. Коды ошибок представляют собой строки, например `RPA_VALIDATION_FAILED`; см. [Коды ошибок](/ru/browser-rpa/api/error-codes).
- Запросы на запись используют заголовки `Idempotency-Key`, `If-Match` и `X-RPA-Catalog-Revision`. См. [Обязательные заголовки для запросов на запись](/ru/browser-rpa/local-api#%D0%BE%D0%B1%D1%8F%D0%B7%D0%B0%D1%82%D0%B5%D0%BB%D1%8C%D0%BD%D1%8B%D0%B5-%D0%B7%D0%B0%D0%B3%D0%BE%D0%BB%D0%BE%D0%B2%D0%BA%D0%B8-%D0%B4%D0%BB%D1%8F-%D0%B7%D0%B0%D0%BF%D1%80%D0%BE%D1%81%D0%BE%D0%B2-%D0%BD%D0%B0-%D0%B7%D0%B0%D0%BF%D0%B8%D1%81%D1%8C).
- Ошибки аутентификации возвращаются в стандартном для Local API формате 401.


## Начало работы

1. [Быстрый старт](/ru/browser-rpa/quickstart): запросите возможности и контракты узлов, затем проверьте и сохраните шаблон, который возвращает итоговый URL страницы.
2. [Запуск шаблона через API](/ru/browser-rpa/run-api-example): выполните предварительную проверку сохранённой версии, начните запуск и прочитайте результат.
3. [Общие поля и структура сценария](/ru/browser-rpa/node-contract-guide): изучите структуру сценария, ссылки, тайм-ауты и повторы.
4. [Каталог узлов](/ru/browser-rpa/nodes): найдите входные данные, значения по умолчанию, ссылки и выходные данные каждого узла.
5. [Справочник Local API](/ru/browser-rpa/local-api): найдите все эндпоинты, заголовки, которые нужны для записи, и способы восстановления после тайм-аутов и конфликтов версий.


Чтобы запустить шаблон вручную, см. [Запуск шаблона в настольном клиенте](/ru/browser-rpa/run).