Local API & CLI Reference
获取客户端与 CLILocal API 与 CLI 接口文档
桌面引擎本地监听 http://127.0.0.1:9112,开放 Playwright CDP 与命令行调用。
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/extensions | Chrome 扩展库与默认加载配置 |