SuperAPI AI 工具集

browser-automation

编程与开发

查看项目

更新于 10-15 20:13

技能介绍

本技能提供使用 Playwright MCP 服务器进行浏览器自动化的常见模式,通过无障碍树进行元素交互,比基于截图的方式更可靠、更具语义。MCP 服务器通过 npx @playwright/mcp@latest 运行,相关工具可在 Claude Code 界面中调用。

用途:网页测试、数据抓取、导航与表单交互、跨浏览器测试自动化、网络请求监控与模拟。

主要能力: 导航:page.goto 支持 waitUntil(如 networkidle)、waitForSelector、waitForLoadState(domcontentloaded/load/networkidle)、Cookie 认证状态设置、处理重定向与弹窗。 表单填写:文本输入 fill/type(可设 delay)、下拉选择 selectOption(按值、标签、索引、多选)、复选框与单选 check/uncheck/isChecked、文件上传 setInputFiles。 数据提取:textContent、innerText、$$eval 提取多元素、getAttribute、$eval 提取属性集合、结构化表格与列表提取、分页与无限滚动处理。 元素交互:click(含右键、双击、force)、hover、focus、键盘按键与组合键、dragAndDrop 或手动拖放、等待元素出现/可见/隐藏、元素状态检查(可见、启用、可编辑、计数)。 无障碍定位:getByRole、getByLabel、getByText、getByTitle、getByAltText。

必要用法:服务通过 npx @playwright/mcp@latest 启动;实践中优先使用语义选择器(如 button[data-testid="submit"] 或 getByRole),避免脆弱的结构化选择器;优先显式等待(waitForLoadState、waitForSelector)而非固定 waitForTimeout。

适用场景:登录流程自动化、表单验证测试、动态内容与 AJAX 等待、分页抓取。

限制:资料未提供具体收费、价格、平台兼容范围或效果保证;需注意目标站点的使用条款与合规要求。