Локальный API клиента запускает и останавливает профили из ваших скриптов. Профиль стартует со своим отпечатком, прокси и cookies, а в ответ вы получаете адрес для подключения Playwright или Puppeteer. Полный список методов — в документации API.
Выпустите ключ
Ключ выпускает сотрудник в «Настройки → API». У ключа задаются права, категории, срок и список IP. Ключ показывается один раз и хранится хешем, а прав у него не больше, чем у владельца.
Проверьте, что API отвечает
API работает только локально, на 127.0.0.1. Порт по умолчанию — 50380, его можно сменить в настройках.
curl http://127.0.0.1:50380/healthЗапустите профиль
Отправьте POST /v1/profiles/{id}/start с ключом в заголовке Authorization. В ответе — protocol и wsEndpoint: cdp для Chromium, juggler для Firefox, adb для Android.
curl -X POST \ -H "Authorization: Bearer $INO_API_KEY" \ http://127.0.0.1:50380/v1/profiles/$ID/start
Подключите Playwright
Профиль Chromium подключается через chromium.connectOverCDP, профиль Firefox — через firefox.connect. Первый контекст браузера — это контекст профиля с его cookies и вкладками.
import { firefox, chromium } from 'playwright'; const api = 'http://127.0.0.1:50380';const headers = { Authorization: 'Bearer ' + process.env.INO_API_KEY };const id = process.env.PROFILE_ID; const res = await fetch(api + `/v1/profiles/${id}/start`, { method: 'POST', headers,});const { protocol, wsEndpoint } = await res.json();const browser = protocol === 'cdp' ? await chromium.connectOverCDP(wsEndpoint) : await firefox.connect(wsEndpoint); const context = browser.contexts()[0];const page = await context.newPage();await page.goto('https://pixelscan.net');
Puppeteer подключается к профилям Chromium так же — puppeteer.connect({ browserWSEndpoint: wsEndpoint }).
Остановите профиль
Когда скрипт закончил, вызовите POST /v1/profiles/{id}/stop. Изменения папки профиля загрузятся на сервер, и профиль освободится для коллег.
Лимиты и безопасность
- По умолчанию — до 5 одновременных запусков по API, лимит настраивается.
- Все вызовы пишутся в журнал.
- Перевыпуск ключа оставляет старый рабочим 24 часа, отзыв действует сразу.
- Наш Chromium автоматизируется без следов CDP: изолированный мир без
Runtime.enableи запуск без флагов Playwright, которые отключают разделение хранилища.