API 接口文档
本文按功能整理本地客户端 REST 接口；内核查询包括一个兼容别名。MCP 单独说明。
专业版功能
需在客户端登录有效专业版会员并保持客户端运行。从 API 页面复制实际服务地址及 api-key；端口不固定为 9000。
环境管理
| 接口 | 方法 | 路径 |
|---|---|---|
| 获取浏览器环境列表 | GET / POST | /api/getBrowserList |
| 获取环境完整参数 | GET | /api/getBrowserFullParameters |
| 获取运行中的环境列表 | GET | /api/getBrowserRunningList |
| 创建环境 | POST | /api/addBrowser |
| 更新环境 | POST | /api/updateBrowser |
| 删除环境 | POST | /api/deleteBrowser |
| 启动环境 | POST | /api/launchBrowser |
| 关闭环境 | POST | /api/stopBrowser |
| 删除环境数据 | POST | /api/deleteBrowserData |
| 清理环境缓存 | POST | /api/clearCache |
| 查询环境是否运行 | GET | /api/isBrowserRunning |
云端备份
| 接口 | 方法 | 路径 |
|---|---|---|
| 列出云端备份 | GET | /api/listCloudBackups |
| 从云端备份恢复 | POST | /api/restoreCloudBackup |
内核与窗口
| 接口 | 方法 | 路径 |
|---|---|---|
| 获取内核版本信息 | GET | /api/getCoreVersions |
| 获取可用内核版本（兼容别名） | GET | /api/getAvailableCoreVersions |
| 排列已启动窗口 | POST | /api/arrangeWindows |
Cookie 与指纹
| 接口 | 方法 | 路径 |
|---|---|---|
| 获取环境 Cookie | GET | /api/getCookie |
| 更新环境 Cookie | POST | /api/updateCookie |
| 随机更新环境指纹 | POST | /api/randomizeFingerprint |
分组管理
| 接口 | 方法 | 路径 |
|---|---|---|
| 获取分组列表 | GET | /api/getGroupList |
| 添加分组 | POST | /api/addGroup |
| 更新分组名称 | POST | /api/updateGroup |
| 删除分组 | POST | /api/deleteGroup |
插件管理
| 接口 | 方法 | 路径 |
|---|---|---|
| 获取插件列表 | GET | /api/getCrxList |
| 添加插件 | POST | /api/addCrx |
| 删除插件 | POST | /api/deleteCrx |
平台账号管理
| 接口 | 方法 | 路径 |
|---|---|---|
| 获取平台账号列表 | GET | /api/getAccountList |
| 添加平台账号 | POST | /api/addAccount |
| 删除平台账号 | POST | /api/deleteAccount |
| 更新平台账号列表 | POST | /api/updateAccountList |
MCP
MCP 端点 位于同一服务的 /mcp，遵循 MCP 协议，不使用 REST 接口的普通响应格式，见 MCP 使用指南。
不要假定所有接口响应结构一致
多数接口返回 success，按需包含 data / message。启动端口在 data.debuggingPort；内核查询的 total / majors、删除插件的 crxPath 在顶层。ApiFox 将运行状态定义为布尔值，当前客户端则使用 success/data 包装；请按各接口页解析。
