开发与工程

playwright-cli 浏览器自动化技能

通过命令行驱动 Playwright,让 AI 代理替你完成网页导航、表单填写、截图与数据提取,无需手写浏览器脚本。

56/ 100
谨慎使用

价值存在,但可靠性、证据或控制措施仍有明显缺口。

查看评分依据 ↓
可直接使用于
Codex · Claude Code
Star 数
★ 11k
最近更新
27 天前
License
MIT
playwrightbrowser-automationweb-testingscreenshots
+3web-scrapinge2e-testingcli

这个 Skill 能做什么,适合哪些场景?

playwright-cli 是 VoltAgent 仓库 examples 目录中的一个 Agent Skill,把浏览器自动化封装为一套可直接调用的 CLI 命令。它通过快照(snapshot)返回元素引用(如 e15),代理再据此执行点击、输入、上传等操作,形成稳定的交互循环。技能还覆盖多标签页、Cookie 与本地存储、请求拦截、控制台/网络日志、追踪和视频录制等高级能力。它自带 `allowed-tools: Bash(playwright-cli:*)` 权限声明,属于 Claude Code 风格的技能文件,移植到其他平台需少量修改。

运行 playwright-cli 命令行工具:打开浏览器会话(可指定 chrome/firefox/webkit/msedge 或持久化配置文件)、导航页面、通过 snapshot 获取元素 ref 后执行 click/type/fill/select/upload/hover/drag 等交互、对页面或元素截图、导出 PDF、执行 JavaScript(eval / run-code)、管理多标签页、保存与加载 Cookie/LocalStorage/SessionStorage、用 route 命令模拟网络响应、查看 console 与 network 日志、进行 tracing 和录制 WebM 视频。SKILL.md 另附 7 个 references/ 文档,涵盖请求模拟、测试生成、会话管理等专题。

适合
  • 前端开发者想让代理对本地或线上 Web 应用做端到端验证:打开页面、操作交互、核对快照与截图
  • 测试工程师需要批量填写表单、提交并捕获结果截图,替代手工回归
  • 数据分析师要从无需登录或已具备会话凭证的网页提取信息,可用 storage state 保存/恢复登录态
  • 调试人员排查前端问题:读取 console 报错、network 请求,并配合 tracing 复现操作序列
  • QA 需要生成测试代码或录制操作视频,作为缺陷报告附件

如何安装这个 Skill?

开始前你需要
Agent 需要具备
  • Shell / 命令行
  • 网络访问
  • 本地文件系统
需要预先安装
  • playwright-cli
  • installable browser via 'playwright-cli install-browser'

该技能位于 VoltAgent 仓库的 examples/with-workspace/workspace/skills/playwright-cli/ 目录,包含 SKILL.md 和 references/ 子目录。将其文件夹复制到你所用 Agent Skills 客户端的技能目录即可。SKILL.md 中提供了 playwright-cli install --skills 和 playwright-cli install-browser 安装命令,但仓库未说明 playwright-cli 二进制本身的独立安装渠道,需自行查阅。

通用方式:手动安装到 Claude Code(macOS / Linux)
tmp="$(mktemp -d)"
git clone --depth 1 https://github.com/VoltAgent/voltagent.git "$tmp"
mkdir -p ~/.claude/skills
cp -R "$tmp/examples/with-workspace/workspace/skills/playwright-cli" ~/.claude/skills/
rm -rf "$tmp"

根据源仓库地址和 Skill 路径自动生成,只复制这个 Skill 的文件夹。如果上文有作者提供的安装方式,请优先按作者说明操作;想只在当前项目中使用,把 ~/.claude/skills 换成项目里的 .claude/skills。

如何使用这个 Skill?

试试这样说

安装后,把下面任意一句发给 Agent 即可触发:

  • 打开 https://example.com,填入邮箱 [email protected] 并提交,然后截图

安装浏览器后,用自然语言触发,例如:「打开 https://example.com,填入邮箱 [email protected] 并提交,然后截图」。代理会按 SKILL.md 的流程执行:playwright-cli open <url> → snapshot 获取元素 ref → fill/click 交互 → screenshot 截图 → close 关闭。可用 --browser=chrome 指定浏览器,用 -s=会话名 管理多个并行浏览器会话。

这个 Skill 有哪些优点和局限?

优点
  • 命令覆盖面极广:交互、标签页、存储、网络模拟、DevTools、追踪、录屏一站式齐全
  • 基于 snapshot ref 的交互模式对 LLM 友好,比坐标或 CSS 选择器更稳定
  • 支持命名会话与持久化 profile,适合需要登录态的多任务场景
  • 文档质量高,含表单提交、多标签、调试等即用示例和 7 篇专题参考
局限
  • frontmatter 使用 Claude Code 的 `allowed-tools: Bash(...)` 语法,其他平台需手动调整
  • playwright-cli 工具本身的独立安装方式在来源中未完整说明
  • 需要真实浏览器环境与网络访问,沙箱或离线环境无法运行
  • README 面向整个 VoltAgent 平台,与该技能本身的能力无直接关系,评估时需区分

这个 Skill 与同类方案有什么区别?

与相关 Skills 并排比较;分数均按同一 FSRS 标准得出。

Skill FS 评分 Star 数 最近更新 License
playwright-cli 浏览器自动化技能 本页 56 · 谨慎使用 ★ 11k 27 天前 MIT
Playwright 浏览器自动化技能 68 · 推荐 ★ 3.2k 2 个月前 MIT
Web 应用测试技能 49 · 谨慎使用 ★ 3.1k 8 个月前 MIT
Playwright 浏览器自动化技能 ✓ Microsoft · 官方 46 · 谨慎使用 ★ 98k 11 天前 Apache-2.0
Playwright 开发指南 ✓ Microsoft · 官方 45 · 不推荐 ★ 98k 11 天前 Apache-2.0

来源中未点名直接竞品;README 赞助商栏提到 Ego Lite 宣称比 agent-browser (Vercel) 快 3.45 倍,但这是赞助内容且针对 VoltAgent 平台整体,不能作为本技能的客观对比依据。

FollowSkills 如何评估这个 Skill?

FollowSkills 评估 · FSRS-1.0
谨慎使用
56/ 100 五分制 2.8 / 5
1价值适配11 / 20 · 2.8/5
2可靠性11 / 20 · 2.8/5
3安全性17 / 25 · 3.4/5

浏览器自动化示例技能(打开浏览器、点击、填表、截图),与其他 playwright 系列技能(id 758)同类风险——本质是可执行任意浏览器交互的能力,本例是框架示例而非独立发布的生产技能。

4证据5 / 15 · 1.7/5
5易用性7 / 10 · 3.5/5
6维护性5 / 10 · 2.5/5
1 2 3 4 5 6

点击维度查看打分理由

评估于 2026年7月17日 评估证据[1]

证据充分度:低 — 主要依赖静态检查、作者材料或有限演示;适合发现线索,不适合做高风险决策。

本条评估按 FSRS 1.0 标准完成,维度分不做换算,已进入按 FSRS 2.0 重新评估的复核队列。

查看完整评分方法 →

常见问题

需要什么运行环境?
需要能执行 shell 命令的环境、可安装的浏览器(通过 `playwright-cli install-browser`)以及网络访问;无浏览器或无网络的沙箱中无法工作。
登录态怎么处理?
可用 `state-save`/`state-load` 导出导入认证状态,或用 `cookie-set`/`localstorage-set` 手动设置,还支持 `--persistent` 持久化 profile。
能在非 Claude Code 平台用吗?
核心内容是通用 CLI 说明,可移植,但 frontmatter 的 `allowed-tools: Bash(playwright-cli:*)` 是 Claude Code 权限语法,移植时需删除或改写。
有没有费用?
代码遵循 MIT 许可证(VoltAgent,版权 2026-present),SKILL.md 未提及任何付费服务依赖。

同仓库的其他 Skills

均来自 VoltAgent/voltagent

相关 Skills