SuperAPI AI 工具集

browsing-with-playwright

通用与其它

查看项目

更新于 10-16 03:15

技能介绍

用途:通过 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 等待文本或时间、browser_evaluate 执行 JavaScript,以及 browser_run_code 运行多步 Playwright 代码。

使用方式:先启动服务器,推荐 bash scripts/start-server.sh,或手动 npx @playwright/mcp@latest --port 8808 --shared-browser-context &。必须带 --shared-browser-context 以在多次 mcp-client.py 调用间保持浏览器状态。调用示例:python3 scripts/mcp-client.py call -u http://localhost:8808 -t browser_navigate -p '{"url": "https://example.com"}'。停止时先关闭浏览器再结束进程:python3 scripts/mcp-client.py call -u http://localhost:8808 -t browser_close -p '{}',然后 pkill -f "@playwright/mcp",或使用 bash scripts/stop-server.sh。

适用场景:表单提交(导航、快照取 ref、填字段、提交、等待确认、截图)与数据提取(导航、快照、必要时用 browser_evaluate 复杂提取)。

限制与注意:元素找不到时先运行 browser_snapshot 获取最新 ref;点击失败可先 browser_hover;表单不提交可在 browser_type 中加 "submit": true;页面加载慢可增加等待或使用 browser_wait_for;服务器无响应则停止并重启。任务结束应停止服务器,长时间多任务可保持运行,出错无响应时停止重启。验证可运行 python3 scripts/verify.py,预期输出 ✓ Playwright MCP server running;失败时用 pgrep -f "@playwright/mcp" 诊断,仍失败应停止并报告,不要继续后续步骤。完整工具文档见 references/playwright-tools.md。