/devtools 端点提供遵循 Chrome DevTools Protocol (CDP) ↗ 的会话管理功能。这些端点允许你创建持久浏览器会话、管理多个标签页，并使用 CDP 命令与浏览器交互。这对于高级自动化、调试和远程浏览器控制很有用。
CDP 端点可从任何支持 WebSocket 连接的环境访问，包括本地开发机器、外部服务器和 CI/CD 流水线。这意味着你可以从 Node.js 脚本、Puppeteer、Playwright 或任何 CDP 兼容客户端连接到 Browser Run。
开始之前，请创建自定义 API Token，并授予 Browser Rendering - Edit 权限。
Chrome DevTools Protocol (CDP) 是一种远程调试协议，允许你对基于 Chromium 的浏览器进行检测、检查、调试和分析。Chrome DevTools 使用相同的协议来控制和监控浏览器。Puppeteer 和 Playwright 等流行的浏览器自动化库在 CDP 之上提供高级 API，使自动化常见任务更加容易。
浏览器会话端点使你可以：
- 创建和管理持久浏览器会话 — 启动长时间保持活动的浏览器实例
- 打开、关闭和列出浏览器标签页（target） — 在单个浏览器实例中管理多个可调试 target（页面、iframe 等）
- 通过 WebSocket 发送 CDP 命令 — 以编程方式自动化浏览器操作
- 使用 Chrome DevTools UI 查看实时浏览器会话 — 可视化调试和检查远程浏览器会话
- 与现有 CDP 客户端集成 — 使用 Puppeteer 等标准 CDP 客户端或自定义 WebSocket 实现
获取浏览器会话后，你可以通过两种方式与其交互：
连接到 WebSocket 端点 /devtools/browser 以获取会话并通过连接直接发送 CDP 命令 ↗。这是使用 CDP 的标准方式，适用于任何 CDP 客户端，包括 Puppeteer、Playwright 和 MCP 客户端。
还提供 HTTP 端点来管理浏览器生命周期，无需使用 WebSocket。这些遵循标准 CDP HTTP 端点 ↗：
- 创建会话 —
POST /devtools/browser - 列出标签页 —
GET /devtools/browser/{session_id}/json/list - 创建标签页 —
PUT /devtools/browser/{session_id}/json/new - 关闭标签页 —
DELETE /devtools/browser/{session_id}/json/close/{target_id} - 关闭会话 —
DELETE /devtools/browser/{session_id}
查看 API 参考 获取完整端点列表。
如有疑问或遇到错误，请参阅 Browser Run 常见问题与故障排除指南。