Local API & CLI Reference

Local API 与 CLI 接口文档

桌面引擎本地监听 http://127.0.0.1:9112,开放 Playwright CDP 与命令行调用。

获取客户端与 CLI
Local API 地址
http://127.0.0.1:9112
鉴权请求头
Authorization: Bearer mdk_*
自动化调试协议
Playwright · connectOverCDP
Local API 与 mdk CLI 并发配额速览对比完整方案 →
Free · $0 永久
单窗口调试(1 并发)
Solo · $79 首发买断
不限并发窗口 + API 本地建环境
Pro $9/月 · Team $29/月
不限并发 + 跨设备云端同步
Local Loopback Only
chromium.connectOverCDP(wsEndpoint)
import { chromium } from 'playwright'

const res = await fetch('http://127.0.0.1:9112/api/v1/browser/start', {
  method: 'POST',
  headers: { 'content-type': 'application/json' },
  body: JSON.stringify({ serialNumber: 1, cdp: true }),
})
const { wsEndpoint } = await res.json()
const browser = await chromium.connectOverCDP(wsEndpoint)
HTTP 方法接口路径用途
GET/api/v1/status引擎状态、配额计数与本地内核版本
POST/api/v1/browser/start启动环境并返回 CDP wsEndpoint(Free 单窗口)
POST/api/v1/browser/stop关闭运行中窗口并保存会话快照
GET/api/v1/browser/active列出活动窗口会话与调试地址
POST/api/v1/browser/arrange一键宫格或级联排列桌面窗口
GET / POST/api/v1/browser/check执行或读取 6 维环境自检结果
GET / POST / DELETE/api/v1/profiles环境列表、API 动态创建(Pro+)与回收站
GET / POST / DELETE/api/v1/proxies代理池管理、测速与密文凭据封存
GET / POST / DELETE/api/v1/groups工作区分组管理与排序
GET / POST / PATCH / DELETE/api/v1/extensionsChrome 扩展库与默认加载配置