Огляд автоматизації

Santiago перетворює кожен профіль браузера на програмований, повністю підмінений браузер, яким можна керувати зі свого коду або передати AI-агенту. Ви звертаєтесь до єдиного локального HTTP API за адресою http://localhost:7891; демон запускає браузер Camoufox (на базі Firefox) для профілю та застосовує за вас усю підміну відбитка, проксі, часового поясу й WebRTC. Вам ніколи не доводиться збирати відбиток чи підключати проксі у коді автоматизації — ви посилаєтесь на профіль за ID і дієте всередині нього.

Що можна автоматизувати

Усе, що ви можете зробити вручну у вікні профілю, можна заскриптувати — на одному профілі або на сотнях, паралельно.

Сценарій	Як це виглядає
Заповнення форм	Перейдіть до форми, заповніть кожне поле, розберіться з випадайками, надішліть — усе через довірені, гуманізовані події. Див. Заповнення форм.
Витягування даних	Запустіть профіль, прочитайте DOM через `evaluate` і дістаньте потрібний текст або значення. Куки та вкладки синхронізуються назад при зупинці.
Керування кількома профілями	Запускайте багато ізольованих профілів одночасно — кожен зі своїм відбитком, проксі та сховищем кук — щоб виконувати одне завдання паралельно. Див. Кілька профілів.
Тривалі завдання	Передайте агенту тривалість і дайте йому працювати автономно з рандомізованим, людиноподібним темпом. Див. Автономні завдання.

Як усе поєднується

Santiago — це один десктопний застосунок із багаторівневою ієрархією процесів:

Electron tray app
  └─ local daemon  (Fastify HTTP server on http://localhost:7891)
       └─ Camoufox browser  (one process per running profile)

Electron-трей — десктопний застосунок, який ви встановлюєте та в який входите. Він володіє вашою ліцензією та запускає демон.
Локальний демон — HTTP-сервер на Fastify, що слухає на http://localhost:7891. Це єдиний публічний API Santiago. Він керує профілями, запускає браузери та надає ендпоінти автоматизації.
Camoufox — посилений браузер на базі Firefox, який запускається для кожного профілю з вбудованим відбитком цього профілю. Коли увімкнено humanize, демон автоматично додає рух курсора по кривій Безьє до кожної дії.

Ваш код або AI-агент перебуває поза цим стеком і звертається до демона звичайним HTTP:

your code / AI agent  ──HTTP──▶  daemon :7891  ──▶  Camoufox profile

Поверхня API

На :7891 є дві HTTP-поверхні, обидві під /api:

Поверхня	Базовий шлях	Призначення
Profile API	`http://localhost:7891/api/profiles`	Список, створення, оновлення, запуск, зупинка профілів; читання статусу; імпорт/експорт кук.
Automation API	`http://localhost:7891/api/automation/:profileId/<action>`	Керування запущеним профілем: навігація, знімок, клік, набір тексту, заповнення форм, скріншот, evaluate.

Кожна відповідь використовує однаковий конверт:

{ "ok": true, "data": { } }

{ "ok": false, "error": { "code": "PROFILE_NOT_RUNNING", "message": "..." } }

Мінімальний потік

Оберіть профіль, запустіть його та почніть ним керувати. Усе, що потрібно, — це ID профілю.

curl -s localhost:7891/api/profiles | jq '.data[] | {id, name, status}'

PROFILE=<profile-id>
curl -s localhost:7891/api/profiles/$PROFILE/launch -X POST

curl -s localhost:7891/api/automation/$PROFILE/navigate -X POST \
  -H 'Content-Type: application/json' -d '{"url":"https://example.com"}'

curl -s localhost:7891/api/automation/$PROFILE/snapshot -X POST | jq -r .data.snapshot

curl -s localhost:7891/api/profiles/$PROFILE/stop -X POST

Повний набір дій (click, type, fill-page, select-combobox, screenshot, evaluate, wait, batch та інші) задокументований у гайді з HTTP API та довіднику API.

Два способи керування

Ви можете звертатися до демона як завгодно — curl, fetch, Python-клієнт, будь-чим, що розмовляє HTTP. Є два поширені підходи:

Власний код — надсилайте HTTP-виклики напряму. Ендпоінти, корисні навантаження та форми відповідей описані в HTTP API та довіднику API.
AI-агент — встановіть навичку агента Santiago і дайте моделі самій вирішувати конкретні дії (на який елемент клікнути, що набрати, коли почекати). Навичка навчає агента ендпоінтам та правилам стелсу. Див. Встановлення навички агента.

curl -fsSL https://downloads.santiago-browser.com/skill/latest/santiago-browser-skill.tar.gz \
  -o santiago-browser-skill.tar.gz

Правила стелсу, важливі для автоматизації

Маскування лише настільки добре, наскільки добрі події, які ви генеруєте. Два правила переходять у все, що ви скриптуєте:

Статус профілю та паралельність

Профіль повідомляє один статус виконання; автоматизація працює лише з профілем у статусі running.

Статус	Значення
`idle`	Не запущено. Виклики автоматизації повертають `PROFILE_NOT_RUNNING`.
`launching`	Браузер запускається.
`running`	Готовий до керування через API автоматизації.
`stopping`	Браузер завершує роботу (синхронізує куки та вкладки).
`locked`	Профіль використовується на іншому пристрої — його не можна запустити тут, поки не звільниться.

Скільки профілів можна запускати одночасно, визначається вашим тарифом, і демон це контролює.

Тариф	Ціна	Профілі
Starter	$9/міс	3
Pro (найпопулярніший)	$59/міс	40
Agency	$149/міс	300 + команда до 10 учасників

Santiago — лише платний, безкоштовного пробного періоду немає. Запуск профілю вимагає активної ліцензії та вільного паралельного слота; перевищення кількості слотів повертає CONCURRENT_LIMIT_REACHED. Деталі див. у розділі Тарифи.

Куди далі

Встановлення навички агента — передайте локальний API AI-агенту.
Запуск профілів — запускайте, перевіряйте та зупиняйте профілі зі свого коду.
HTTP API — ендпоінти, корисні навантаження та форми відповідей.
Довідник API — кожна дія та її поля.
Найкращі практики — батчинг, темп, повтори та правила стелсу.
Гайди з автоматизації — наскрізні робочі процеси, що поєднують ендпоінти.