Discover MCPs & agents
Loading MCPs and agents…
Loading MCPs and agents…
一个功能强大的浏览器自动化技能,基于 Playwright 构建,通过 MCP 协议为 OpenClaw 提供 101 完整的浏览器操作能力。OpenClaw skill for browser automation using Playwright - 101 tools for complete browser control
From the repo.
一个功能强大的浏览器自动化技能,基于 Playwright 构建,通过 MCP 协议为 OpenClaw 提供 101 个完整的浏览器操作能力。
中文文档 | English
最简单的安装方式! 下载预编译的独立包,无需构建,开箱即用。
Windows 用户:
auto-deploy.cmd(推荐)或 auto-deploy.ps1注意: 推荐使用 .cmd 文件,大部分 Windows 电脑默认禁止运行 PowerShell 脚本。
Mac/Linux 用户:
tar -xzf playwright-browser-skill-macos-linux-v2.1.0.tar.gzchmod +x auto-deploy.sh && ./auto-deploy.sh发行版优势:
npm install,节省时间# 克隆仓库
git clone https://github.com/91fapiao-cn/playwright-browser-skill.git
cd playwright-browser-skill
# 安装依赖
npm install
# 安装浏览器驱动
npm run install-browsers
# 构建项目
npm run build
我们提供了跨平台的自动部署脚本,支持中英文版本,可以自动检测 OpenClaw 配置路径并完成所有配置:
# 中文版
.\auto-deploy.ps1
# 英文版
.\auto-deploy-en.ps1
# 跳过构建(如果已构建)
.\auto-deploy.ps1 -SkipBuild
# 指定自定义路径
.\auto-deploy.ps1 -OpenClawPath "C:\custom\path\.openclaw"
REM 中文版
auto-deploy.cmd
REM 英文版
auto-deploy-en.cmd
REM 跳过构建
auto-deploy.cmd --skip-build
REM 指定自定义路径
auto-deploy.cmd --openclaw-path "C:\custom\path\.openclaw"
# 添加执行权限(首次使用)
chmod +x auto-deploy.sh auto-deploy-en.sh
# 中文版
./auto-deploy.sh
# 英文版
./auto-deploy-en.sh
# 跳过构建
./auto-deploy.sh --skip-build
# 指定自定义路径
./auto-deploy.sh --openclaw-path "/custom/path/.openclaw"
自动部署功能:
📖 查看详细部署文档
如果需要手动部署,请参考以下步骤:
# Windows
copy skill-package\skills\SKILL.md %USERPROFILE%\.openclaw\skills\playwright-browser\
# macOS/Linux
cp skill-package/skills/SKILL.md ~/.openclaw/skills/playwright-browser-skill/
在 ~/.openclaw/settings/mcp.json 中添加:
{
"mcpServers": {
"playwright-browser": {
"command": "node",
"args": ["<项目路径>/dist/mcp-server.js"],
"disabled": false,
"autoApprove": ["browser_launch", "browser_goto", "browser_close"]
}
}
}
重启 OpenClaw 以加载新的技能。
重启后,在 OpenClaw 对话中输入:
请使用 Playwright Browser Skill 技能来访问互联网和控制浏览器
或者直接测试:
使用 Playwright Browser Skill 启动浏览器并访问 example.com
这样 OpenClaw 就会知道使用这个技能来处理所有浏览器相关的任务。
browser_launch - 启动浏览器browser_close - 关闭浏览器browser_new_page - 创建新页面browser_switch_page - 切换页面browser_goto - 导航到URLbrowser_go_back - 返回上一页browser_go_forward - 前进browser_reload - 刷新页面browser_click - 点击元素browser_fill - 填写表单browser_type - 输入文本browser_select - 选择下拉框browser_get_text - 获取文本browser_get_html - 获取HTMLbrowser_get_links - 获取链接浏览器支持两种运行模式:
有界面模式(headless: false) - 推荐用于调试和开发
browser_launch({ "headless": false }) // 显示浏览器窗口
无头模式(headless: true) - 推荐用于生产环境和自动化
browser_launch({ "headless": true }) // 后台运行,不显示窗口
// 或者省略参数,默认为无头模式
browser_launch()
无头模式优势:
// 1. 启动浏览器(有界面模式,便于观察)
browser_launch({ "headless": false })
// 2. 访问网页
browser_goto({ "url": "https://example.com" })
// 3. 获取标题
browser_get_title()
// 4. 截图
browser_screenshot({ "path": "screenshot.png", "fullPage": true })
// 5. 关闭浏览器
browser_close()
// 无头模式运行,适合自动化任务
browser_launch({ "headless": true })
browser_goto({ "url": "https://example.com" })
browser_get_title()
browser_screenshot({ "path": "screenshot.png" })
browser_close()
// 使用有界面模式便于调试
browser_launch({ "headless": false })
browser_goto({ "url": "https://example.com/login" })
browser_fill({ "selector": "#username", "value": "user@example.com" })
browser_fill({ "selector": "#password", "value": "password123" })
browser_click({ "selector": "button[type='submit']" })
browser_wait_for_selector({ "selector": ".dashboard" })
browser_close()
// 数据抓取推荐使用无头模式,速度更快
browser_launch({ "headless": true })
browser_goto({ "url": "https://example.com/products" })
browser_count({ "selector": ".product-item" })
browser_get_links()
browser_evaluate({
"script": "Array.from(document.querySelectorAll('.price')).map(e => e.textContent)"
})
browser_close()
# 运行所有测试
npm test
# 运行基础测试
npm run test:basic
# 运行高级测试
npm run test:advanced
# 运行交互测试
npm run test:interaction
# 运行MCP服务器测试
npm run test:mcp
playwright-browser-skill/
├── src/
│ ├── index.ts # 核心功能实现
│ ├── mcp-server.ts # MCP 服务器
│ └── tools-registry.ts # 工具注册表
├── skill-package/
│ ├── skills/
│ │ └── SKILL.md # 技能定义文件
│ └── settings/
│ └── mcp.json # MCP 配置示例
├── test/ # 测试文件
├── examples/ # 示例代码
└── docs/ # 文档
# 开发模式(监听文件变化)
npm run dev
# 生产构建
npm run build
| 平台 | 状态 | 说明 |
|---|---|---|
| Windows 10/11 | ✅ 完全支持 | 已测试 |
| macOS | ✅ 完全支持 | 理论支持 |
| Linux | ✅ 完全支持 | 理论支持 |
欢迎贡献!请查看 贡献指南。
MIT License - 详见 LICENSE 文件
如果这个项目对你有帮助,请给它一个 Star!
Made with ❤️ for OpenClaw Community
Replace {MCP_ENDPOINT_URL} with this MCP’s endpoint URL (from its repo or docs above). No API key — you connect directly.
Tool
OS
Config file: ~/.cursor/mcp.json
{
"mcpServers": {
"mcp-server": {
"url": "{MCP_ENDPOINT_URL}"
}
}
}Paste into mcpServers in the config file. Restart Cursor after saving.
If this MCP is also published on mcpchannel.ai, you can subscribe from Browse and use the gateway config there instead.