用途:通过 Playwright CLI 做浏览器自动化,包括截图、抓取 JS 渲染页面、生成 PDF、提取页面链接。命令直接用 Bash 运行 node tools/playwright.js,所有输出为 JSON,无需 MCP 服务器。
准备:每台机器执行一次 npm install。默认使用系统 Chrome 或 Edge,不额外下载浏览器;若都找不到(如 CI)会自动回退到 Playwright 自带 Chromium。回退后仍报 Executable doesn't exist 时运行 npx playwright install chromium。
主要命令:
- 截图:node tools/playwright.js screenshot <url> [output-path] [--fullpage] [--headed] [--wait-for <selector>] [--timeout <ms>],默认输出 .tmp/screenshot.png。
- 抓取:node tools/playwright.js scrape <url> [--selector <css>] [--headed] [--wait-for <selector>] [--timeout <ms>]。不带 selector 返回整页 { title, url, text, metaDescription };带 selector 返回匹配元素数组 { text, html, href }。
- PDF:node tools/playwright.js pdf <url> [output-path] [--format <A4|Letter>] [--headed] [--timeout <ms>],默认 .tmp/output.pdf。
- 链接:node tools/playwright.js links <url> [--headed] [--timeout <ms>],返回页面上所有外链 { text, href } 数组。
选区工具建议:静态 HTML 或 REST API 用 Tavily MCP 或 curl;1000+ 页面大规模抓取用 Apify MCP;localhost 前端截图用 node screenshot.mjs;一次性截图可免安装用 npx playwright screenshot <url> <file>。
输出处理:命令把 JSON 写到 stdout,可重定向保存或管道 python -m json.tool 美化;截图保存后用 Read 工具查看 PNG。
限制与排错:模块缺失先 npm install;ERR_NAME_NOT_RESOLVED 多为 URL 拼写错误或站点不可用;超时可增大 --timeout 60000 或加 --wait-for。多步自动化任务按 workflows/browser-automation.md 执行。收费、价格、平台支持等其他信息暂未提供。