Chrome Devtools

🔎 2026 跨節點數據探測：搜尋預設策略

當任務是「搜尋網頁、找資料、查即時公開資訊」時，不要優先操作 Google Search 網頁。Google 經常擋自動化瀏覽器、機器人指紋、頻繁查詢與 DevTools 控制頁面，容易出現 CAPTCHA、空結果、跳轉或 timeout。

首選節點：DuckDuckGo HTML

• 目標節點：https://html.duckduckgo.com/html/?q={KEYWORD}&kl=tw-tzh
• 使用 html.duckduckgo.com，不要使用 DuckDuckGo 主站。
• 查繁體中文或台灣脈絡時保留 kl=tw-tzh。
• 關鍵字必須 URL encode。
• 若使用 shell 探測，必須帶人類瀏覽器指紋標頭：
  • User-Agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 14_4_1)
  • Accept-Language: zh-TW,zh;q=0.9
  • Referer: https://html.duckduckgo.com/

MCP 工作流：把 DuckDuckGo HTML 整合進 Chrome DevTools

系統已盡量以 Chrome 啟動參數設定 Accept-Language。Referer 屬於請求上下文，瀏覽器導航不一定能手動指定；若目標站仍擋瀏覽器自動化，改用下方 shell 後備探測模板。

先記住「瀏覽任務」的預設複合指令（先導頁、再快照）：

[
  {
    "action": "mcp_call",
    "server": "chrome-devtools",
    "tool": "navigate_page",
    "parameters": {
      "url": "https://example.com",
      "timeout": 60000
    }
  },
  {
    "action": "mcp_call",
    "server": "chrome-devtools",
    "tool": "take_snapshot",
    "parameters": {}
  }
]

搜尋任務優先用以下 MCP 流程：

1. new_page 或 navigate_page 到 https://html.duckduckgo.com/html/?q={URL_ENCODED_KEYWORD}&kl=tw-tzh，建議帶 timeout: 60000。
2. wait_for 等待 ["DuckDuckGo", "No results"]，建議帶 timeout: 30000。不要等待 CSS class 名稱，wait_for 只看頁面可見文字。
3. 用 evaluate_script 解析結果，不要對整頁做複雜 Regex：

   {
     "action": "mcp_call",
     "server": "chrome-devtools",
     "tool": "evaluate_script",
     "parameters": {
       "function": "() => Array.from(document.querySelectorAll('a.result__a')).slice(0, 10).map(a => ({ title: a.textContent.trim(), url: a.href }))"
     }
   }
   

4. 需要點進結果時，先 take_snapshot 取得 UID，再 click。禁止直接把 CSS selector 當作 click.uid。

Shell 後備探測模板

如果 MCP 瀏覽器頁面被網站擋住、或任務只需要公開搜尋標題，可改用這個後備 one-liner：

curl -s -L -A "Mozilla/5.0 (Macintosh; Intel Mac OS X 14_4_1)" \
  -H "Accept-Language: zh-TW,zh;q=0.9" \
  -H "Referer: https://html.duckduckgo.com/" \
  "https://html.duckduckgo.com/html/?q={KEYWORD}&kl=tw-tzh" \
  | grep -oE "<a[^>]*class=\"result__a\"[^>]*>[^<]*</a>" \
  | sed 's/<[^>]*>//g'

決策規則

• 搜尋公開資料：優先 DuckDuckGo HTML。
• 操作目標網站、登入後頁面、DOM/console/network debug：使用 Chrome DevTools MCP。
• Google Search 只作最後備援，且遇到 CAPTCHA 或自動化阻擋時立刻切回 DuckDuckGo HTML 或其他公開來源。
• 搜尋結果要回報來源標題與 URL，不要只輸出猜測摘要。

[!IMPORTANT] 致命地雷警告 — 參數格式零容錯 (嚴禁違反)

1. evaluate_script：參數名必須為 function，且值必須是函式字串，例如 "() => document.title" 或 "function() { return document.title; }"。絕對禁止使用 script、code 等其他名稱，否則直接報錯 -32602。
2. wait_for：text 參數必須是字串陣列，例如 ["登入成功"]。絕對禁止直接傳入字串，否則型別錯誤。
3. click / hover：uid 參數必須來自 take_snapshot 回傳的 UID，禁止直接輸入 CSS Selector 或 XPath。
4. navigate_page / new_page：url 必須包含完整協議頭，例如 https://example.com。

🎯 執行協議 (Execution Protocol)

• 靜默推進：點擊、微調、單次滾動等中間步驟，直接執行 MCP 工具，不主動回報給使用者。
• 階段結算：僅在達成關鍵目標（成功抓到完整數據、成功跳轉目標頁）時才回報結果。
• 五段暫停：每累計執行 5 個 MCP 工具呼叫，必須強制停止，回報目前進度並詢問：「主人，已執行五個階段，是否繼續？」

⚔️ 三大進階戰術 (Combat Tactics)

1. 破解代碼混淆：A11y Tree 掃描法

• 適用場景：CSS Modules 或隨機 Class 名稱（金融、社群平台）。
• 策略：執行 take_snapshot，讀取無障礙樹 (Accessibility Tree)。
• StaticText 與 link 內容通常不會被混淆，是獲取數據最穩定的路徑。

2. 空間位移：滾動與懶加載 (Lazy Loading) 破解

• 鍵盤法（最穩）：用 press_key 模擬 "PageDown"、"End" 或 "ArrowDown"。
• 腳本法（精準）：用 evaluate_script 執行：

  function: "function() { window.scrollBy(0, window.innerHeight); }"
  

• 緩衝原則：滾動後嚴禁立刻抓取！必須搭配 wait_for 或延遲 1-2 秒，等待渲染完成。

3. 暴力破門與隱身抓取

• JS 注入點擊：當原生 click 因層級遮擋失效，用 evaluate_script 執行：

  function: "function() { document.querySelector('CSS_SELECTOR').click(); }"
  

• 標題讀取：針對高度防禦網頁，優先檢查 document.title，許多即時行情會寫在標題中。

🛡️ 防雷除錯 SOP (Troubleshooting)

🗺️ 萬用工作流 (Master Workflow)

1. navigate_page → 導航至目標 URL (必須含 https://)
2. press_key "PageDown" → 觸發懶加載
3. wait_for ["關鍵字陣列"] → 等待頁面渲染
4. take_snapshot → 獲取 A11y Tree 與 UID
5. evaluate_script / click → 精準操作或數據抓取
6. 回報階段結果

📋 完整工具速查表