Сверено с контрактом: сентябрь 2026
Выпущен и есть в сборке, которую можно скачать сегодня, — и на macOS, и на Windows. Переключатель лежит в настройках приложения, и API остаётся выключенным, пока вы его не включите. На какие вызовы эта сборка отвечает, помечено у каждой операции и у каждого примера ниже, а не написано здесь фразой, которую следующий выпуск сделает неверной.
Скрипт на той же машине превращает браузер профиля в то, чем можно управлять. Интерфейс — это один сервис, один ключ и один файл адреса, описанные первыми, потому что всё стоит на них, и несколько путей поверх: найти профиль, открыть его, подключить Puppeteer, Playwright или Selenium к адресу из ответа, закрыть обратно.
По умолчанию выключен и доступен только с этого компьютера.
Settings → API & Automation и включите Local API. Пока он выключен, никто не слушает: порт не открыт, и скрипт получает отказ в соединении, а не пустой ответ.127.0.0.1 и больше нигде. Другая машина в вашей сети до него не доберётся, и настройки, которая это открыла бы, нет: скрипт работает рядом с Liminal, а не обращается к нему по сети.48361 — свой порт Liminal, чтобы не столкнуться с другим браузером, который уже слушает на этой машине. Впишите другой или нажмите Random free port, и приложение выберет само. Изменение действует сразу, без перезапуска Liminal.port_in_use. Никто не слушает, пока вы не выберете другой порт, — и скрипт, который читает файл, отличает «выключено» от «не удалось запустить».Один ключ, показан один раз, лежит там, где система хранит секреты.
64 строчных шестнадцатеричных символов и показывает его один раз. Уйдёте со страницы — он скрыт: показать его снова приложение не может, только выдать новый.Authorization: Bearer и сам ключ. Ни параметра в адресе, ни cookie для этого нет, а запрос без заголовка отклоняется так же, как запрос с неверным ключом.Приложение пишет свой адрес в файл, чтобы ничего не вводить дважды.
Local API/status.json внутри каталога данных Liminal. Читайте его вместо того, чтобы зашивать порт: он следует и за портом, который вы задали, и за тем, который выбрал Random free port.enabled, status, address, port — и никаких секретов.{"enabled":true,"status":"running","address":"http://127.0.0.1:48361","port":48361}off, пустой адрес и нулевой порт. Та же форма, другое состояние — скрипт читает один файл и узнаёт всё.{"enabled":false,"status":"off","address":"","port":0}Вызов, с которого стоит начать: работает ли Liminal и вошёл ли в него кто-нибудь.
/v1/status по адресу из файла, с ключом в заголовке.curl -H 'Authorization: Bearer <key>' http://127.0.0.1:48361/v1/status200, версия работающей сборки и признак того, вошёл ли кто-нибудь в приложение. Ложный signedIn — не ошибка: API отвечает, а аккаунт нужен тем операциям, которые читают каталог или открывают профиль.{"status":"running","version":"<version>","signedIn":true}401 и код invalid_key — он постоянный, и ветвиться нужно по нему. Текст рядом — слова приложения для человека, который читает лог; считайте его текстом, который может измениться, а не частью контракта.{"error":{"code":"invalid_key","message":"Неверный ключ"}}127.0.0.1 и порт из файла. Запрос, который пришёл с другим именем хоста, ответа не получит, даже если попал на тот же порт: сервис отвечает только на свой адрес.off.Прямо, чтобы ничего здесь не читалось как обещание, которым оно не является.
Для чего каждый путь, что он принимает, что отвечает и каким отказом может ответить. Значок рядом с операцией говорит, отвечает ли на неё сборка, которую можно скачать сегодня.
Работает ли Liminal и вошёл ли в него кто-нибудь
Самый дешёвый вызов и тот, которым стоит ждать приложение. Отвечает и без аккаунта: ложный signedIn — это состояние, а не ошибка.
Нет.
{
"status": "running",
"version": "<version>",
"signedIn": true
}Профили каталога, с фильтрами и по страницам
Читает тот же каталог, который показывает приложение. Фильтры складываются, и каждый из них точный, кроме name: он подходит любому профилю, в имени которого встречается введённое, без учёта регистра.
{
"page": 1,
"pageSize": 100,
"total": 1,
"items": [
"<profile>"
]
}Один профиль, с его прокси и отпечатком
Тот же объект, что возвращает список, но для одного идентификатора. Адрес прокси показан, пароль — никогда.
{
"id": "<profile-id>",
"name": "Shop EU",
"workspaceId": "<workspace-id>",
"folderId": "<folder-id>",
"status": "running",
"health": "ok",
"proxy": {
"id": "<proxy-id>",
"name": "Residential DE",
"type": "socks5",
"host": "proxy.example.net",
"port": 1080,
"working": true,
"lastCheckedExternalIp": "203.0.113.10",
"lastCheckedCountryCode": "DE"
},
"fingerprint": {
"platform": "MacIntel",
"language": "de-DE",
"timezone": "Europe/Berlin"
},
"lastOpenedAt": "2026-09-30T08:15:00.000Z"
}Открыть профиль и получить адрес, к которому подключается драйвер
Запускает профиль так же, как это делает приложение — его отпечаток, его прокси, его cookies — и отвечает CDP-адресом, когда браузер поднялся. Вызов ждёт, а не возвращает задачу, которую надо опрашивать.
{
"id": "<profile-id>",
"status": "running",
"cdpDiscoveryUrl": "http://127.0.0.1:48361/devtools/<token>/json/version",
"cdpBrowserUrl": "ws://127.0.0.1:9222/devtools/browser/<token>",
"seleniumDebuggerUrl": "127.0.0.1:9222",
"chromedriverPath": "/Applications/Liminal.app/.../chromedriver",
"debugPort": 9222,
"debugAddress": "127.0.0.1:9222",
"externalIp": "203.0.113.10",
"countryCode": "DE"
}Получить адрес драйвера для уже открытого профиля
Для профиля, который вы открыли руками и теперь хотите вести скриптом. Ничего не перезапускает: сессия, её вкладки и cookies остаются как есть.
{
"id": "<profile-id>",
"status": "running",
"cdpDiscoveryUrl": "http://127.0.0.1:48361/devtools/<token>/json/version",
"cdpBrowserUrl": "ws://127.0.0.1:9222/devtools/browser/<token>",
"seleniumDebuggerUrl": "127.0.0.1:9222",
"chromedriverPath": "/Applications/Liminal.app/.../chromedriver",
"debugPort": 9222,
"debugAddress": "127.0.0.1:9222",
"externalIp": "203.0.113.10",
"countryCode": "DE"
}Закрыть профиль так, как закрыло бы его окно
Даёт сессии дописать своё состояние. Это тот вызов, который стоит делать между прогонами скрипта на одном профиле.
{
"id": "<profile-id>",
"status": "closed"
}Закрыть профиль, который не закрывается
Тот же ответ, но без ожидания, пока сессия уляжется. Нужен, когда остановка не вернулась, а не по умолчанию.
{
"id": "<profile-id>",
"status": "closed"
}Что открыто прямо сейчас и чем можно управлять
Каждый открытый профиль — окно его открыло или вызов, об этом говорит startedBy — с адресом драйвера, когда он есть. Отсюда скрипт переподключается после своего перезапуска.
Нет.
{
"items": [
{
"id": "<profile-id>",
"workspaceId": "<workspace-id>",
"status": "running",
"automationAvailable": true,
"startedBy": "api",
"cdpBrowserUrl": "ws://127.0.0.1:9222/devtools/browser/<token>",
"seleniumDebuggerUrl": "127.0.0.1:9222",
"chromedriverPath": "/Applications/Liminal.app/.../chromedriver",
"debugPort": 9222,
"debugAddress": "127.0.0.1:9222"
}
]
}Каждый блок целый: читает файл адреса, вызывает API и подключает драйвер. Скопируйте один, впишите имя своего профиля — и он работает. Значок говорит, отвечает ли сборка, которую можно скачать сегодня, на всё, что нужно этому блоку.
Подключается по CDP к адресу из ответа на запуск. Самое близкое к скрипту, уже написанному под AdsPower или Octo.
Вызывает /v1/profiles · /v1/profiles/{id}/start
import { readFileSync } from 'node:fs'
import puppeteer from 'puppeteer-core'
// Local API/status.json, inside Liminal's user-data directory. The settings
// screen shows the absolute path; that path and the key are your script’s to
// keep — the app puts neither into the environment for you.
const { address } = JSON.parse(readFileSync(process.env.LIMINAL_ADDRESS_FILE, 'utf8'))
async function call(path, init) {
const response = await fetch(address + path, {
...init,
headers: { Authorization: `Bearer ${process.env.LIMINAL_API_KEY}` },
})
const body = await response.json()
if (!response.ok) throw new Error(body.error.code)
return body
}
const { items } = await call('/v1/profiles?name=' + encodeURIComponent('Shop EU'))
const started = await call(`/v1/profiles/${items[0].id}/start`, { method: 'POST' })
const browser = await puppeteer.connect({ browserWSEndpoint: started.cdpBrowserUrl })
const page = await browser.newPage()
await page.goto('https://example.com')
console.log(await page.title())
await browser.disconnect()
То же подключение через точку входа Playwright по CDP — и в контекст, который у профиля уже есть, а не в новый.
Вызывает /v1/profiles · /v1/profiles/{id}/start
import { readFileSync } from 'node:fs'
import { chromium } from 'playwright'
// Local API/status.json, inside Liminal's user-data directory. The settings
// screen shows the absolute path; that path and the key are your script’s to
// keep — the app puts neither into the environment for you.
const { address } = JSON.parse(readFileSync(process.env.LIMINAL_ADDRESS_FILE, 'utf8'))
async function call(path, init) {
const response = await fetch(address + path, {
...init,
headers: { Authorization: `Bearer ${process.env.LIMINAL_API_KEY}` },
})
const body = await response.json()
if (!response.ok) throw new Error(body.error.code)
return body
}
const { items } = await call('/v1/profiles?name=' + encodeURIComponent('Shop EU'))
const started = await call(`/v1/profiles/${items[0].id}/start`, { method: 'POST' })
const browser = await chromium.connectOverCDP(started.cdpBrowserUrl)
const page = await browser.contexts()[0].newPage()
await page.goto('https://example.com')
console.log(await page.title())
await browser.close()
Питоновская сторона того же самого: файл адреса читается без единой зависимости вне стандартной библиотеки.
Вызывает /v1/profiles · /v1/profiles/{id}/start
import json
import os
import urllib.parse
import urllib.request
from playwright.sync_api import sync_playwright
# Local API/status.json, inside Liminal's user-data directory. The settings
# screen shows the absolute path; that path and the key are your script’s to
# keep — the app puts neither into the environment for you.
with open(os.environ["LIMINAL_ADDRESS_FILE"], encoding="utf-8") as handle:
address = json.load(handle)["address"]
def call(path, method="GET"):
request = urllib.request.Request(address + path, method=method)
request.add_header("Authorization", "Bearer " + os.environ["LIMINAL_API_KEY"])
with urllib.request.urlopen(request) as response:
return json.load(response)
profile = call("/v1/profiles?name=" + urllib.parse.quote("Shop EU"))["items"][0]
started = call(f"/v1/profiles/{profile['id']}/start", method="POST")
with sync_playwright() as playwright:
browser = playwright.chromium.connect_over_cdp(started["cdpBrowserUrl"])
page = browser.contexts[0].new_page()
page.goto("https://example.com")
print(page.title())
Selenium присоединяется к уже запущенному браузеру по адресу отладчика и берёт chromedriver, на который указывает ответ, — ничего не скачивается и не угадывается.
Вызывает /v1/profiles · /v1/profiles/{id}/start
import json
import os
import urllib.parse
import urllib.request
from selenium import webdriver
from selenium.webdriver.chrome.service import Service
# Local API/status.json, inside Liminal's user-data directory. The settings
# screen shows the absolute path; that path and the key are your script’s to
# keep — the app puts neither into the environment for you.
with open(os.environ["LIMINAL_ADDRESS_FILE"], encoding="utf-8") as handle:
address = json.load(handle)["address"]
def call(path, method="GET"):
request = urllib.request.Request(address + path, method=method)
request.add_header("Authorization", "Bearer " + os.environ["LIMINAL_API_KEY"])
with urllib.request.urlopen(request) as response:
return json.load(response)
profile = call("/v1/profiles?name=" + urllib.parse.quote("Shop EU"))["items"][0]
started = call(f"/v1/profiles/{profile['id']}/start", method="POST")
options = webdriver.ChromeOptions()
options.debugger_address = started["seleniumDebuggerUrl"]
driver = webdriver.Chrome(service=Service(started["chromedriverPath"]), options=options)
driver.get("https://example.com")
print(driver.title)
driver.quit()
То же для Node: и адрес отладчика, и путь к подходящему chromedriver приходят из ответа на запуск.
Вызывает /v1/profiles · /v1/profiles/{id}/start
import { readFileSync } from 'node:fs'
import { Builder } from 'selenium-webdriver'
import chrome from 'selenium-webdriver/chrome.js'
// Local API/status.json, inside Liminal's user-data directory. The settings
// screen shows the absolute path; that path and the key are your script’s to
// keep — the app puts neither into the environment for you.
const { address } = JSON.parse(readFileSync(process.env.LIMINAL_ADDRESS_FILE, 'utf8'))
async function call(path, init) {
const response = await fetch(address + path, {
...init,
headers: { Authorization: `Bearer ${process.env.LIMINAL_API_KEY}` },
})
const body = await response.json()
if (!response.ok) throw new Error(body.error.code)
return body
}
const { items } = await call('/v1/profiles?name=' + encodeURIComponent('Shop EU'))
const started = await call(`/v1/profiles/${items[0].id}/start`, { method: 'POST' })
const driver = await new Builder()
.forBrowser('chrome')
.setChromeOptions(new chrome.Options().debuggerAddress(started.seleniumDebuggerUrl))
.setChromeService(new chrome.ServiceBuilder(started.chromedriverPath))
.build()
await driver.get('https://example.com')
console.log(await driver.getTitle())
await driver.quit()
Тот же контракт файлом, по одному адресу, который не меняется: OpenAPI в JSON, собранный из тех же данных, что рисует эта страница. Импортируйте его в Postman или Insomnia или соберите по нему клиент. У каждой операции в нём стоит та же доступность, что и значок выше.
openapi.jsonВыпуск, который его привёз, и каждый следующий, который его расширит, — в списке изменений. Вопрос о контракте или значение, которое не совпало с тем, что делает ваша сборка: [email protected].