Playwright (Automation + MCP + Scraper)

基于Playwright的浏览器自动化、测试与调试工具

安装使用

复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:

帮我安装这个 AI Skill:Playwright (Automation + MCP + Scraper)。
它的用途是:基于Playwright的浏览器自动化、测试与调试工具
完整的 Skill 内容见:https://321skill.com/skills/playwright-automation-mcp-scraper-x-3/raw/index.md
请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。

提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。

使用示例

‘我的一个Playwright测试在本地通过,但在CI上总是超时,帮我分析一下。’ 它会引导你启用追踪功能,运行测试,并教你如何下载和查看trace文件,定位是网络请求未完成还是某个元素加载过慢。或者,你可以说:‘我需要从这个单页应用(SPA)的产品列表里抓取所有动态加载的商品价格。’ 它会为你生成一个Playwright脚本,处理滚动加载,等待元素出现,并提取结构化数据。

介绍

这个Skill旨在解决现代Web开发中复杂且棘手的浏览器自动化与测试问题。无论是测试用例在CI环境或Headless模式下间歇性失败、定位器匹配到错误元素,还是需要模拟复杂用户交互(如文件上传下载、处理弹窗和iframe),它都能提供强大的解决方案。

通过集成Playwright的核心能力,它允许你编写稳健的自动化脚本,利用自动等待、网络请求拦截与重放、设备模拟、追踪报告等功能,确保测试的可靠性和覆盖率。你还可以通过MCP协议直接控制真实浏览器,用于数据抓取或交互式调试。

它非常适合前端开发、测试工程师和全栈开发人员,尤其是那些需要维护复杂Web应用、进行端到端测试,或从其他测试框架(如Cypress、Selenium)迁移到Playwright的团队。对于需要处理JavaScript渲染页面、进行无障碍测试或设备仿真验证的场景尤为有用。

建议在遇到传统HTTP请求无法解决的动态页面交互问题时使用。注意,它不适合维护已有的Cypress或Puppeteer项目,也不应用于简单的HTTP请求场景,这些场景有更轻量的替代方案。

核心特点

与单一功能的测试或自动化工具不同,本Skill深度整合了Playwright的完整能力,特别强化了对CI/CD环境、Headless模式疑难问题的诊断(如追踪、截图对比),并原生支持通过MCP协议进行浏览器控制,实现了自动化、测试与实时调试的无缝结合。

注意事项

不适合维护现有的Cypress或Puppeteer测试套件,也不适用于仅需发送普通HTTP请求即可完成的工作。

常见问题

如何用这个Skill调试只在CI环境中失败的测试?

可以使用它生成并查看追踪(trace)文件,回放测试步骤,分析网络请求和DOM快照,精准定位失败原因。

它能用来抓取需要JavaScript渲染的网页数据吗?

可以。通过驱动真实浏览器,它能完整执行页面JavaScript,然后提取渲染后的DOM数据,非常适合动态内容抓取。

给 AI 助手的安装指引

如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:

请访问 https://321skill.com/skills/playwright-automation-mcp-scraper-x-3/raw/index.md 读取 Playwright (Automation + MCP + Scraper) 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。