playwright-cli 是什麼、怎麼安裝使用：微軟官方的 Playwright 命令行 + Skills，讓編程智能體省着 token 操作瀏覽器

本文根據 microsoft/playwright-cli 倉庫 README 整理，資料核對於 2026-10-11。截至當日，GitHub 顯示該倉庫約 1.4 萬 Star、769 Fork，最近一次推送在 2026-09-28；skills.sh 榜單上 playwright-cli 技能累計安裝約 18.0 萬次。命令以倉庫 README 為準。

是什麼

Playwright 是微軟開源的瀏覽器自動化框架。讓智能體操作瀏覽器，此前常見的做法是接 Playwright MCP；playwright-cli 是同一個團隊給出的另一條路：把瀏覽器操作做成命令行，再配上一份技能說明，讓智能體像敲普通命令一樣驅動瀏覽器。

README 開頭專門對比了兩者。CLI + Skills 更省 token：不用把很大的工具定義和冗長的頁面無障礙樹加載進模型上下文，智能體通過簡短、專用的命令行動，適合既要操作瀏覽器、又要在有限的上下文裏兼顧大型代碼庫和測試的編程智能體。MCP 仍適合需要持久狀態、對頁面結構反覆推理的場景，如探索式自動化、自愈測試和長時間自主運行的流程。README 的結論是：用編程智能體的話，CLI 是更合適的選擇。

包含哪些內容

這個倉庫對外只有一個技能（skills.sh 上名為 playwright-cli），背後是一整套命令。README 按類別列出：

• 核心操作：打開頁面、點擊、輸入、勾選、截圖等；
• 導航、鍵盤、滑鼠；
• 另存為：把頁面儲存成 PDF 等；
• 標籤頁管理；
• 存儲：Cookie、LocalStorage、SessionStorage 的讀寫；
• 模擬（裝置、環境）與網絡；
• 開發者工具相關命令；
• 快照：取頁面或單個元素的結構快照，可限制深度、帶上元素的位置框，也可以在大快照裏按文本或正則搜尋；
• 元素定位：先取帶引用編號的快照，再用引用操作；也支持 CSS 選擇器、角色定位和測試標識。

會話方面：預設無頭運行，加 --headed 可以看到瀏覽器窗口；瀏覽器配置預設只在內存裏，同一會話的多次調用之間保留 Cookie 和存儲，關閉後丟失，加 --persistent 才寫入磁盤；用 -s=名稱 可以給不同項目開各自的瀏覽器實例。

怎麼安裝

需要 Node.js 18 或更高版本。命令來自 README：

bash
npm install -g @playwright/cli@latest
playwright-cli install --skills

第一條裝命令行，第二條把技能裝到本機，Claude Code、GitHub Copilot 等會使用本地安裝的技能。README 還提到「不裝技能」的用法：直接告訴智能體用 playwright-cli，並讓它先看 playwright-cli --help。

怎麼用

• README 的演示：「用 playwright 技能測試 https://demo.playwright.dev/todomvc/ ，把成功和失敗的場景都截圖」。
• 「啟動本地開發伺服器，打開登入頁，用測試帳號走一遍登入流程，看控制台有沒有報錯」。
• 「打開這個頁面，取表單區域的快照，告訴我提交按鈕為什麼點不了」。

你也可以自己手動敲同樣的命令，看智能體在做什麼。

適合誰 / 不適合誰

適合：

• 用 Claude Code、Copilot 等做前端開發，想讓智能體自己驗證頁面行為的人；
• 覺得瀏覽器類 MCP 太占上下文的人。

不適合：

• 需要長時間保持瀏覽器狀態、反覆分析頁面結構的自主流程，README 建議這類場景繼續用 MCP；
• 想寫成可維護的自動化測試套件的需求——那應該直接寫 Playwright 測試代碼，CLI 更偏交互式的探索和調試。

注意事項

• 許可：Apache-2.0。
• 會在本機啟動瀏覽器並訪問網頁（預設無頭）：用它訪問的頁面內容會進入模型上下文，網頁上的文字可能包含誘導智能體的指令，訪問不可信站點時要留意。
• 登入態：持久化會話會把 Cookie 寫到磁盤。在自己的應用上用測試帳號沒問題；不要讓智能體帶着你的真實帳號登入態去操作第三方網站。
• 只對你有權測試的站點使用，遵守目標網站的服務條款。