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-11/raw/index.md 请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
‘帮我用Playwright写一个测试,登录到我们的管理后台,检查用户列表页面是否正常加载,并截一张图。’ 它会生成一个包含登录步骤、页面等待、元素断言和截图功能的完整Playwright测试脚本。或者,您可以说:‘这个按钮在Headless模式下点击没反应,帮我分析一下。’ AI会引导您使用force click选项、检查元素状态或查看Playwright跟踪报告来诊断问题。
介绍
本Skill旨在解决现代Web开发和测试中常见的浏览器自动化难题。当您的测试用例在CI环境或Headless模式下不稳定、超时或失败时,当定位器匹配到多个元素或错误元素时,当需要处理复杂的用户交互(如强制点击、文件上传下载、iframe、弹窗)时,当需要模拟设备、权限或进行可访问性检查时,它都能提供强大的支持。
通过集成Playwright的自动化能力,您可以直接驱动真实浏览器,执行端到端测试、调试UI问题、提取页面数据,并利用MCP协议进行更灵活的浏览器控制。它提供了丰富的API来处理网络请求模拟(HAR回放)、状态管理(如登录态)、跟踪报告生成以及测试套件的分片执行等。
该Skill非常适合需要处理复杂Web应用交互、进行可靠自动化测试或数据抓取的开发者与测试工程师。无论是前端开发验证UI逻辑,后端开发调试API与前端交互,还是测试工程师构建健壮的测试套件,都能从中受益。
使用建议:对于简单的HTTP请求获取,建议使用更轻量的工具(如curl或专门的HTTP请求库)。如果您现有的Cypress或Puppeteer测试套件运行良好且无迁移计划,则无需切换。在涉及大量JavaScript渲染的动态页面数据提取时,本Skill的优势尤为明显。
核心特点
与同类浏览器自动化工具相比,它深度集成了Playwright MCP协议,允许通过模型控制协议(MCP)直接、灵活地驱动真实浏览器,为AI Agent提供了原生的浏览器操控能力。同时,它针对测试中的“疑难杂症”(如Flaky测试、CI环境问题、复杂元素定位)提供了开箱即用的解决方案和最佳实践指导。
注意事项
不适用于维护现有的、运行良好的Cypress或Puppeteer测试套件,也不适合仅需发起简单HTTP请求即可完成的工作。
常见问题
这个Skill和直接用Playwright库有什么区别?
它封装了Playwright的常见用例和最佳实践,并通过MCP协议提供了AI Agent可直接调用的标准化浏览器控制接口,简化了集成和复杂场景的处理。
我能用它来抓取需要登录的网站数据吗?
可以,它支持使用storageState保存和复用登录状态,并能处理JavaScript渲染的页面,非常适合抓取动态Web应用的数据。
给 AI 助手的安装指引
如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:
请访问 https://321skill.com/skills/playwright-automation-mcp-scraper-x-11/raw/index.md 读取 Playwright (Automation + MCP + Scraper) 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址:/skills/playwright-automation-mcp-scraper-x-11/raw/index.md(查看排版版本)