Playwright MCP — 浏览器自动化
v1.0.0通过 Playwright MCP 服务器实现浏览器自动化。支持导航网站、点击元素、填写表单、提取数据、截图和完整的浏览器自动化工作流。
115· 3.4万·495 当前·523 累计
by @spiceman161运行时依赖
OSLinux · macOS · Windows
安装命令
点击复制官方npx clawhub@latest install playwright-mcp
镜像加速npx clawhub@latest install playwright-mcp --registry https://cn.longxiaskill.com 镜像可用
本土化适配说明
Playwright MCP — 浏览器自动化 安装说明： 安装命令：["openclaw skills install playwright-mcp"] 支持国内镜像加速，使用 --registry https://cn.longxiaskill.com 参数可加速下载
技能文档
浏览器自动化技能
基于 Playwright MCP 服务器的浏览器自动化工具。支持程序化控制 Chrome、Firefox 或 WebKit 浏览器。
安装
npm install -g @playwright/mcp
# 或
npx @playwright/mcp
首次安装浏览器：
npx playwright install chromium
快速开始
STDIO 模式启动 MCP 服务器
npx @playwright/mcp
带选项启动
# 无头模式 npx @playwright/mcp --headless# 指定浏览器 npx @playwright/mcp --browser firefox
# 设置视口大小 npx @playwright/mcp --viewport-size 1280x720
# 忽略 HTTPS 错误 npx @playwright/mcp --ignore-https-errors
常用场景
1. 导航和提取数据
可用的 MCP 工具：
browser_navigate: 打开 URLbrowser_click: 点击元素browser_type: 输入文本browser_select_option: 选择下拉选项browser_get_text: 提取文本内容browser_evaluate: 执行 JavaScriptbrowser_snapshot: 获取页面结构browser_close: 关闭浏览器
2. 表单交互
browser_navigate到表单 URLbrowser_type输入字段browser_click提交browser_get_text验证结果
3. 数据提取
browser_navigate到页面browser_evaluate运行提取脚本- 解析返回的 JSON 数据
MCP 工具参考
| 工具 | 描述 |
|---|---|
| browser_navigate | 导航到 URL |
| browser_click | 通过选择器点击元素 |
| browser_type | 输入文本到输入框 |
| browser_select_option | 选择下拉选项 |
| browser_get_text | 获取文本内容 |
| browser_evaluate | 执行 JavaScript |
| browser_snapshot | 获取可访问的页面快照 |
| browser_close | 关闭浏览器上下文 |
| browser_choose_file | 上传文件 |
| browser_press | 按键盘键 |
配置选项
安全设置
--allowed-hosts example.com,api.example.com
--blocked-origins malicious.com
--ignore-https-errors
浏览器设置
--browser chromium|firefox|webkit
--headless
--viewport-size 1920x1080
--user-agent "自定义代理"
超时设置
--timeout-action 10000 # 操作超时（毫秒）
--timeout-navigation 30000 # 导航超时（毫秒）
使用建议
- 首次使用前安装浏览器：运行
npx playwright install - 无头模式：服务器环境建议使用
--headless - 安全配置：使用
--allowed-hosts限制可访问的域名 - 错误处理：设置合理的超时时间避免长时间等待