SuperAPI AI 工具集

browser-execute

通用与其它

查看项目

更新于 10-15 17:29

技能介绍

用途:browser_execute 通过 Chrome DevTools Protocol 对已连接的浏览器会话执行 JavaScript 片段,用于驱动真实浏览器完成自动化操作。片段在进程内运行,会话绑定到长期存在的 CDP Session;可用对象仅有 session、console 和标准 JS 全局变量,没有辅助命名空间。

主要能力:可调用 CDP 全部命令(资料称 652 个),如 Page.navigate 导航、Runtime.evaluate 执行页面 JS、Input.dispatchMouseEvent 点击、Input.insertText 输入、Page.captureScreenshot 截图。截图结果会自动附加到下一轮对话,无需解码或保存。Page.screencastFrame 等事件形式的像素不会自动附加。

连接方式:方式一连接用户正在运行的 Chrome(需在 chrome://inspect/#remote-debugging 勾选允许远程调试,Chrome 144+ 首次附加还需点击弹窗 Allow),适用于涉及登录站点和现有浏览器状态的场景;方式二连接以 --remote-debugging-port=<port> --user-data-dir=<path> 启动的隔离浏览器,适用于无人值守自动化,注意 user-data-dir 不能是平台默认目录,Chrome 136+ 在默认目录下会静默忽略该端口参数;方式三通过 Browser Use 云浏览器(付费,需 BROWSER_USE_API_KEY,有面向智能体的免费层,限 3 个并发浏览器);方式四使用用户预配置的端点(V4_RUN_ID 与 BU_CDP_WS 同时设置时自动连接)。

使用方式:手动连接后需先列出页面目标并调用 session.use(targetId) 附加页面。将可复用脚本写入项目工作区 ./.bcode/agent-workspace/,通过 await import() 引入,注意自行加缓存失效参数。

限制:片段内不允许顶层 import,需用 await import();避免无 await 的 CPU 密集死循环;默认超时 60 秒,超时后仅该次调用失去 CDP 访问权限;显式重连或切换浏览器会清除目标附加,需重新列出目标;Page.navigate 可能返回非空 errorText 而非抛错,视为导航失败。其他功能、收费细节与平台支持暂未提供。