Escribe una palabra: el nombre de un botón, un ajuste o un error.
DocumentaciónAutomatización
Última comprobación con el contrato: septiembre de 2026
Publicada, y ya en la compilación que puedes descargar hoy, tanto en macOS como en Windows. El interruptor está en los ajustes de la app y la API permanece apagada hasta que la enciendes. A qué llamadas responde esa compilación se indica en cada operación y en cada ejemplo de abajo, en lugar de escribirlo aquí en una frase que la siguiente versión dejaría falsa.
Un script en el mismo ordenador convierte el navegador de un perfil en algo que puede manejar. La interfaz es un servicio, una clave y un archivo de dirección —descritos primero, porque todo se apoya en ellos— y un puñado de rutas por encima: encontrar un perfil, abrirlo, conectar Puppeteer, Playwright o Selenium a la dirección con la que responde y volver a cerrarlo.
La interfaz de la app está solo en inglés y en ruso. Los botones y ajustes se nombran aquí como los muestra la interfaz en inglés.
Apagada por defecto y accesible solo desde este ordenador.
Settings → API & Automation y activa Local API. Hasta que lo hagas, nada escucha: el puerto no está abierto y un script recibe una conexión rechazada, no una respuesta vacía.127.0.0.1 y en ningún otro sitio. Otro equipo de tu red no puede alcanzarlo y no hay ningún ajuste que lo abra: un script se ejecuta junto a Liminal, no contra él a través de la red.48361, un puerto propio de Liminal para no chocar con otro navegador que ya esté escuchando en el ordenador. Escribe otro distinto o pulsa Random free port y deja que la app elija. El cambio se aplica al instante, sin reiniciar Liminal.port_in_use. Nada escucha hasta que eliges otro puerto, así que un script que lee el archivo distingue «apagada» de «no pudo arrancar».Una sola clave, mostrada una vez y guardada donde tu sistema operativo guarda los secretos.
64 caracteres hexadecimales en minúscula y se muestra una sola vez. Si sales de la pantalla, queda oculta: la app no puede volver a mostrarla, solo emitir una nueva.Authorization: Bearer seguido de la propia clave. No hay parámetro de consulta ni cookie, y una petición sin la cabecera se rechaza igual que una con una clave incorrecta.La app escribe su dirección en un archivo, para que no haya que teclear nada dos veces.
Local API/status.json dentro del directorio de datos de usuario de Liminal. Léelo en lugar de fijar un puerto en el código: sigue al puerto que tú pones y al que eligió Random free port.enabled, status, address, port— y ningún secreto de ningún tipo.{"enabled":true,"status":"running","address":"http://127.0.0.1:48361","port":48361}off, con la dirección vacía y sin puerto. La misma forma, otro estado: un script lee un solo archivo para saberlo todo.{"enabled":false,"status":"off","address":"","port":0}La llamada por la que empezar: si Liminal está en marcha y si alguien ha iniciado sesión.
/v1/status en la dirección del archivo, con la clave en la cabecera.curl -H 'Authorization: Bearer <key>' http://127.0.0.1:48361/v1/status200, con la versión de la compilación en marcha y si alguien ha iniciado sesión en la app. Un signedIn falso no es un error: la API responde; son las operaciones que leen el catálogo o abren un perfil las que necesitan una cuenta.{"status":"running","version":"<version>","signedIn":true}401 y el código invalid_key: es permanente y es por lo que conviene ramificar. El mensaje que lo acompaña es la redacción de la app para una persona que lee un registro; trátalo como texto que puede cambiar, no como parte del contrato.{"error":{"code":"invalid_key","message":"Неверный ключ"}}127.0.0.1 y el puerto del archivo. Una petición que llega nombrando cualquier otro host no recibe respuesta, aunque alcance el mismo puerto: el servicio solo contesta a su propia dirección.off.Dicho sin rodeos, para que nada aquí se lea como una promesa que no es.
Para qué sirve cada ruta, qué recibe, qué responde y cada rechazo que puede dar. La insignia junto a una operación indica si la compilación que puedes descargar hoy la responde.
Si Liminal está en marcha y si alguien ha iniciado sesión
La llamada más barata que existe y la que conviene repetir mientras esperas a la app. Responde sin cuenta: un signedIn falso es un estado, no un error.
Ninguno.
{
"status": "running",
"version": "<version>",
"signedIn": true
}Los perfiles del catálogo, filtrados y paginados
Lee el mismo catálogo que muestra la app. Los filtros se combinan y todos son exactos salvo name, que coincide con cualquier perfil cuyo nombre contenga lo que escribiste, sin distinguir mayúsculas.
{
"page": 1,
"pageSize": 100,
"total": 1,
"items": [
"<profile>"
]
}Un perfil, con su proxy y su huella
El mismo objeto que devuelve la lista, para un solo identificador. La dirección del proxy se muestra; su contraseña, nunca.
{
"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"
}Abrir un perfil y obtener la dirección a la que se conecta un driver
Inicia el perfil como lo hace la app —su huella, su proxy, sus cookies— y responde con la dirección CDP cuando el navegador está listo. La llamada espera; no devuelve una tarea que haya que consultar.
{
"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"
}detail seguro nombra la etapa cuando la app puede decirla.Obtener una dirección de driver para un perfil que ya está abierto
Para un perfil que abriste a mano y ahora quieres manejar. No reinicia nada: la sesión, sus pestañas y sus cookies se quedan como están.
{
"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"
}detail seguro nombra la etapa cuando la app puede decirla.Cerrar un perfil como lo haría su ventana
Deja que la sesión termine de escribir su estado. Es la llamada que conviene hacer entre ejecuciones automatizadas sobre el mismo perfil.
{
"id": "<profile-id>",
"status": "closed"
}Cerrar un perfil que no se cierra
La misma respuesta, sin esperar a que la sesión se asiente. Recurre a ella cuando una parada no ha vuelto, no por costumbre.
{
"id": "<profile-id>",
"status": "closed"
}Qué está abierto ahora mismo y qué se puede manejar
Cada perfil que está abierto, lo haya abierto una ventana o una llamada —startedBy dice cuál—, con su dirección de driver cuando hay una disponible. Reconéctate desde aquí después de que tu script se reinicie.
Ninguno.
{
"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"
}
]
}Cada bloque está completo: lee el archivo de dirección, llama a la API y conecta el driver. Copia uno, pon el nombre de tu propio perfil y funciona. La insignia indica si la compilación que puedes descargar hoy responde a todo lo que ese bloque necesita.
Se conecta por CDP a la dirección con la que respondió el inicio, igual que un script de Puppeteer llega a un navegador que ya está en marcha.
Llama a /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()
La misma conexión mediante la entrada CDP de Playwright, al contexto que el perfil ya tiene y no a uno nuevo.
Llama a /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()
El lado Python de lo mismo: lee el archivo de dirección sin nada ajeno a la biblioteca estándar.
Llama a /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 se acopla a un navegador que ya está en marcha, por la dirección del depurador, y toma el chromedriver al que apunta la respuesta: no se descarga nada ni se adivina nada.
Llama a /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()
Lo mismo para Node: tanto la dirección del depurador como la ruta a un chromedriver compatible salen de la respuesta del inicio.
Llama a /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()
El mismo contrato como archivo, en una dirección que no cambia: OpenAPI, en JSON, generado a partir de los datos que muestra esta página. Impórtalo en Postman o Insomnia, o genera un cliente a partir de él. Cada operación lleva en él la misma disponibilidad que la insignia de arriba.
openapi.jsonLa versión que la estrenó, y cada versión que la amplía, están en las novedades. Una pregunta sobre el contrato, o un valor de aquí que no coincide con lo que hace tu compilación: [email protected].