用途
voyage-geo-aeo-analysis 是一个面向 AI 品牌分析师的技能，用于运行生成式引擎优化（GEO/AEO）审计。它覆盖两类核心工作流：单品牌 GEO 分析（brand-run）和品类范围排名（leaderboard）。当用户希望衡量某品牌的 AI 可见度、按 AI 可见度对品类内品牌排名、比较不同提供商/模型表现、识别品牌提及缺口与叙事缺口，或生成面向管理层的 GEO 报告时，可使用该技能。
主要能力
- 品牌分析：测量单个品牌的 AI 可见度，输出提及率、情感、心智份额排名、提供商对比、品牌主题、USP 覆盖缺口、竞品叙事差异以及优先建议。
- 品类排行榜：对某一品类内的品牌进行排名，输出排名表、第一名品牌、最大差距、提供商偏好和意外发现。
- 提供商/模型对比：支持指定多个执行提供商（如 chatgpt、gemini、claude）并比较其表现。
- 多格式报告：支持 html、json、csv、markdown 输出。
- 两阶段排行榜执行：先生成并人工审核查询，再恢复完整执行。
使用方式
技能首先要求校验环境：确保已安装 voyage-geo，运行 voyage-geo providers，确认至少配置了一个执行提供商，并确认已配置处理提供商；若缺少密钥，提示用户添加到 .env（不打印密钥），然后运行 voyage-geo providers --test。
随后询问用户选择工作流：brand-run 或 leaderboard。
若为 brand-run，收集品牌名（必填）、网站 URL（可选但推荐）、竞品（可选）、关注关键词/品类（可选）、提供商、查询数量、输出格式，然后执行：
voyage-geo run -b "<brand>" -w "<url>" -p <providers> -q <n> -f html,json,csv,markdown
读取 data/runs/<run-id>/analysis/summary.json 与 data/runs/<run-id>/analysis/analysis.json，呈现发现并给出 HTML 报告路径。
若为 leaderboard，收集品类（必填）、提供商、查询数量、输出格式，可选 max-brands。分两阶段执行：
- 生成并审核查询：
voyage-geo leaderboard "<category>" -p <providers> -q <n> --stop-after query-generation
与用户一起审核 data/runs/<run-id>/queries.json。
- 恢复完整执行：
voyage-geo leaderboard "<category>" --resume <run-id> -p <providers> -f html,json,csv,markdown
读取 data/runs/<run-id>/analysis/leaderboard.json，呈现排名表、第一名品牌、最大差距、提供商偏好、意外发现以及 HTML 报告路径。
最后询问：“Want to dig deeper or rerun with different providers/queries?”
CLI 快速参考
pip install voyage-geo
voyage-geo providers
voyage-geo providers --test
voyage-geo run -b "<name>" -w "<url>" -p chatgpt,gemini,claude -f html,json,csv,markdown
voyage-geo leaderboard "<category>" -p chatgpt,gemini,claude -q 20 --stop-after query-generation
voyage-geo leaderboard "<category>" --resume <run-id> -p chatgpt,gemini,claude -f html,json,csv,markdown
适用场景
- 品牌方或代理机构评估品牌在生成式 AI 中的可见度与叙事表现。
- 市场/品类研究，按 AI 可见度对品类内品牌进行排名。
- 比较不同 AI 提供商或模型对品牌的呈现差异。
- 识别品牌提及缺口、USP 覆盖缺口与竞品叙事差异。
- 生成面向管理层的 GEO 审计报告。
限制与约束
- brand-run 必须提供品牌名，否则不得继续。
- leaderboard 必须提供品类，否则不得继续。
- 不得回显 API 密钥。
- 若提供商未配置，应停止并请求密钥。
- 运行前必须确认模型/提供商选择。
- 关于具体收费、价格、平台支持范围、效果保证等信息，资料中暂未提供。