Playwright CLI 是一个通过 Playwright 实现浏览器自动化的命令行工具，定位为面向编码智能体（coding agents）的令牌高效 CLI，也适用于自动化测试工作流。
用途 主要用于在命令行中驱动浏览器完成页面打开、元素交互、页面信息采集与导出等自动化任务，便于编码智能体或测试流程调用。
安装 npm install -g @playwright/mcp@latest playwright-cli --help
主要能力 核心命令：open <url> 打开 URL；close 关闭页面；type <text> 在可编辑元素中输入文本；click <ref> [button] 点击元素；dblclick <ref> [button] 双击；fill <ref> <text> 填充字段；drag <startRef> <endRef> 拖放；hover <ref> 悬停；check <ref> 勾选复选框/单选框；uncheck <ref> 取消勾选；select <ref> <val> 选择下拉选项；snapshot 捕获页面快照以获取元素引用（refs）。 导航：go-back、go-forward、reload。 键盘与鼠标：press <key>、keydown <key>、keyup <key>、mousemove <x> <y>、mousedown [button]、mouseup [button]、mousewheel <dx> <dy>。 保存与导出：screenshot [ref] 截取页面或元素；pdf 保存为 PDF。 标签页：tab-list、tab-new [url]、tab-close [index]、tab-select <index>。 DevTools：console [min-level] 查看控制台消息；network 查看网络请求；run-code <code> 运行 JS 片段；tracing-start / tracing-stop 开始与停止追踪。 会话：session-list、session-stop [name]、session-stop-all、session-delete [name]。
使用方式 有头模式：playwright-cli open https://example.com --headed 示例（打开并交互）： playwright-cli open https://example.com playwright-cli type "search query" playwright-cli press Enter playwright-cli screenshot 示例（使用会话）： playwright-cli open https://site1.com playwright-cli --session=project-a open https://site2.com
环境变量 PLAYWRIGHT_MCP_BROWSER：浏览器，可选 chrome、firefox、webkit、msedge。 PLAYWRIGHT_MCP_HEADLESS：是否无头运行（默认：有头）。 PLAYWRIGHT_MCP_ALLOWED_HOSTS：逗号分隔的允许主机。 PLAYWRIGHT_MCP_CONFIG：配置文件路径。
配置 可创建 playwright-cli.json 进行持久化设置，例如： { "browser": { "browserName": "chromium", "headless": false }, "outputDir": "./playwright-output", "console": { "level": "info" } }
适用场景 适合编码智能体执行浏览器操作、自动化测试流程、页面交互与信息采集、截图与 PDF 导出、控制台与网络请求排查、以及需要多会话隔离的浏览器自动化任务。
限制与说明 跨平台，需要 Node.js 18+（Linux、macOS、Windows）。会话默认持久化 cookies/storage；使用 --session 标志可获得隔离的浏览器实例。快照会返回元素引用，供后续命令使用。
源码 https://github.com/microsoft/playwright-cli