用途:通过 Chrome DevTools Protocol(CDP)自动化 Chrome 浏览器,适用于浏览器自动化、网页抓取与数据提取、截图与 PDF 生成、表单填写、登录自动化、元素交互、标签页与 Cookie 管理、JavaScript 执行等任务。
主要能力:采用守护进程架构,后台守护进程维持持久 CDP 连接,CLI 命令通过 IPC 通信,首次命令自动启动、会话结束停止,30 分钟无活动超时。Smart Mode 配合 Interaction Map,在页面加载时自动生成交互元素 JSON 映射,支持基于文本搜索并自动生成选择器,重复元素可用索引区分,缓存 10 分钟并自动重建。支持截图(可指定区域)、PDF、视口设置、数据提取、控制台读取、Cookie 读取、等待、滚动与 eval。
使用方式:所有命令通过 .browser-pilot/bp 包装脚本执行,建议先运行 node .browser-pilot/bp --help 查看用法。导航如 node .browser-pilot/bp navigate -u <url>;交互推荐 Smart Mode,如 node .browser-pilot/bp click --text Login --type button、node .browser-pilot/bp fill --text Email -v <value>,重复元素用 --index,仅可见元素用 --viewport-only,也可用 --tag 过滤;直接模式用 -s 选择器。截图 node .browser-pilot/bp screenshot -o <filename>.png,PDF 用 pdf 命令。Chain Mode 可串联多命令,支持 --timeout 与 --delay。
适用场景:需要文本定位元素(如“点击第 3 个 Delete 按钮”)、需要绕过机器人检测(navigator.webdriver = false)等。
限制:需已安装 Chrome;本地脚本在会话开始时自动初始化。资料未提供具体收费、价格与平台支持范围。官方建议先运行 --help,不要直接阅读源码以免污染上下文窗口;需求不明确时应先向用户确认。