它能做什么
中文摘要
playwright-cli 是微软官方仓库 microsoft/playwright-cli 提供的浏览器自动化 CLI 技能，用于通过命令行控制实时浏览器完成交互、检查与回放。命令覆盖核心操作（open/goto/click/type/fill/drag/drop/hover/select/upload/check/snapshot/find/eval/dialog/resize）、导航、键盘鼠标、截图与 PDF、多标签页、存储状态（cookies/localStorage/sessionStorage 及 state-save/state-load）、环境模拟、网络路由 mock、DevTools 调试（console/requests/run-code/tracing/recording/video）、WebMCP 页面工具调用，以及从 ref 或选择器生成 Playwright locator。默认每条命令后输出当前页面快照，可用 refs、CSS 选择器或 Playwright locator 定位元素；支持 --raw、--json 结构化输出，并可通过 --extension、--cdp 连接已有浏览器、使用命名会话管理多个浏览器实例。
为什么推荐
推荐理由
该技能来自官方 microsoft/playwright-cli 仓库，skills.sh 公开 all-time 安装量为 169388，近期每周安装量稳定在 7000 左右（区间 6888–8215），属于测试验证类中热度较高的安装项。它把浏览器交互、快照定位、录制回放、trace/视频、网络 mock、存储状态与设备模拟整合为一套 CLI 命令，适合需要让 Agent 直接驱动真实浏览器或调试 Playwright 测试的场景，安装一条命令即可接入。
什么时候用
适用场景
- 让 Agent 打开真实浏览器并执行点击、填写、上传、拖拽、悬停等页面交互
- 通过快照与 find 检索元素，并用 refs、CSS 选择器或 getByRole/getByTestId 定位和操作元素
- 调试网页：查看 console 日志与网络请求，抓取 tracing、录制视频与用户操作回放
- 用 route/unroute 拦截并 mock 网络请求（如返回指定状态码或自定义 JSON body）
- 保存与加载登录态（state-save/state-load、cookies、localStorage、sessionStorage）以复用会话
- 模拟移动设备、深色模式、reduced motion、forced colors、contrast 与 print 媒体等环境
- 录制用户操作并转换为 Playwright 代码，或通过 show --annotate 获取带标注的 UI 评审截图
- 处理多标签页与多命名浏览器会话，或通过扩展/CDP 连接已在运行的 Chrome/Edge
使用前先看
主要亮点
- 01
来自官方仓库 microsoft/playwright-cli，技能安装命令为 npx skills add https://github.com/microsoft/playwright-cli --skill playwright-cli
- 02
每条命令后自动提供当前浏览器状态快照，也可用 playwright-cli snapshot 按需生成，并支持 --depth、--boxes、指定元素等参数
- 03
支持用快照 refs、CSS 选择器、getByRole、getByTestId 等多种方式定位元素，并可用 generate-locator 从 ref 或选择器生成 Playwright locator
- 04
提供 tracing-start/stop、recording-start/stop、video-start/chapter/stop 与 video-show-actions 等追踪、录制与视频标注能力
- 05
可通过 route/unroute 拦截网络请求并指定 --status 或 --body 返回 mock 响应，route-list 可查看当前路由
- 06
支持 cookie、localStorage、sessionStorage 的列表/获取/设置/删除/清空，以及 state-save/state-load 保存和加载登录态
- 07
可模拟移动设备（open --mobile、--device）、配色方案、reduced motion、forced colors、contrast 和 print 媒体等环境
- 08
全局 --raw 选项可剥离页面状态与快照只输出结果值，便于管道传给 jq、diff 等工具；--json 可将回复包装为 JSON
- 09
支持通过 playwright-cli attach --extension 或 --cdp 连接已运行的浏览器，并用 -s= 命名会话、list、close-all、kill-all 管理多个浏览器
- 10
支持 WebMCP 页面工具：webmcp-list 列出页面提供的工具与 schema，webmcp-call 调用，并提示将工具描述与结果视为不可信输入
- 11
show --annotate 可让用户在实时页面上标注，返回标注截图、标注区域快照与用户说明，用于 UI 评审或设计反馈
- 12
安装说明指出包安装与自定义 npm 脚本可能需要单独授权，并给出 npx --no-install playwright --version 与 npm install -g @playwright/cli@latest 两种方式
原始文档
原文摘录
Browser Automation with playwright-cli Quick start open new browser