Playwright (Automation + MCP + Scraper)

• JS 渲染頁面 — 您所需的內容僅在 JavaScript 執行後才存在（SPA、動態表格、延遲載入資料）。
• 多步驟瀏覽器工作流程 — 表單、登入流程、檔案上傳／下載，或依賴真實瀏覽器事件與 DOM 狀態的導航序列。
• 螢幕截圖、PDF 及視覺證據擷取 — 您需要從已渲染頁面取得像素精確的輸出，而非原始 HTML。
• Playwright 測試撰寫與除錯 — 編寫、執行或修復 @playwright/test 測試套件、追蹤 CI 間歇性失敗，或在有頭模式下重現 UI 錯誤。
• MCP 驅動的瀏覽器控制 — 代理程式的迴圈中已有 browser_* 工具，且您希望在不撰寫新自動化程式碼的情況下執行導航－點擊－填寫－截圖工作流程。

• 靜態 HTML 或簡單的 HTTP 回應已足夠 — 當頁面不需要 JavaScript 渲染時，直接使用 fetch 或 HTTP 技能會更快、更省成本，也更不容易出錯。
• 純 API 任務 — 若目標服務有正式文件化的 API，直接呼叫 API 會比驅動瀏覽器更為可靠。
• 擷取資料是唯一目標且非瀏覽器路徑可行 — 在啟動完整瀏覽器進行爬取之前，應優先考慮有文件化的 API 或純 HTTP 方式。

執行 npx @playwright/mcp --headless 以將 browser_navigate、browser_click、browser_type、browser_snapshot 等功能作為一流的工具動作公開。此路徑不需要任何新的自動化程式碼——代理程式直接透過 MCP 工具呼叫來驅動瀏覽器。

撰寫並執行直接的 Playwright 腳本（chromium.launch、page.goto、page.screenshot），或使用 npx playwright test 執行完整的 @playwright/test 測試套件。開箱即支援有頭模式執行、追蹤擷取、重試機制，以及平行工作執行緒。

使用 npx playwright codegen <url> 錄製互動操作並生成穩定的定位器。無需從原始碼中猜測選擇器，並可產生基於角色、標籤和文字的定位器，即使 DOM 發生輕微變更也能正常運作。

擷取整頁螢幕截圖、產生 PDF、記錄執行追蹤，以及下載檔案——全部可透過 MCP 工具操作或直接呼叫 Playwright (Automation + MCP + Scraper) API 來完成。產出的成果會保存在本機工作區或系統暫存目錄中。

此技能強制使用角色、標籤、文字與測試 ID 選擇器，取代脆弱的 CSS/XPath，並以網頁優先斷言取代原始指令檢查。內建的可操作性等待指引，有效防止不穩定的 sleep 計時技巧。

無隱藏檔案、持久性工作階段或未聲明的網路呼叫。身份驗證狀態為暫時性，除非明確重複使用。高風險的正式環境流程在繼續執行前，需要使用者明確確認。

針對本地或測試環境的應用程式，執行並擴充現有的 @playwright/test 測試套件。使用 npx playwright test --trace on 擷取 CI 失敗的產出物，再透過 trace viewer 與有頭模式重新執行來診斷不穩定的測試。

讓代理程式透過 browser_navigate、browser_type、browser_click 和 browser_snapshot 等 MCP 動作，自動瀏覽網站、填寫多步驟表單並擷取螢幕截圖——完全無需撰寫任何一行 Playwright (Automation + MCP + Scraper) 腳本。

導航至 JS 渲染的頁面，等待 DOM 穩定後，使用 browser_evaluate 或直接執行 Playwright 腳本來擷取結構化資料。當目標網站沒有 API，且內容僅在 JavaScript 執行後才會顯示時，此方法最為適用。適合搭配 Playwright (Automation + MCP + Scraper) 使用。

在有頭模式下使用 npx playwright test --headed 重現已回報的 UI 回歸問題，並搭配 --trace on 擷取追蹤記錄，接著檢查網路請求、主控台訊息與 DOM 快照，以找出根本原因，再著手撰寫修復方案。