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-8/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
‘帮我用Playwright写一个测试脚本，登录到我们的管理后台，检查用户列表页面是否正常加载，并截图保存。’，它会生成一个包含智能等待、元素定位和错误处理的完整Playwright测试代码。或者，你可以说：‘这个测试在无头模式下总是超时，帮我分析一下可能的原因并修复。’，AI会引导你检查网络空闲状态、调整等待策略或启用追踪来定位问题。
介绍
Playwright Skill 是一个强大的浏览器自动化与测试工具，专门用于解决现代Web应用开发中的复杂交互和测试难题。它能自动化浏览器操作，处理页面元素定位、网络请求、文件上传下载等场景，并支持在CI/CD环境中稳定运行测试。
通过提供智能定位器、自动等待、网络请求拦截与重放、设备模拟等功能，你可以轻松编写可靠的端到端测试脚本，或构建数据抓取和浏览器自动化流程。它支持多种浏览器，并能生成详细的追踪报告和截图，帮助快速定位问题。
该Skill非常适合前端开发、测试工程师和全栈开发人员，尤其是那些需要处理动态内容、复杂UI交互（如iframe、shadow DOM）或需要在不同设备和环境下验证应用行为的团队。
使用建议：对于现有稳定的Cypress或Puppeteer项目，若无特殊需求不建议迁移。对于简单的HTTP请求获取，使用专门的HTTP工具会更高效。建议充分利用其追踪（trace）和报告功能来调试仅在特定环境（如CI、无头模式）下出现的偶发性故障。
核心特点
与同类浏览器自动化工具相比，其核心优势在于内置了对现代Web复杂场景（如iframe、shadow DOM、网络空闲判断）的稳健处理，以及通过Playwright MCP实现对真实浏览器的直接控制，便于集成到更广泛的AI Agent工作流中。
注意事项
不适合用于维护现有的、运行良好的Cypress或Puppeteer测试套件，也不适用于仅需发起简单HTTP请求即可完成的任务。
常见问题
Playwright和Selenium/Cypress有什么区别？
Playwright由微软开发，支持多浏览器且无需额外驱动，自动等待机制更智能，对现代Web框架（如SPA）兼容性更好，并原生提供追踪、网络拦截等高级调试功能。
如何调试只在CI环境中失败的测试？
可以使用Playwright的追踪（trace）功能，在CI运行失败时生成追踪文件，然后在本地通过Playwright Trace Viewer工具可视化回放测试步骤，查看快照、网络请求和日志来定位问题。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/playwright-automation-mcp-scraper-x-8/raw/index.md 读取 Playwright (Automation + MCP + Scraper) 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/playwright-automation-mcp-scraper-x-8/raw/index.md（查看排版版本）