GEO Leaderboard 是一个品类级 AI 品牌可见度排行榜工具。它的核心目标是衡量 AI 模型在回答推荐类问题时实际提到了哪些品牌，并据此对同一品类内的品牌进行排名。与预设品牌名单的传统榜单不同，该工具的品牌完全从 AI 的回答中提取，因此反映的是 AI 模型“实际说了什么”。
用途 该工具用于回答“在某个品类中，哪些品牌在 AI 推荐里出现得最多、最强”。示例品类包括“top vc firms”“best CRM tools”“cloud providers”等。它适合需要了解品牌在 AI 生成回答中曝光情况的场景。
主要能力
- 为指定品类生成寻求推荐的查询。
- 向多个 AI 提供商执行这些查询。
- 从 AI 回答中提取所有被实际提及的品牌名称。
- 分析每个品牌的提及率、心智份额（mindshare）和情感倾向（sentiment）。
- 按得分对品牌进行排名。
- 支持多种报告格式：html、json、csv、markdown。
- 支持分阶段执行，例如在查询生成后暂停以供人工审核，再通过 run ID 恢复继续。
使用方式 工具通过命令行调用，基本命令形式为： python3 -m voyage_geo leaderboard "<category>" -p <providers> -q <n> --stop-after query-generation python3 -m voyage_geo leaderboard "<category>" --resume <run-id> -p <providers> -f html,json,csv,markdown python3 -m voyage_geo providers
leaderboard 支持的参数包括：
- category（位置参数，必填）：品类，例如 "top vc"、"best CRM tools"。
- --providers / -p：逗号分隔的提供商名称。
- --queries / -q：查询数量，默认 20。
- --formats / -f：报告格式，默认 html,json。
- --concurrency / -c：并发 API 请求数，默认 10。
- --max-brands：从回答中提取的最大品牌数，默认 50。
- --stop-after：在某个阶段后停止（例如 query-generation）以便审核。
- --resume / -r：从已有 run ID 恢复。
- --output-dir / -o：输出目录，默认 ./data/runs。
典型流程
- 确定要排名的品类。
- 运行 python3 -m voyage_geo providers 检查提供商配置。执行提供商中至少有一个配置了 API key 即可继续；处理提供商需显示为 configured，否则用户需要至少配置 ANTHROPIC_API_KEY、OPENAI_API_KEY、GOOGLE_API_KEY 或 OPENROUTER_API_KEY 之一。
- 使用 --stop-after query-generation 生成查询并记录 run ID。
- 读取 data/runs/<run-id>/queries.json，以表格形式向用户展示查询（包含序号、策略、品类、查询内容），确认或直接编辑该文件。
- 确认后使用 --resume <run-id> 执行完整流程：对所有提供商执行查询、提取 AI 实际推荐的品牌、分析并排名。
- 读取 data/runs/<run-id>/analysis/leaderboard.json 展示排名，包含品牌、得分、提及率、心智份额、情感倾向等字段，并指出第一名、最大差距、提供商偏好和意外结果。
适用场景 适用于需要评估某品类内品牌在 AI 推荐中相对位置的品牌分析、市场研究或竞争情报工作。
限制 该工具依赖 AI 提供商的 API key 才能执行查询；处理提供商未配置时无法继续。品牌名单不预设，完全取决于 AI 回答内容。资料未提供具体收费、价格、平台支持范围或效果保证等信息。