Nhập một từ: tên nút, một cài đặt hoặc một lỗi.
Tài liệuTự động hóa
Đối chiếu lần cuối với đặc tả: tháng 9 năm 2026
Đã phát hành, và có sẵn trong bản dựng bạn tải về được hôm nay — trên cả macOS lẫn Windows. Công tắc nằm trong phần cài đặt của ứng dụng và API vẫn tắt cho đến khi bạn bật nó. Bản dựng đó trả lời những lệnh gọi nào thì được đánh dấu ở từng thao tác và từng ví dụ bên dưới, chứ không viết thành một câu ở đây để rồi bản phát hành sau làm nó sai đi.
Một script trên cùng máy biến trình duyệt của một hồ sơ thành thứ nó có thể điều khiển. Giao diện này gồm một dịch vụ, một khóa và một tệp địa chỉ — được mô tả trước tiên, vì mọi thứ đều dựa trên chúng — cùng một vài tuyến bên trên: tìm một hồ sơ, mở nó, kết nối Puppeteer, Playwright hoặc Selenium tới địa chỉ nó trả về, rồi đóng lại.
Giao diện ứng dụng hiện chỉ có tiếng Anh và tiếng Nga. Tên nút và cài đặt trên trang này được ghi đúng như giao diện tiếng Anh hiển thị.
Mặc định tắt, và chỉ truy cập được từ chính máy tính này.
Settings → API & Automation và bật Local API. Chừng nào bạn chưa bật thì không có gì lắng nghe: cổng không được mở, và script nhận về một kết nối bị từ chối chứ không phải một phản hồi rỗng.127.0.0.1, không ở đâu khác. Máy khác trong mạng của bạn không thể chạm tới nó, và không có cài đặt nào mở nó ra — script chạy bên cạnh Liminal, chứ không gọi tới nó qua mạng.48361, một cổng riêng của Liminal để không đụng với trình duyệt khác đang lắng nghe trên máy. Hãy nhập một cổng khác, hoặc nhấn Random free port và để ứng dụng tự chọn. Thay đổi có hiệu lực ngay, không cần khởi động lại Liminal.port_in_use. Không có gì lắng nghe cho đến khi bạn chọn cổng khác, nên script đọc tệp sẽ phân biệt được “đang tắt” với “không khởi động được”.Một khóa, chỉ hiện một lần, được cất ở nơi hệ điều hành của bạn cất các bí mật.
64 ký tự thập lục phân viết thường và chỉ hiện nó một lần. Rời màn hình là nó bị ẩn: ứng dụng không thể hiện lại, chỉ có thể cấp khóa mới.Authorization: Bearer, theo sau là chính khóa đó. Không có tham số truy vấn và không có cookie, và yêu cầu thiếu header bị từ chối giống như yêu cầu mang khóa sai.Ứng dụng ghi địa chỉ của mình vào một tệp, để không phải nhập thứ gì hai lần.
Local API/status.json bên trong thư mục dữ liệu người dùng của Liminal. Hãy đọc tệp thay vì viết cứng một cổng: nó đi theo cổng bạn đặt lẫn cổng mà Random free port đã chọn.enabled, status, address, port — và không có bí mật nào.{"enabled":true,"status":"running","address":"http://127.0.0.1:48361","port":48361}off, địa chỉ rỗng và không có cổng. Cùng một hình dạng, khác trạng thái — script chỉ cần đọc một tệp là biết hết.{"enabled":false,"status":"off","address":"","port":0}Lệnh gọi nên bắt đầu trước tiên: Liminal có đang chạy không, và đã có ai đăng nhập chưa.
/v1/status tại địa chỉ lấy từ tệp, kèm khóa trong header.curl -H 'Authorization: Bearer <key>' http://127.0.0.1:48361/v1/status200, kèm phiên bản của bản dựng đang chạy và việc ứng dụng đã có người đăng nhập hay chưa. signedIn bằng false không phải là lỗi — API vẫn trả lời; chính các thao tác đọc danh mục hoặc mở hồ sơ mới cần tài khoản.{"status":"running","version":"<version>","signedIn":true}401 và mã invalid_key — mã này cố định, và là thứ để rẽ nhánh xử lý. Thông báo đi kèm là lời của chính ứng dụng dành cho người đọc nhật ký; hãy coi nó là văn bản có thể thay đổi, không phải một phần của đặc tả.{"error":{"code":"invalid_key","message":"Неверный ключ"}}127.0.0.1 và cổng lấy từ tệp. Yêu cầu tới với tên host khác sẽ không được trả lời, kể cả khi nó tới đúng cổng đó — dịch vụ chỉ trả lời cho địa chỉ của chính nó.off.Nói thẳng, để không điều gì ở đây bị đọc thành một lời hứa mà nó không phải.
Mỗi tuyến dùng để làm gì, nhận gì, trả lời gì và mọi lời từ chối nó có thể đưa ra. Nhãn cạnh một thao tác cho biết bản dựng bạn tải về được hôm nay có trả lời nó hay không.
Liminal có đang chạy không, và đã có ai đăng nhập chưa
Lệnh gọi rẻ nhất, và là lệnh nên gọi lặp lại trong lúc bạn chờ ứng dụng. Nó trả lời cả khi không có tài khoản: signedIn bằng false là một trạng thái, không phải lỗi.
Không có.
{
"status": "running",
"version": "<version>",
"signedIn": true
}Các hồ sơ trong danh mục, có lọc và phân trang
Đọc đúng danh mục mà ứng dụng hiển thị. Các bộ lọc kết hợp được với nhau, và bộ lọc nào cũng khớp chính xác trừ name: nó khớp với mọi hồ sơ có tên chứa nội dung bạn nhập, không phân biệt chữ hoa chữ thường.
{
"page": 1,
"pageSize": 100,
"total": 1,
"items": [
"<profile>"
]
}Một hồ sơ, kèm proxy và dấu vân tay của nó
Cùng đối tượng mà danh sách trả về, cho một mã định danh. Địa chỉ proxy được hiển thị; mật khẩu của nó thì không bao giờ.
{
"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"
}Mở một hồ sơ và nhận địa chỉ để driver kết nối
Khởi động hồ sơ theo cách ứng dụng vẫn làm — dấu vân tay, proxy, cookie của nó — và trả về địa chỉ CDP khi trình duyệt đã lên. Lệnh gọi này chờ; nó không trả về một tác vụ để bạn phải hỏi lại.
{
"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 an toàn nêu tên giai đoạn khi ứng dụng nói được.Lấy địa chỉ driver cho một hồ sơ đã mở sẵn
Dành cho hồ sơ bạn đã mở bằng tay và giờ muốn điều khiển. Nó không khởi động lại gì cả: phiên, các thẻ và cookie vẫn giữ nguyê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 an toàn nêu tên giai đoạn khi ứng dụng nói được.Đóng một hồ sơ theo cách cửa sổ của nó vẫn đóng
Để phiên ghi xong trạng thái của mình. Đây là lệnh nên gọi giữa các lần chạy script trên cùng một hồ sơ.
{
"id": "<profile-id>",
"status": "closed"
}Đóng một hồ sơ không chịu đóng
Cùng phản hồi đó, nhưng không chờ phiên ổn định lại. Hãy dùng nó khi một lệnh dừng không trả về, đừng dùng như thói quen.
{
"id": "<profile-id>",
"status": "closed"
}Những gì đang mở lúc này, và những gì điều khiển được
Mọi hồ sơ đang mở, dù do cửa sổ hay do lệnh gọi mở ra — startedBy cho biết bên nào — kèm địa chỉ driver khi có. Hãy kết nối lại từ đây sau khi script của bạn khởi động lại.
Không có.
{
"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"
}
]
}Mỗi khối đều trọn vẹn: nó đọc tệp địa chỉ, gọi API và kết nối driver. Sao chép một khối, điền tên hồ sơ của bạn vào, và nó chạy. Nhãn cho biết bản dựng bạn tải về được hôm nay có trả lời mọi thứ khối đó cần hay không.
Kết nối qua CDP tới địa chỉ mà lệnh khởi động trả về — đúng cách một script Puppeteer tiếp cận một trình duyệt đang chạy sẵn.
Gọi /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()
Cùng kết nối đó qua lối vào CDP của Playwright, vào ngữ cảnh hồ sơ đã có sẵn chứ không phải một ngữ cảnh mới.
Gọi /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()
Phía Python của cùng việc đó, đọc tệp địa chỉ mà không cần gì ngoài thư viện chuẩn.
Gọi /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 gắn vào một trình duyệt đang chạy sẵn, theo địa chỉ trình gỡ lỗi, và dùng chromedriver mà phản hồi chỉ tới — không tải gì về và không phải đoán gì.
Gọi /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()
Tương tự cho Node: cả địa chỉ trình gỡ lỗi lẫn đường dẫn tới chromedriver phù hợp đều lấy từ phản hồi của lệnh khởi động.
Gọi /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()
Cùng đặc tả đó dưới dạng tệp, ở một địa chỉ không đổi: OpenAPI, dạng JSON, sinh ra từ chính dữ liệu trang này hiển thị. Hãy nhập nó vào Postman hoặc Insomnia, hoặc sinh một client từ nó. Mỗi thao tác trong đó mang cùng mức sẵn có như nhãn ở trên.
openapi.jsonBản phát hành đã mang nó tới, và mọi bản phát hành mở rộng nó, đều nằm trong mục Có gì mới. Một câu hỏi về đặc tả, hoặc một giá trị ở đây không khớp với những gì bản dựng của bạn làm: [email protected].