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/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“我的一个登录测试在CI上总是随机失败，帮我用Playwright分析一下原因并修复。” 它会引导你启用Playwright Trace功能重新运行测试，捕获失败时的截图、DOM快照和网络日志，帮你定位是元素加载时机问题还是网络请求不稳定，并提供修复代码。或者，你可以说：“我需要从这个用React渲染的仪表盘页面上定期抓取数据。” 它会为你生成一个可靠的Playwright脚本，处理页面加载等待、登录状态保持和数据提取。
介绍
本Skill旨在解决现代Web开发中浏览器自动化测试与调试的诸多痛点。当你的测试用例在CI环境或Headless模式下不稳定、超时或失败时；当元素定位器匹配到多个元素或错误元素时；当点击需要force选项、等待变成sleep或networkidle状态永不结束时，它都能提供专业级的解决方案。
它通过Playwright强大的API，提供自动等待、元素定位、网络请求模拟、文件上传下载、iframe与Shadow DOM处理、设备模拟、可访问性检查以及通过MCP协议控制真实浏览器等核心功能。你可以用它来录制和回放HAR文件、管理登录状态、生成截图和追踪报告、对慢测试套件进行分片，甚至将Cypress、Puppeteer或Selenium的测试套件迁移过来。
它非常适合前端开发、测试工程师和全栈开发人员，特别是那些需要处理复杂Web应用交互、确保跨浏览器/设备兼容性，或从其他测试框架迁移过来的团队。
使用建议：对于全新的Web自动化项目，强烈推荐直接使用Playwright。对于维护良好的现有Cypress或Puppeteer项目，除非有强烈的迁移需求（如需要更好的性能、多浏览器支持或特定Playwright功能），否则不建议单纯为了切换而使用本Skill。
核心特点
与同类浏览器自动化工具相比，本Skill深度集成了Playwright MCP协议，允许在AI Agent工作流中直接、安全地驱动和控制真实浏览器，实现了自动化脚本与智能体决策的无缝结合。同时，它针对测试不稳定性（Flaky Tests）和复杂Web场景（如iframe、Shadow DOM、网络模拟）提供了开箱即用的解决方案和最佳实践指南。
注意事项
不适合用于维护现有的、运行良好的Cypress或Puppeteer测试套件，也不适用于仅需简单HTTP请求即可完成的任务。
常见问题
Playwright和Selenium/Cypress有什么区别？
Playwright由微软开发，支持多语言，内置自动等待和强大的录制工具，对现代Web框架（如SPA）支持更好，且通常执行速度更快。
这个Skill能用来做网页爬虫吗？
可以，尤其适合抓取需要JavaScript渲染的动态页面内容，因为它能完全模拟真实用户浏览器行为。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/playwright-automation-mcp-scraper/raw/index.md 读取 Playwright (Automation + MCP + Scraper) 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/playwright-automation-mcp-scraper/raw/index.md（查看排版版本）