Playwright (Automation + MCP + Scraper)
基于Playwright的浏览器自动化、测试与调试工具，支持MCP控制。
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：Playwright (Automation + MCP + Scraper)。 它的用途是：基于Playwright的浏览器自动化、测试与调试工具，支持MCP控制。 完整的 Skill 内容见：https://321skill.com/skills/playwright-automation-mcp-scraper-x-4/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
‘我的一个Playwright测试在CI上总是超时失败，但在本地运行正常，帮我分析一下可能的原因并修复。’ 它会引导你检查Headless模式差异、网络空闲条件，并建议启用trace录制或在CI中调整超时设置与资源限制。或者，
对AI说：‘我需要从页面的Shadow DOM里提取数据，但定位器总是失效。’ 它会指导你使用Playwright特有的穿透Shadow DOM的定位语法，并编写可靠的提取代码。
介绍
本Skill旨在解决现代Web开发与测试中复杂的浏览器自动化难题。当你的端到端测试在CI环境或Headless模式下不稳定、超时或失败时，当定位器匹配到多个元素或错误元素时，当需要处理强制点击、等待逻辑失效、网络状态永不空闲等棘手场景时，它都能提供强大的解决方案。
它通过Playwright提供了一套完整的自动化能力，包括智能定位器、自动等待、追踪录制、CI集成以及通过MCP协议控制真实浏览器。你可以用它来模拟登录状态、拦截和重放网络请求、处理文件上传下载、操作iframe和Shadow DOM、管理弹窗对话框、进行跨机器截图对比、生成追踪报告，甚至模拟设备和权限、进行无障碍检查等。
它非常适合需要处理复杂Web交互、进行可靠自动化测试或从其他测试框架（如Cypress、Puppeteer、Selenium）迁移到Playwright的开发者。无论是前端开发、测试工程师还是全栈开发，只要涉及浏览器自动化，都能从中受益。
使用建议：在遇到特定浏览器交互问题（如元素定位、异步等待）时，可以优先使用此Skill进行调试和脚本编写。注意，它不适合维护现有的Cypress或Puppeteer测试套件，也不适用于简单的HTTP请求场景（这些场景有更轻量的工具）。
核心特点
与同类浏览器自动化Skill相比，它深度集成了Playwright MCP协议，可直接在AI Agent环境中驱动和控制真实浏览器，而不仅仅是生成代码。同时，它针对测试中的‘疑难杂症’（如Flaky测试、CI环境失败、复杂元素定位）提供了场景化的解决方案，而非通用的自动化指令。
注意事项
不适合维护现有的Cypress或Puppeteer测试套件，也不适用于简单的HTTP请求场景。
常见问题
Playwright和Selenium/Cypress有什么区别？
Playwright由微软开发，支持多浏览器且无需额外驱动，自动等待机制更可靠，原生支持现代Web特性（如网络拦截、移动端模拟），并提供了MCP等更现代的集成方式。
这个Skill能帮我从Cypress迁移到Playwright吗？
是的，它专门提到了用于将Cypress、Puppeteer或Selenium套件移植到Playwright的场景，可以提供迁移相关的指导和自动化支持。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/playwright-automation-mcp-scraper-x-4/raw/index.md 读取 Playwright (Automation + MCP + Scraper) 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/playwright-automation-mcp-scraper-x-4/raw/index.md（查看排版版本）