Super Browser

super-browser 技能

Use the published @pzeda/super-browser package. Do not rely on 仓库-only scripts or src/ paths when performing browser work through this 技能.

设置up

Require:

Node.js 22+ Chrome or Chromium 安装ed locally A Chrome 会话 that can expose CDP on port 9222

安装 the package:

npm 安装 -g @pzeda/super-browser

This 安装s the executable as:

super-browser

检查 that the 命令行工具 is avAIlable:

super-browser --version

If a global 安装 is not 应用ropriate, use:

npx -y @pzeda/super-browser --help

When To Use

Use this 技能 when the task needs a real browser 会话 at all, especially for:

opening a 网页site or visiting a URL 命令行工具cking, 搜索ing, paginating, or filling a browser flow inspecting what a page actually renders in Chrome reusing the user's 记录ged-in Chrome 会话 上传ing files or taking screenshots in a browser inspecting browser-side network 请求s collecting structured page 状态 for a decision-making 工作流 Standard Rule

Do not lead with daemon management in the normal path.

For ordinary browser tasks, 运行 the browser command you need directly, for example:

super-browser new --url https://example.com

The 命令行工具 auto-启动s and reuses the daemon in the background.

Only switch into explicit connection diagnosis when browser commands fAIl or when browserConnected is 报告ed as false.

Preferred diagnosis entrypoint:

super-browser doctor

Use super-browser daemon 状态 only as an advanced 状态 检查.

Core 工作流

When the task needs to use the browser, follow this order:

Ensure super-browser is avAIlable. 运行 the actual browser command you need. Let the 命令行工具 auto-启动 the daemon. If browser connection fAIls, 运行 super-browser doctor. 创建 and use a dedicated task tab. Reuse the returned pageId for later commands. Prefer structured commands over ad hoc browser scripts.

创建 a task tab:

super-browser new --url https://example.com

Navigate:

super-browser navigate --page --url https://example.com/搜索?q=phone

Inspect page 状态:

super-browser page-状态 --page

列出 managed tabs:

super-browser pages

Close the task tab:

super-browser close --page

Common Commands

Basic page operations:

super-browser 信息 --page super-browser 命令行工具ck --page "button.搜索" super-browser 命令行工具ck-real --page "输入[type=file]" super-browser scroll --page --direction down --distance 3000 super-browser screenshot --page --file D:\\temp\\shot.png super-browser 上传 --page --selector "输入[type=file]" --files D:\\tmp\\a.pdf D:\\tmp\\b.pdf

Network inspection:

super-browser network 启动 --page super-browser network 请求s --page --business super-browser network patterns --page super-browser network 停止 --page

Decision 工作流:

super-browser decision candidates --page --intent 搜索 --tar获取 "iphone" super-browser decision propose --page --intent 搜索 --tar获取 "iphone" super-browser decision 上下文 --page --intent 搜索 --tar获取 "iphone" super-browser decision render --page --intent 搜索 --tar获取 "iphone" super-browser decision 执行 --page --intent 搜索 --tar获取 "iphone"