SuperAPI AI 工具集

playwright-mcp

智能体与模型

查看项目

更新于 10-16 04:59

技能介绍

用途:该技能提供一个基于 Playwright 的 MCP 服务器,用于浏览器自动化,可通过 MCP 协议以编程方式控制网页,适合网页抓取、UI 测试、动态表单提交等场景,尤其适用于 CI/CD 流水线、JavaScript 重度页面的数据提取以及跨页面模拟用户操作。

主要能力:启动 Chromium、Firefox 等浏览器并管理会话;选择、点击、输入页面元素,如 page.click('button');自动填充并提交表单,如 page.fill('input[name="username"]', 'user123');支持异步等待元素,如 page.waitForSelector('selector');具备带超时的重试式导航;可通过 JSON 配置,如 {"browser": "chromium", "headless": true}。

使用方式:启动 MCP 服务器后由 OpenClaw 发送命令,需通过 $PLAYWRIGHT_MCP_API_KEY 进行认证。CLI 示例:playwright-mcp start --port 8080 --headless,加 --debug 输出详细日志。API 示例:向 /mcp/execute 发送 JSON,如 {"action": "navigate", "url": "https://example.com"};元素交互使用 /mcp/interact,如 {"selector": "#id", "action": "click"}。配置可用 YAML 或 JSON,如 {"timeout": 30000, "retries": 3},通过 --config path/to/config.json 传入。集成时可作为子进程或 HTTP 客户端运行,实时更新可用 /mcp/ws,需 Node.js 14+,跨域可加 --allow-origins *。

限制与错误处理:常见错误包括超时和选择器失败,可在操作前使用 page.waitForTimeout(5000);API 错误码 404 表示端点无效、500 表示服务器问题;认证失败需检查 $PLAYWRIGHT_MCP_API_KEY,限流 429 可用指数退避重试。建议用 try-catch 包裹调用并开启 --debug 记录错误。依赖 playwright-core 与 mcp-server。