SuperAPI AI 工具集

chrome-devtools-axi

通用与其它

查看项目

更新于 10-16 06:42

技能介绍

用途:chrome-devtools-axi 是 chrome-devtools-mcp 的 npm CLI 封装,供代理或用户在终端通过 Chrome DevTools Protocol 控制浏览器。适用于需要紧凑可访问性快照(含可操作 ref 与命令建议)、在同一 CLI 中查看控制台日志、网络请求、截图、Lighthouse、堆快照或性能追踪的场景。不适用于普通网页搜索、可 curl 的页面、静态提取或反检测/隐身工作。

主要能力与使用方式:首次命令会启动常驻本地桥接,后续调用复用同一 Chrome/DevTools 会话,状态存放在 ~/.chrome-devtools-axi/。优先用 npx 一次性运行:npx -y chrome-devtools-axi --help,npx -y chrome-devtools-axi;重复在 shell 中使用可全局安装 npm install -g chrome-devtools-axi。先验证:npx -y chrome-devtools-axi --version、--help。若提示 browser: no active session,执行 npx -y chrome-devtools-axi open https://example.com。

核心操作:按最新快照原样使用 ref(形如 @g<N>:...,可能含下划线),如 click @<uid>、fill @<uid> "search text"、press Enter;每次改变状态后重新运行 snapshot。调试用 console --type error --limit 20、network --type fetch --limit 20、network-get <id> --response-file /tmp/response.json。结束可 stop。

限制与注意:ref 属于最新可访问性快照,导航、点击、提交、滚动、弹窗、上传、拖拽、JS 变更、切换页面或调整窗口后必须重新快照;遇 STALE_REF 不要重试旧 ref。优先用 ref 而非 CSS 选择器。涉及已有 Chrome、有头模式、用户资料目录属隐私敏感,需用户明确授权;不要持久化环境变量,不打印 CHROME_DEVTOOLS_AXI_WS_HEADERS。未验证前不得声称浏览器操作成功。具体参数以运行时 --help 与上游文档为准。