Playwright (Automation + MCP + Scraper)

• JS 渲染页面 — 所需内容仅在 JavaScript 执行后才存在（单页应用、动态表格、懒加载数据）。
• 多步骤浏览器工作流 — 表单、登录流程、文件上传/下载，或依赖真实浏览器事件和 DOM 状态的导航序列。
• 截图、PDF 及可视化证据采集 — 需要从已渲染页面获取像素级精确输出，而非原始 HTML。
• Playwright 测试编写与调试 — 编写、运行或修复 @playwright/test 测试套件、追踪 CI 不稳定问题，或在有头模式下复现 UI 缺陷。
• MCP 驱动的浏览器控制 — 代理已在循环中拥有 browser_* 工具，且您希望在无需编写新自动化代码的情况下执行导航-点击-填写-截图工作流。

• 静态 HTML 或简单的 HTTP 响应已经足够 — 当页面不需要 JavaScript 渲染时，使用普通的 fetch 或 HTTP skill 速度更快、成本更低、也更稳定。
• 纯 API 任务 — 如果目标服务提供了有文档记录的 API，直接调用它比驱动浏览器更可靠。
• 提取数据是唯一目标且非浏览器方式可行 — 在启动完整浏览器进行抓取之前，优先考虑有文档记录的 API 或普通 HTTP 请求。

运行 npx @playwright/mcp --headless，将 browser_navigate、browser_click、browser_type、browser_snapshot 等功能作为一等工具动作暴露出来。此方式无需编写新的自动化代码——代理通过 MCP 工具调用直接驱动浏览器。

编写并运行直接的 Playwright 脚本（chromium.launch、page.goto、page.screenshot），或使用 npx playwright test 运行完整的 @playwright/test 测试套件。开箱即用地支持有头模式运行、追踪捕获、重试机制以及并行工作进程。

使用 npx playwright codegen <url> 录制交互操作并生成稳定的定位器。无需从源代码中猜测选择器，自动生成基于角色、标签和文本的定位器，能够在 DOM 发生细微变化时保持有效。

通过 MCP 工具操作或直接调用 Playwright API，捕获整页截图、生成 PDF、记录执行追踪，以及下载文件。所有生成的文件将保存在工作区本地或系统临时目录中。

该技能强制使用角色、标签、文本和测试 ID 选择器，而非脆弱的 CSS/XPath，并优先使用 Web 优先断言而非原始命令检查。内置的可操作性等待指导可防止因使用不稳定的 sleep 计时技巧而导致的测试抖动问题。

无隐藏文件、持久会话或未声明的网络调用。除非明确复用，否则身份验证状态为临时状态。高风险的生产流程在执行前需要用户明确确认。

针对本地或预发布环境的应用，运行并扩展现有的 @playwright/test 测试套件。使用 npx playwright test --trace on 捕获 CI 失败时的构建产物，然后通过追踪查看器和有头模式重新运行来诊断不稳定测试。

让代理通过 browser_navigate、browser_type、browser_click 和 browser_snapshot 等 MCP 操作，自动导航网站、填写多步骤表单并截取屏幕截图——全程无需编写任何一行 Playwright (Automation + MCP + Scraper) 脚本。

导航至一个经过 JS 渲染的页面，等待 DOM 稳定后，使用 browser_evaluate 或直接编写 Playwright (Automation + MCP + Scraper) 脚本来提取结构化数据。当目标网站没有提供 API，且内容仅在 JavaScript 执行后才显示时，此方法尤为适用。

在有头模式下使用 npx playwright test --headed 复现已报告的 UI 回归问题，通过 --trace on 捕获追踪记录，并检查网络请求、控制台日志和 DOM 快照，在编写修复方案之前定位根本原因。