brew install hahwul/mzap/mzap

shards install --frozen
crystal build --release src/mzap_cli.cr -o bin/mzap

crystal run src/mzap_cli.cr -- version

docker build -t mzap .
docker run --rm -v "$PWD:/work" mzap spider --urls /work/samples/target.txt --apis http://host.docker.internal:8090

Usage:
  mzap [command]

Subcommands:
  ajaxspider    在 ZAP 中启动 Ajax Spider 扫描
  ascan         在 ZAP 中启动主动扫描任务
  clientspider  在 ZAP 中启动客户端爬虫扫描（ZAP 2.16+）
  help          显示命令的帮助信息
  import        导入 API 定义（openapi/soap/graphql/postman）
  policies      列出 ZAP 中的主动扫描策略
  pscan         等待 ZAP 中的被动扫描完成
  sitestree     导出或修剪 ZAP 站点树（ZAP 2.16+）
  spider        在 ZAP 中启动爬虫扫描
  stop          停止正在运行的扫描
  version       显示 mzap 版本

Flags:
  --apikey string        ZAP API 密钥（禁用 API 密钥认证时可省略）
  --apis string          逗号分隔的 ZAP API 主机 URL
                         例如 --apis http://localhost:8090,http://192.168.0.4:8090（默认 "http://localhost:8090"）
  --config string        配置文件路径（支持 TOML；默认：$HOME/.config/mzap/config.toml）
  --context string       ZAP 上下文文件，扫描前导入
  --fail-on string       如果警报达到或超过指定风险级别则以退出码 1 失败
  --format string        导入的 API 定义格式（openapi/soap/graphql/postman）
  --target-url string    导入的目标/端点 URL 覆盖
  --policy string        主动扫描的扫描策略名称
  --report-format        扫描完成后的报告格式（html/pdf/json/md/sarif）
  --report-out           报告输出路径（默认：mzap-report-<timestamp>.<ext>）
  --concurrency          并发扫描分发的数量（默认 1）
  --wait                 等待启动的扫描完成
  --wait-interval        等待时的轮询间隔（秒，默认 2）
  --wait-timeout         等待超时时间（秒，默认 0：无超时）
  -h, --help             显示 mzap 的帮助信息
  --urls string          URL 列表文件路径（例如 --urls hosts.txt）

# 使用两个 ZAP API 主机进行 spider 扫描
mzap spider --urls samples/target.txt --apis http://localhost:8090,http://192.168.0.4:8090

# 运行扫描，等待完成，并生成 HTML 报告
mzap spider --urls samples/target.txt --apis http://localhost:8090 --wait --report-format html --report-out reports/mzap.html

# Client Spider（基于浏览器的爬虫，ZAP 2.16+；需要 Client Side Integration 插件）
mzap clientspider --urls samples/target.txt --apis http://localhost:8090 --wait

# 导入 OpenAPI 定义，等待被动扫描，以高严重性警报为 CI 门控
mzap import --format openapi --urls samples/specs.txt --target-url https://api.example.com \
  --apis http://localhost:8090 --wait --report-format sarif --fail-on high

# 从标准输入导入 API 规范
echo https://api.example.com/openapi.json | mzap import --format openapi --urls -

# 发现可用的扫描策略（然后使用 `ascan --policy` 使用其中一个）
mzap policies --apis http://localhost:8090

# 站点树基线，用于差异扫描（路径由 ZAP 守护进程解析）
mzap sitestree export baseline.tree --apis http://localhost:8090
mzap sitestree prune baseline.tree --apis http://localhost:8090

# 停止所有正在运行的扫描类型
mzap stop all --apis http://localhost:8090

[mzap]
apis = ["http://localhost:8090", "http://192.168.0.4:8090"]
apikey = "your-zap-api-key"
urls = "samples/target.txt"
wait = true
wait_interval = 2
wait_timeout = 0
report_format = "html"
report_out = "reports/mzap.html"

- name: Run mzap
  uses: hahwul/mzap@<tag>
  with:
    arguments: "spider --urls samples/target.txt --apis http://localhost:8090"

# 测试
crystal spec

# 发布构建
crystal build --release src/mzap_cli.cr -o bin/mzap