SuperAPI AI 工具集

browsing-with-playwright

测试与质量

查看项目

更新于 10-16 01:17

技能介绍

用途:通过 Playwright MCP 服务器自动化浏览器交互,适合需要网页导航、表单填写、元素点击、截图和数据提取的任务。

主要能力:导航(browser_navigate、browser_navigate_back)、获取页面状态(browser_snapshot 返回可点击/输入的元素 ref、browser_take_screenshot)、元素交互(browser_click、browser_type、browser_fill_form、browser_select_option)、等待条件(browser_wait_for)、执行 JavaScript(browser_evaluate)以及多步原子操作(browser_run_code)。

使用方式:先启动服务器,推荐 bash scripts/start-server.sh,或手动 npx @playwright/mcp@latest --port 8808 --shared-browser-context &。停止时用 bash scripts/stop-server.sh,或先调用 browser_close 再 pkill -f "@playwright/mcp"。调用通过 python3 scripts/mcp-client.py call -u http://localhost:8808 -t <工具名> -p '<JSON参数>'。注意 --shared-browser-context 标志必需,否则每次调用都会得到全新的浏览器上下文。交互前先用 browser_snapshot 获取元素 ref,再据此点击或输入。

适用场景:表单提交(导航→快照→填表→提交→等待确认→截图)与数据提取(导航→快照→必要时用 browser_evaluate 复杂提取→处理结果)。

限制与排查:元素找不到时先重新快照;点击失败可先 hover;表单未提交可在 browser_type 中加 "submit": true;页面未加载可增加等待时间;服务器无响应则停止并重启。可用 python3 scripts/verify.py 验证,失败时用 pgrep -f "@playwright/mcp" 诊断,仍失败应停止并报告,不要继续后续步骤。完整工具文档见 references/playwright-tools.md。其他细节暂未提供。