browser-automation

name	browser-automation
description	当需要操作浏览器、自动化网页交互、测试 Web UI 或爬取动态网页时，必须立刻阅读我。

Browser Automation

推荐安装流程

先查看当前 MCP：

config "mcp ls"

如果没有 Playwright MCP，添加配置：

config "mcp add playwright -- npx -y @playwright/mcp@latest"

启用并让 PAI 托管启动：

config "mcp enable playwright"

启用后查看工具：

config "mcp tools playwright"

核心规则

• 浏览器自动化优先使用 Playwright MCP。
• 不要用 shell/exec 或普通 CLI 启动浏览器自动化实例。
• 如果当前没有可用的 Playwright MCP，先引导安装和部署它。
• 安装、启用、停用 MCP 时优先使用 config 工具，不要直接手改工作区 JSON。
• 如果缺 Node.js、网络、权限或用户确认，直接说明阻塞点。

为什么不能用 shell/CLI 控制浏览器

PAI 的 shell/exec 适合一次性命令、检查环境、读写文件和运行短任务。 浏览器自动化需要维持同一个浏览器实例、页面上下文、cookie/storage 和交互状态。 一次性 shell/CLI 调用结束后，后续工具调用无法稳定复用这个浏览器实例，因此会丢失页面状态或无法继续操作。 这类能力应交给 MCP 运行态管理，由 PAI 维持可持续调用的工具服务。

不要这样做：

npx @playwright/mcp@latest

也不要让 shell 长期挂着一个后台浏览器、dev server 或 MCP server。 这类进程无法稳定维持跨工具调用的实例，也无法纳入 PAI 的工具目录、权限控制和 reload 生命周期。

使用方式

Playwright MCP 可用后，优先通过 MCP 工具完成：

• 打开页面。
• 获取页面快照。
• 点击、填写、选择、上传文件。
• 等待页面状态变化。
• 截图或提取页面文本。
• 验证 Web UI 行为。

每次页面跳转或重要 DOM 变化后，都应重新获取页面快照，再继续交互。

排障

• config "mcp enable playwright" 后工具还没出现时，先等启动探测完成，再执行 config "mcp tools playwright"。
• 如果 Node.js 不存在，先安装 Node.js。
• 如果 npm 下载失败，说明网络或 registry 问题。
• 如果浏览器依赖缺失，按 Playwright MCP 返回的错误补依赖。
• 如果用户要求删除或停用 Playwright MCP，必须先得到明确同意；删除命令还需要 --confirmed。