Actor Playwright MCP

該項目通過Playwright-MCP提供了一個基於雲端的無服務器Playwright瀏覽器服務，利用Playwright的可訪問性樹而非像素輸入，實現快速、輕量的網頁自動化操作。它支持結構化數據交互，適用於網頁導航、表單填寫、數據提取及自動化測試等場景。

瀏覽器自動化開發者工具 #瀏覽器自動化 #無服務器 #結構化數據 #網頁交互 .TypeScript

評分 : 2分

下載量 : 20

更新時間 : 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...`。