Actor Playwright MCP

该项目通过Playwright-MCP提供了一个基于云端的无服务器Playwright浏览器服务，利用Playwright的可访问性树而非像素输入，实现快速、轻量的网页自动化操作。它支持结构化数据交互，适用于网页导航、表单填写、数据提取及自动化测试等场景。

浏览器自动化开发者工具 #浏览器自动化 #无服务器 #结构化数据 #网页交互 .TypeScript

评分 : 2分

下载量 : 28

更新时间 : 2025-04-28

什么是Playwright MCP Server?

这是一个基于Playwright的Model Context Protocol服务器，为LLM提供浏览器自动化能力。它通过可访问性树而非像素输入与网页交互，使AI能够理解网页结构并执行操作。

如何使用Playwright MCP Server?

1. 启动MCP服务器 2. 通过API发送指令 3. 接收结构化响应 4. 根据快照决定后续操作

适用场景

适用于需要程序化网页交互的场景，如自动化测试、数据采集、AI助手等

主要功能

快照交互通过可访问性树获取网页结构化表示

视觉交互支持基于坐标的屏幕操作

标签页管理多标签页创建/切换/关闭

优势与局限性

优势

轻量快速：使用结构化数据而非图像处理

确定性操作：避免视觉模型的模糊性

完整功能：支持点击、输入、拖拽等完整交互

局限性

无法处理纯图像内容

需要元素引用才能执行操作

对动态内容支持有限

如何使用

获取页面快照

首先使用browser_snapshot获取当前页面的结构化表示

识别目标元素

从快照中找到要交互的元素及其ref值

执行操作

使用相应工具函数进行操作，如点击或输入

使用案例

自动填写表单自动识别并填写网页表单字段

数据抓取从结构化页面提取特定数据

常见问题

为什么需要元素引用(ref)?

如何处理动态加载的内容?

🚀 Playwright 命令集

本项目提供了一系列基于 Playwright 的命令，用于自动化测试、网页操作等场景，涵盖了角色管理、导航、键盘操作等多种功能。

✨ 主要特性

提供基于角色的操作命令，方便管理不同角色。
包含丰富的导航、键盘、控制台等操作命令。
支持文件上传、PDF 保存等文件和媒体处理功能。
具备实用工具命令，如关闭浏览器、调整窗口大小等。

📚 详细文档

🔍 基于角色的命令

命令	描述	参数
`robot role_name`	使用指定的角色执行后续操作。	`role_name`：要使用的角色名。
`robot list`	列出所有可用的角色。	无
`robot remove`	移除指定的角色。	`role_name`：要移除的角色名。

🔍 导航命令

命令	描述	参数
`navigate url`	导航到指定的 URL。	`url`：目标 URL。
`navigate back`	返回上一页。	无
`navigate forward`	前进到下一页。	无

🔍 键盘命令

命令	描述	参数
`keyboard key`	按下指定的键。	`key`：要按下的键名（例如 `ArrowLeft` 或 `a`）。

🔍 控制台命令

命令	描述	参数
`console messages`	返回所有控制台消息。	无

🔍 文件和媒体处理

命令	描述	参数
`file_upload paths`	上传指定的文件或多个文件。	`paths`：要上传的文件绝对路径列表（单个或多个）。
`pdf_save`	将当前页面保存为 PDF 文件。	无

🔍 实用工具

命令	描述	参数
`browser_close`	关闭浏览器窗口。	无
`browser_wait time`	等待指定的时间（以秒为单位）。	`time`：等待时间，以秒为单位。
`browser_resize width height`	调整浏览器窗口大小。	`width`：新宽度（通常以像素为单位）；`height`：新高度（通常以像素为单位）。

🔍 其他命令

命令	描述	参数
`system clear`	清空终端屏幕或控制台窗口。	无
`system pause`	暂停脚本执行，等待用户输入继续。	`prompt`（可选）：显示的提示信息，默认为 `Press Enter to continue...`。