kunchenguid/chrome-devtools-axi

chrome‑devtools‑axi – 對代理友好的 Chrome 自動化

是什麼 – chrome-devtools-axi 是一個命令列工具，包裝了 chrome‑devtools‑mcp 庫（基於 Chrome DevTools Protocol 建構的無頭 Chrome 控制器），並以 AXI 相容 格式輸出。AXI（Agent eXecution Interface）是一種為大型語言模型代理設計的輕量級架構，因此此 CLI 經過優化，具備 令牌效率，並為代理提供清晰、可執行的提示。

對 AI 代理的重要性

低令牌成本 – 工具使用 TOON 格式對快照進行編碼，將原始 JSON 的令牌數量減少約 40%（與原始 chrome‑devtools‑mcp 相比，輸入令牌減少約 57%）。
更少的互動回合 – 一條命令即可完成導航、頁面擷取與下一步建議，減少 LLM 需要進行的往返呼叫次數。
內建易用性 – 每個回應都包含一條簡短的「幫助」行，明確告訴代理下一步應執行的命令（例如 click @g1:1）。
基準測試驗證 – 在公開的 AXI 基準測試（14 個真實世界瀏覽任務，使用 Claude‑Sonnet‑4‑6 作為代理）中，它在保持 100% 成功率的同時，實現了最低的平均輸入令牌數、成本、執行時間與回合數。

運作方式

chrome‑devtools‑axi  (CLI) → HTTP (localhost:9224) → 橋接伺服器（持久 MCP 會話） → chrome‑devtools‑mcp → 無頭 Chrome

一個橋接進程在 CLI 呼叫之間持續運行，因此無需每次重新啟動 Chrome。
橋接器擷取 可存取性樹，提取可互動元素 ID（uid= 引用），並使用 TOON 進行編碼。
命令（open、click、fill、eval、screenshot、lighthouse 等）被轉換為 DevTools 協定訊息，結果以緊湊、代理就緒的 JSON 格式回傳。

安裝與快速入門

代理技能路徑（推薦） – 透過單一指令將技能加入 Claude/Hermes 風格的代理中，無需 npm install：
```
npx skills add kunchenguid/chrome-devtools-axi --skill chrome-devtools-axi -g
```
此技能會指示代理在需要真實瀏覽器的任務時，透過 npx -y chrome-devtools-axi 呼叫 CLI。

直接 CLI – 全域安裝或即時執行：

npm i -g chrome-devtools-axi   # 或
npx -y chrome-devtools-axi open https://example.com

從原始碼 – 克隆，pnpm install --frozen-lockfile，pnpm run build，然後 pnpm link。

典型代理互動

$ chrome-devtools-axi open https://example.com
page: {title:"Example Domain",url:"https://example.com",refs:1}
snapshot:
RootWebArea "Example Domain"
  heading "Example Domain"
  paragraph "This domain is for use in illustrative examples..."
  uid=g1:1 link "More information..."
help[1]: Run `chrome-devtools-axi click @g1:1` to click the "More information..." link

代理隨後可執行 chrome-devtools-axi click @g1:1，接收新快照，並繼續工作流程。

主要命令群組

導航 – open <url>，back，scroll，wait，eval。
互動 – click @uid，fill @uid <text>，type，press，hover，drag。
頁面管理 – pages，newpage，selectpage，closepage，resize。
DevTools 資料 – console，network，lighthouse，perf‑start/stop，heap。
橋接控制 – start，stop，setup hooks（為 Claude Code、Codex、OpenCode 安裝會話啟動鈎子）。

設定選項

CHROME_DEVTOOLS_AXI_PORT – 自訂橋接埠。
CHROME_DEVTOOLS_AXI_BROWSER_URL – 連接到現有的 Chrome 實例（HTTP 或 WS 端點）。
CHROME_DEVTOOLS_AXI_CHANNEL – 選擇 Chrome 發行管道（stable、beta、canary、dev）。
CHROME_DEVTOOLS_AXI_SESSION – 平行執行多個隔離的橋接會話。
隔離旗標（--use-mock-keychain，--password-store=basic）確保啟動的瀏覽器絕不接觸作業系統金鑰鏈。

誰應該使用它

需要可靠、低令牌開銷瀏覽器自動化的 LLM 驅動代理 開發者。
希望為 Claude、Hermes 或任何 AXI 相容代理平台提供 即插即用技能 的團隊。
需要可程式化 Chrome 介面並返回適合提示注入的簡潔、結構化資料的任何人。

以上所有細節均直接取自倉儲的 README；未推斷任何額外功能。

kunchenguid/chrome-devtools-axi

chrome‑devtools‑axi – 對代理友好的 Chrome 自動化

相關