使用八爪鱼 CLI，在命令行中完成网页检测、任务生成、已有任务运行、云采集控制和数据导出。八爪鱼 CLI 是面向开发者、数据团队、运维和 AI Agent 场景的命令行工具。v0.1.32 将命令入口统一为
bazhuayu，保留用户浏览器模式、任务管理、Agent 视觉规划和数据检查能力；同时增强验证页识别和候选区判断。
CLI 能做什么
网页检测与任务生成
使用
bazhuayu detect 检测列表页、详情页与分页逻辑，生成可复用本地任务文件；普通任务会同步到客户端任务列表。运行生成的任务
使用
bazhuayu run <taskId> --task-file task.json 执行检测生成的任务，并通过 --max-rows 控制条数。运行已有任务
使用
bazhuayu run <taskId> 本地运行，或用 bazhuayu cloud start <taskId> 在云端运行。导出采集数据
通过
bazhuayu data history/count/preview/export 查看批次、预览数据并导出 XLSX、CSV、HTML、JSON、XML。管理远端资源
使用
task-group、template、template-task 和 schedule cloud 管理任务组、模板任务与云定时。复用浏览器登录状态
使用
bazhuayu browser 配置 Chrome / Edge 用户 Profile，采集需要登录的页面。安装
- Node.js 20 或更高版本（推荐 22 LTS）
- npm 8 或更高版本
- Windows x64、macOS x64 / arm64、Linux x64
- 默认使用 CLI 管理的 Chrome for Testing；Windows / macOS 可切换到系统 Chrome 或 Edge 用户 Profile
常见工作流
1
安装 CLI
使用
npm install -g bazhuayu-cli@0.1.32 安装，并运行 bazhuayu doctor 检查环境。2
登录认证
通过
bazhuayu auth login、--oauth、--stdin 或环境变量完成认证。3
按需配置用户浏览器
公开网页可继续使用默认独立模式；需要登录状态时，按
browser status → profiles → install → use user 配置 Chrome / Edge Profile。4
选择采集路径
LLM / Agent 使用
detect --agent 生成并审查任务；用户直接操作 CLI 时可用 detect --auto，已有任务或任务文件用 run 执行。5
运行与监控
本地运行可使用
--detach 后台执行，并用 bazhuayu local status 查看进度。6
导出数据
使用
bazhuayu data count/preview/export 检查并导出 Excel、CSV、JSON 等格式。快速命令示例
CLI、MCP / 客户端功能对比
CLI、MCP 与桌面客户端怎么选
CLI 与 MCP 可配合使用：例如在 AI 中通过 MCP 找到任务或生成需求，再在终端用 CLI 做批量运行、导出或 Agent 流程。
当前限制
- CLI v1 不支持内核浏览器（Kernel browser）及旧版工作流（Legacy workflow）。
- Linux arm64 暂不支持本地执行。
- 用户浏览器模式仅支持 Windows 和 macOS，且不支持
--headless；Linux 使用独立浏览器模式。 detect与本地run依赖浏览器环境；网页结构复杂、登录墙或强风控页面可能需要在客户端中进一步调整规则。
下一步
安装与验证
安装 CLI、检查 Node.js / Chrome 环境与平台支持。
运行第一个任务
从新 URL 生成任务并运行，或运行已有任务并导出数据。
网页检测与任务生成
从 URL 检测结构并生成可复用任务文件。
浏览器管理
配置独立浏览器或复用 Chrome / Edge 登录状态。
命令速查表
认证、识别、运行、导出命令一览。