Гайды

Локальный API: запуск профилей из Playwright

API-ключ, запуск профиля на 127.0.0.1 и подключение Playwright по CDP или Juggler. С примерами кода.

Команда inoBrowser3 мин чтения
Содержание
  1. Выпустите ключ
  2. Проверьте, что API отвечает
  3. Запустите профиль
  4. Подключите Playwright
  5. Остановите профиль
  6. Лимиты и безопасность

Локальный 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 и вкладками.

Node.js
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, которые отключают разделение хранилища.

Читайте также

Все статьи

Попробуйте на 3 профилях бесплатно

© 2026 inoBrowserinobrowser.run