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 自动化

相关