Импорт и экспорт куки

Куки хранят состояние авторизации на сайтах, которые вы открываете в профиле. Santiago позволяет сохранить куки профиля в JSON-файл и позже загрузить их обратно — это удобно, когда нужно перенести сессию между профилями, сделать резервную копию или восстановить вход без повторного ввода пароля.

Что вы можете делать

Действие	Что происходит
Экспорт	Скачивает все текущие куки профиля в виде файла .json, который остаётся на вашем компьютере.
Импорт	Открывает выбор файла и добавляет куки из JSON-файла в профиль.

Куки привязаны к профилю

У каждого профиля свои куки — так же, как свой отпечаток и прокси. Экспорт и импорт всегда работают с одним профилем за раз: между профилями ничего не передаётся, пока вы сами не перенесёте файл.

Профиль должен быть запущен

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

Экспорт куки профиля

Используйте экспорт, чтобы сохранить снимок сессии профиля — например, перед очисткой или чтобы скопировать вход в другой профиль.

1. Запустите профиль, из которого хотите экспортировать.
2. Выберите Export cookies в меню профиля.
3. Santiago скачает файл .json со всеми куки, которые сейчас хранятся в этом профиле.

Храните файл в надёжном месте. JSON содержит токены сессий, поэтому относитесь к нему как к паролю.

Относитесь к файлу как к учётным данным

Экспорт куки может содержать активные сессии входа. Любой, у кого есть этот файл, потенциально может воспользоваться этими сессиями. Храните его безопасно и не делитесь им.

Импорт куки из файла

Импорт позволяет загрузить куки из JSON-файла обратно в профиль.

1. Запустите профиль, в который хотите импортировать.
2. Выберите Import cookies в меню профиля.
3. Выберите ваш файл .json в окне выбора файла.
4. Santiago прочитает файл и добавит куки в профиль.

Что на самом деле делает импорт

• Импорт добавляет куки — он вставляет каждую куку из файла в профиль, по одной.
• Он не очищает существующие куки профиля заранее. Новые куки добавляются поверх того, что уже есть. Если кука с тем же именем, доменом и путём уже существует, импортированное значение заменяет её.
• Файл должен быть JSON-массивом куки — той же структуры, что вы получаете при экспорте. Экспорт из одного профиля и импорт в другой — самый надёжный способ перенести сессию.

Перенос между профилями

Самый чистый способ скопировать вход — экспортировать из исходного профиля и импортировать этот же файл в целевой профиль. Поскольку формат импорта совпадает с форматом экспорта, ничего не теряется при переносе.

Требования и ограничения

• Профиль должен быть запущен. И экспорт, и импорт работают с живой браузерной сессией, поэтому запустите профиль перед использованием любого из них.
• Для импорта нужна активная подписка. Импорт куки — одно из действий, ограниченных вашим тарифом, наряду с запуском и созданием профилей. Если ваша подписка истекла или вы ещё не выбрали тариф, импорт недоступен, пока у вас не будет активного тарифа. См. Тарифы и цены и Состояния лицензии.
• Экспорт работает даже после истечения подписки — вы всегда можете вытащить свои куки обратно, так что никогда не потеряете доступ к сохранённым сессиям.

Автоматизируйте это (для агентов и разработчиков)

Всё описанное выше также доступно через локальный API Santiago по адресу http://localhost:7891, так что агенты и скрипты могут читать и записывать куки профиля без кликов по приложению. Это тот же API, который использует навык агента.

Эндпоинты для куки находятся в API профиля и работают, пока профиль запущен:

Export, import, and clear cookies

# Export all cookies as JSON
curl -s localhost:7891/api/profiles/$PROFILE/cookies | jq .data

# Import cookies from JSON (adds them, does not clear first)
curl -s localhost:7891/api/profiles/$PROFILE/cookies -X POST \
  -H 'Content-Type: application/json' -d '[{...}, {...}]'

# Clear all cookies
curl -s localhost:7891/api/profiles/$PROFILE/cookies -X DELETE

# Clear by filter (any combo of name / domain / path) — exact match
curl -s "localhost:7891/api/profiles/$PROFILE/cookies?domain=.example.com" -X DELETE

Каждый ответ использует стандартную обёртку: { "ok": true, "data": {...} } при успехе или { "ok": false, "error": { "code", "message" } } при ошибке.

Заметка

Фильтры на эндпоинте очистки работают по точному совпадению, а не по подстроке. Многие куки задают свой domain с ведущей точкой (например, .example.com), чтобы охватить поддомены — добавьте точку, чтобы они совпали. Сначала проверьте реальные домены через эндпоинт экспорта или опустите фильтр, чтобы очистить всё.

Полный набор возможностей автоматизации — навигация, формы, скриншоты и остальное — смотрите в руководстве по HTTP API и справочнике API.

Связанные страницы

• Синхронизация сессий — как Santiago автоматически сохраняет и восстанавливает куки и вкладки между запусками и устройствами.
• Обзор профилей — что такое профиль и что в нём хранится.
• Обзор автоматизации — управляйте профилями через локальный API или навык агента.