前言¶
寫自動化腳本時，最麻煩的往往不是「點哪個按鈕」，而是把瀏覽器操作拆成一串命令：等元素出現、定位、點擊、填表、截圖、判斷結果。換到 Agent 場景裏，這套動作更希望由模型自己按頁面狀態決定下一步，而不是人提前把每一步寫死。
Clawhub Playwright Mcp 就是針對這個需求的 Skill：它把 Playwright MCP server 包裝成 Agent 可調用的能力，讓 Agent 能導航網站、點擊元素、填寫表單、抽取數據、截圖，串成完整的瀏覽器自動化流程。下面按「這是什麼 → 有哪些能力 → 怎麼啓用 → 怎麼用 → 有什麼要注意的」來講。
這是什麼¶
一句話定位：一個面向 Agent 的瀏覽器自動化 Skill，底層是 Playwright MCP server，負責把瀏覽器操作暴露成工具調用。
出品與歸屬信息來自 SkillHub 頁面：
- 座標：
@user_f12a44b7/clawhub-playwright-mcp - 發佈者：
user_f12a44b7 - 來源：
community（社區提交，非官方團隊出品） - 版本：
1.0.0 - 分類：
ai-agent - 標籤：
requires_api_key=false - 評分：100000；下載：915；安裝：0
版本號停在 1.0.0，安裝數目前爲 0，說明它在 SkillHub 上還很新，社區裏用的人不多，遇到問題基本要靠自己看 Playwright MCP 的上游文檔。
它要解決的問題是：Agent 本身沒有瀏覽器能力，直接給模型一個 URL，它既看不到頁面結構，也點不了按鈕。通過 MCP server 把 Playwright 的操作能力以工具形式暴露出去，模型就能按任務目標逐步驅動瀏覽器，而不是靠猜測頁面內容。
核心功能¶
頁面給出的能力描述如下，逐條列出：
- 導航網站（Navigate websites）
- 點擊元素（click elements）
- 填寫表單（fill forms）
- 抽取數據（extract data）
- 截圖（take screenshots）
- 完成完整瀏覽器自動化工作流（perform full browser automation workflows）
這裏有幾個點值得說明，避免期望跑偏：
- 前五條是原子操作，第六條是它們的組合方式。Skill 本身不提供新的自動化引擎，它複用的是 Playwright MCP server，因此穩定性取決於上游 Playwright 與目標網站的對抗程度。
requires_api_key=false表示調用這套能力不需要單獨配置 API Key。但瀏覽器自動化仍會消耗模型側的 Token，另外如果要訪問需要登錄的網站，Cookie 或賬號狀態仍需另行準備。- 能力列表裏沒有提到瀏覽器會話管理、多標籤頁、文件下載處理、驗證碼應對等擴展功能，這些不要默認具備。
安裝與啓用¶
SkillHub 頁面提供了座標與官方頁面，但抓取到的資料裏沒有給出具體的 CLI 安裝命令、配置文件字段或目錄路徑。因此下面只列出已經覈實的入口信息，命令部分留空，不要照着別處的通用寫法硬填。
已覈實信息：
Skill 頁面：https://www.skillhub.cn/skills/user_f12a44b7/clawhub-playwright-mcp
官方地址：https://api.skillhub.cn/user_f12a44b7/clawhub-playwright-mcp
座標：@user_f12a44b7/clawhub-playwright-mcp
分類：ai-agent
來源：community
版本：1.0.0
實際啓用時，建議按下面順序確認，再決定怎麼接：
- 打開上面的 Skill 頁面，確認版本、能力描述與你當前 Agent 環境匹配。
- 確認運行環境已能運行 Playwright MCP server（瀏覽器可正常啓動、Playwright 依賴可用）。Skill 只負責把 Playwright MCP 接進來，不負責安裝瀏覽器運行時。
- 在 Agent 的 Skill 配置裏引用該座標，加載後檢查瀏覽器相關工具是否出現在可調用工具列表中。
- 用一個只讀頁面（例如公開文檔站）做首次連通性驗證，確認導航與截圖正常，再接入需要寫操作的網站。
Cursor、Codex CLI、Claude Code 三者的差異，抓取到的資料中沒有分別說明，這裏不做推測。如果需要確認某個客戶端的具體配置方式，去 SkillHub 頁面或該 Skill 的提交內容裏覈對。
典型用法¶
Skill 頁面只提供了能力描述，沒有附帶腳本示例。下面的示例按 Playwright MCP server 的通用工具命名寫成，用於說明調用形態，具體工具名以你實際加載到的工具列表爲準。
導航到目標頁面：
browser_navigate(url="https://example.com/docs")
這步執行後，Agent 拿到的是當前頁面狀態，後續操作都基於這個狀態展開。
讀取頁面結構，決定點擊目標：
browser_snapshot()
拿到可交互元素的列表和引用，再執行點擊或填寫：
browser_click(ref="@e12")
browser_fill(ref="@e18", value="search keyword")
抽取數據並留檔：
browser_take_screenshot()
組合成完整流程時，通常是「導航 → 快照 → 點擊 → 填寫 → 提交 → 等待結果 → 截圖 → 抽取數據」，中間每一步都根據上一步返回的頁面狀態決定下一步動作，而不是一次性把整條路徑寫死。
適用場景與注意¶
適合的場景：
- 需要跨頁面採集結構化數據，例如把列表頁和詳情頁的信息彙總成表格。
- 需要驗證一條用戶路徑是否走得通，例如從登錄到提交表單。
- 需要對頁面變化做留檔，用截圖和文本快照做對比。
- Agent 需要在一個真實瀏覽器裏完成多步操作，而人不方便逐條編寫選擇器。
要注意的限制：
- 反爬與驗證碼：Playwright 驅動的是真實瀏覽器，但遇到驗證碼、風控、行爲校驗時仍可能被攔，Skill 未聲明具備繞過能力。
- 頁面變更：選擇器和元素引用與頁面結構強相關，站點改版後需要重新跑一遍流程確認。
- 等待與穩定性：頁面加載、異步渲染、彈窗都可能讓操作失敗，實際使用中需要加入重試或狀態確認，不要假設一次調用就能成功。
- 合規邊界：只操作你有權限訪問的站點，注意目標網站的服務條款與機器人使用限制，批量抓取前先確認許可。
- 版本與維護：當前版本 1.0.0，社區來源，安裝數爲 0，遇到環境適配問題可能需要自己排查或向上遊 Playwright MCP 項目求助。
小結¶
Clawhub Playwright Mcp 的價值在於把 Playwright MCP server 的能力以 Skill 形式交給 Agent，讓瀏覽器操作變成可調用的工具，而不是人工編寫的腳本。它適合需要真實瀏覽器驅動的自動化任務，但能力邊界就是上游 Playwright MCP，穩定性和適配成本需要自己承擔。
官方地址：https://api.skillhub.cn/user_f12a44b7/clawhub-playwright-mcp
Skill 頁面：https://www.skillhub.cn/skills/user_f12a44b7/clawhub-playwright-mcp
