browser-pilot
为AI智能体提供自动化优先的浏览器控制库
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：browser-pilot。 它的用途是：为AI智能体提供自动化优先的浏览器控制库 完整的 Skill 内容见：https://321skill.com/skills/browser-pilot/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“帮我检查一下电商网站首页的商品列表状态，并截图。”，它会通过 browser-pilot 连接到浏览器，执行 `snapshot` 命令获取页面结构化信息并截图。或者
对AI说：“请自动完成这个登录流程并验证是否跳转成功。”，它会使用 `batch` 方法执行一系列 `goto`、`fill`、`submit`、`assertUrl` 等已验证操作。
介绍
browser-pilot 是一个基于 Chrome DevTools Protocol 的浏览器自动化库，专为 AI 智能体设计。它解决了 AI 在理解和操作真实网页环境时面临的复杂性问题，例如处理动态内容、跨域 iframe 和页面状态验证。
通过提供 CLI 和 TypeScript API 两种使用方式，用户可以直接在终端执行浏览器操作命令，或将其集成到 Node.js、Bun 或 Cloudflare Workers 项目中，实现从简单的页面导航到复杂的多步骤工作流录制与回放。
它特别适合需要将网页操作能力赋予 AI 的开发者和团队，例如构建自动化测试、数据抓取或模拟用户交互的智能体。
建议从 CLI 的 connect 和 exec 命令开始快速体验，理解其“先检查，后行动”的核心模式。对于生产环境，注意其 0.1.0 版本尚在早期，且原生 select 元素可能存在事件触发的已知问题。
核心特点
与通用浏览器自动化工具（如 Puppeteer）相比，browser-pilot 专为 AI 智能体设计，强调“先检查后行动”和“已验证的操作”，提供丰富的页面状态检查命令（如 `snapshot`, `review`, `delta`）来为 AI 决策提供结构化数据，并且其 CLI 和录制回放功能天然适合与 AI 指令结合。
注意事项
目前版本（0.1.0）尚不支持复杂的浏览器手势或高级移动端模拟，且在处理依赖非信任事件的特定前端应用时可能遇到中间状态问题。
常见问题
browser-pilot 和 Puppeteer 有什么区别？
browser-pilot 专为 AI 智能体设计，内置丰富的页面状态检查命令和“录制-回放”工作流，更侧重于为 AI 提供可解释的浏览器环境和已验证的操作。
如何录制一个网页操作流程并让 AI 重复执行？
使用 `bp record` 命令录制手动操作，生成 recording.json 文件，然后用 `bp record derive` 将其转换为 workflow.json，最后通过 `bp run` 或 `bp exec` 让 AI 驱动的智能体自动执行。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/browser-pilot/raw/index.md 读取 browser-pilot 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/browser-pilot/raw/index.md（查看排版版本）