用途:协调一次完整的 SEO 与 AI 搜索审计,分 detect、dispatch、synthesize 三阶段。脚本负责采集,模型只做判断;所有产物写入 ${CLAUDE_PLUGIN_DATA}/runs/<host>/<run-id>/,不写入用户项目。
主要能力:detect 阶段用一条命令跑完确定性流水线,audit.mjs 会调用 crawl.mjs(URL)或 snapshot.mjs(--pages 1 或本地路径),生成 profile.json(平台/框架/CMS 插件/托管/环境/能力/vertical_hints 及行业猜测),运行检查注册表并调用 report.mjs 产出首份确定性报告。可读 crawl.json 与 profile.json,用 seo-vertical-detect 判断行业,必要时对同一 run 重跑确定性检查以触发条件模块。dispatch 阶段并行启动四个只读子代理:technical-auditor、ai-search-geo-specialist、content-eeat-analyst、schema-generator,各自按模块清单返回 JSON 数组。synthesize 阶段用 report.mjs 合并代理结果,按 id 与位置去重、取最严重者,评分并重写 findings.json、report.json、report.md。
使用方式:核心命令为 node "${CLAUDE_PLUGIN_ROOT}/scripts/audit.mjs" <url|path> --out "${CLAUDE_PLUGIN_DATA}/runs" --checks deterministic --format json,可加 --pages、--max、--render、--ua、--vertical、--environment、--feed。合并命令为 node "${CLAUDE_PLUGIN_ROOT}/scripts/report.mjs" <run_dir> --merge "agents/*.json" --lang <en|es>。子代理无 Write/Edit,审计不会改动文件。
适用场景:需要对站点做 SEO 与 AI 可见性审计、平台与行业识别、条件模块检查及可复现报告时。
限制:--render 默认 static,客户端渲染目标需传 --render auto;退出码 2 表示无法采集,3 表示 CI 门禁触发而非审计失败;缺少 node 或仅安装技能而无 scripts/ 时降级为 WebFetch 摘要,相关发现标记 needs_api,报告标注 prompt-only mode,不可与脚本运行比较。