fast-playwright-skill

一个基于Playwright的跨平台浏览器自动化Agent Skill,支持持久会话和Token优化。

安装使用

复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:

帮我安装这个 AI Skill:fast-playwright-skill。
它的用途是:一个基于Playwright的跨平台浏览器自动化Agent Skill,支持持久会话和Token优化。
完整的 Skill 内容见:https://321skill.com/skills/fast-playwright-skill/raw/index.md
请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。

提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。

使用示例

“请用fast-playwright技能打开GitHub,搜索‘playwright’并进入第一个仓库,然后截图。” 它会调用相应的导航、点击和截图工具,在持久化的浏览器会话中完成这一系列操作,并返回截图结果或操作摘要。你也可以说:“为另一个任务创建一个新的浏览器会话,去电商网站检查商品价格。” 它会使用不同的session ID,实现两个自动化任务互不干扰。

介绍

Fast Playwright Skill 解决了AI Agent在执行网页自动化任务时,浏览器状态无法持久化、多Agent会话相互干扰以及响应内容过长消耗过多Token的问题。它通过一个常驻的后台服务,为每个Agent提供独立的浏览器上下文,使得导航、点击、表单填写、截图等操作可以跨调用保持状态,并允许通过参数控制返回数据的详略以节省Token。

使用方式非常灵活,可以通过多种主流AI开发工具(如Claude Code、Cursor、Codex CLI)的命令行客户端进行调用。用户只需安装并启动服务,即可通过发送JSON格式的指令来控制浏览器。例如,指定不同的 --session 参数即可实现多Agent的会话隔离,使用 --headed 参数则可以打开可视化浏览器窗口进行调试。

这个Skill非常适合需要让AI Agent与网页进行复杂、多步骤交互的开发者、测试人员和自动化脚本编写者。无论是进行数据抓取、自动化测试、网页内容监控还是模拟用户操作流程,它都能提供一个稳定且高效的执行环境。

需要注意的是,该Skill依赖于Node.js环境和Playwright浏览器,首次安装时需要下载浏览器二进制文件。此外,服务默认有30分钟的空闲超时时间,长时间不活动后再次调用可能需要重新启动服务。对于需要7x24小时不间断运行的场景,可能需要自行调整超时配置或部署策略。

核心特点

与同类一次性执行的浏览器自动化脚本不同,它提供了持久的、会话隔离的浏览器环境,特别适合多Agent协作场景;同时通过`expectation`参数精细控制响应内容,有效优化了与AI交互时的Token消耗。

注意事项

不适合需要7x24小时不间断、高并发或大规模分布式运行的网页抓取或自动化测试场景。

常见问题

如何在不同AI开发工具(如Claude Code和Cursor)中安装?

只需根据对应的技能目录(如~/.claude/skills或~/.cursor/skills)克隆仓库并运行npm install即可,具体命令见安装说明。

如何控制AI返回的响应内容大小以节省Token?

在调用工具时,通过`expectation`参数(如设置`includeSnapshot: false`)可以控制是否包含页面快照等大量数据,从而优化Token使用。

给 AI 助手的安装指引

如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:

请访问 https://321skill.com/skills/fast-playwright-skill/raw/index.md 读取 fast-playwright-skill 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。