pi-puppeteer
基于Puppeteer-core的跨浏览器自动化扩展包
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：pi-puppeteer。 它的用途是：基于Puppeteer-core的跨浏览器自动化扩展包 完整的 Skill 内容见：https://321skill.com/skills/pi-puppeteer/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“使用pi-puppeteer帮我打开百度首页，并截图保存。” 它会调用该Skill，启动一个无头Chromium浏览器，导航到百度首页，然后将当前页面截图并保存到指定路径。或者，你可以说：“用这个Skill登录到我的管理后台，并提取今日订单列表。” 它会模拟用户输入和点击操作，完成登录并抓取所需数据。
介绍
pi-puppeteer 是一个 Pi 扩展包，旨在解决在 AI Agent 环境中进行稳定、高效的网页自动化操作时，因浏览器环境差异和依赖复杂带来的挑战。它封装了 Puppeteer-core，提供了一个统一的接口，让开发者无需关心底层浏览器的具体安装和管理细节，即可启动和控制浏览器实例进行网页抓取、测试或交互。
使用起来非常简便。在配置好 Pi 环境后，通过 npm 安装此包，然后在你的 Skill 代码中引入并调用其提供的启动浏览器、打开页面、执行脚本等方法，即可像使用标准 Puppeteer 一样进行自动化操作，同时它内部处理了浏览器二进制文件的获取与兼容性问题。
这个 Skill 非常适合需要集成网页自动化能力的 AI Agent 开发者、希望快速构建网页数据采集或自动化测试工具的工程师，以及那些希望避免直接处理 Puppeteer 与不同浏览器（Chromium/Firefox）兼容性问题的项目团队。
在使用时，建议注意网络环境，因为首次运行可能会下载浏览器内核。对于需要高度定制浏览器启动参数或使用非常见浏览器版本的场景，可能需要查阅其源码进行扩展。在无头（headless）模式下运行通常更稳定且资源占用更少。
核心特点
核心区别在于其“Chromium优先、Firefox就绪”的架构设计，默认无缝使用Chromium，同时预留了对Firefox的完整支持路径，提供了比单一浏览器绑定方案更灵活的底层选择。此外，它作为Pi扩展包深度集成，简化了在AI Agent项目中引入浏览器自动化的配置复杂度。
注意事项
不适合对浏览器版本有极其特定、强制要求的场景，也不适合需要在无Node.js环境的纯前端浏览器中运行的场景。
常见问题
pi-puppeteer 和原版 Puppeteer 有什么区别？
它是基于Puppeteer-core的封装，作为Pi扩展包优化了集成体验，并管理了浏览器二进制文件，默认支持Chromium，架构上兼容Firefox。
如何用它启动 Firefox 浏览器？
需要查阅其文档或源码，通常需要通过特定配置参数来指定使用Firefox作为启动的浏览器类型。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/pi-puppeteer/raw/index.md 读取 pi-puppeteer 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/pi-puppeteer/raw/index.md（查看排版版本）