SuperAPI AI 工具集

browser_cdp

智能体与模型

查看项目

更新于 10-15 19:52

技能介绍

用途:browser_cdp 处理显式的 CDP(Chrome DevTools Protocol)操作,包括扫描本地 CDP 端口、连接已运行的 Chrome、在启动时指定 cdp_port,以及让多个智能体或工具共享同一浏览器实例。默认的 start 内部虽使用托管 CDP,但用户通常无需了解 CDP 细节;只有用户明确提到“连接现有浏览器 / 扫描端口 / 指定端口 / 共享浏览器”时才进入本技能范围。

主要能力与用法: 扫描本地 CDP 端口,默认范围 9000–10000:{"action": "list_cdp_targets"};指定单端口:{"action": "list_cdp_targets", "port": 9222};自定义范围:{"action": "list_cdp_targets", "port_min": 8000, "port_max": 12000}。 连接现有 Chrome:{"action": "connect_cdp", "cdp_url": "http://localhost:9222"},连接后可继续使用 open、snapshot、click、type 等标准操作;stop 仅断开连接,不会关闭外部浏览器。 指定端口启动:{"action": "start", "cdp_port": 9222},或同时显示窗口:{"action": "start", "headed": true, "cdp_port": 9222}。若指定端口已被占用会立即报错,不会强制复用;未指定时自动选择可用端口。

适用场景:用户已有打开的 Chrome 并希望智能体接管、需要沿用现有登录状态或标签页、需要向其他工具提供固定调试端点、需要先扫描本机可用附加目标。

限制与注意:每个工作区同一时间只能运行或连接一个浏览器,切换前必须先执行 stop。多工作区若都请求同一固定 cdp_port,后启动者会因端口占用失败。外部 CDP 连接同样受空闲自动停止管理,但语义是“自动断开”而非关闭外部浏览器;空闲计时主要由工具操作刷新,用户在浏览器窗口中的手动交互通常不会重置。若用户不希望暴露浏览历史、Cookie、页面内容或会话数据,建议使用 private_mode=true 切换到 Playwright 托管模式。private_mode 是每次 start 调用的显式参数,不作为工作区状态持久化。与 browser_visible 的分工:后者处理是否显示窗口与是否使用 private_mode,本技能处理连接、暴露、指定与扫描 CDP 端口。使用显式 CDP 能力前应提醒用户敏感数据暴露风险。