SuperAPI AI 工具集
合作ENAI 行业资讯收藏
Skill 广场geo-run

geo-run

营销与增长

查看项目

更新于 10-27 20:09

技能介绍

用途

geo-run 是一项用于执行完整 GEO（Generative Engine Optimization，生成式引擎优化）审计的技能。它扮演 AI 品牌分析师的角色，以交互方式引导用户走完从环境配置、品牌调研、查询生成、执行、分析到报告输出的完整流程。

主要能力

  • 引导式全流程：分步骤收集品牌信息、检查环境、选择模型、确认计划并执行分析。
  • 多模型查询：可针对 ChatGPT、Claude、Gemini、Perplexity、DeepSeek、Grok、Llama、Mistral、Cohere、Qwen、Kimi、GLM 等模型执行查询。
  • 结果分析：读取执行摘要与完整分析，呈现品牌在 AI 回答中的提及比例、情感倾向、竞品中的 AI 心智份额排名，以及各模型上的强弱表现。
  • 叙事分析：展示 AI 模型关联的品牌主题与属性、未被提及的 USP（独特卖点）覆盖缺口，以及与竞品的叙事对比。
  • 多格式报告：支持 html、json、csv、markdown 等报告格式。

使用方式

安装：

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

run 命令的参数：

  • --brand / -b（必填）— 品牌名称
  • --website / -w — 品牌网站 URL
  • --providers / -p — 逗号分隔的提供商名称（默认：通过 OpenRouter 使用全部）
  • --queries / -q — 查询数量（默认 20）
  • --iterations / -i — 每个查询的迭代次数（默认 1）
  • --formats / -f — 报告格式（默认 html,json）
  • --concurrency / -c — 并发 API 请求数（默认 10）
  • --output-dir / -o — 输出目录（默认 ./data/runs）

技能按以下步骤引导用户：

  1. 收集品牌信息：询问要分析的品牌（必填）、网站 URL（可选但推荐）、主要竞品（可选，未提供时由 AI 调研）、以及要聚焦的关键词或产品类别。至少获得品牌名称后才继续。
  2. 检查环境并选择模型：检查是否已安装 voyage-geo，未安装则执行 pip install voyage-geo；运行 voyage-geo providers 查看已配置的 API 密钥；以清单形式展示可用模型及其所需密钥，让用户勾选。
  3. 确认并运行：汇总分析计划（品牌名、网站、竞品、将查询的提供商、查询数与迭代次数），确认后执行 run 命令。
  4. 呈现结果：读取 data/runs/<run-id>/analysis/summary.json 中的执行摘要与 analysis.json 中的完整分析，以对话方式呈现关键发现，并告知 HTML 报告位置 data/runs/<run-id>/reports/report.html。

模型与密钥

各模型所需的密钥：

  • ChatGPT：OpenRouter 或 OpenAI，需要 OPENROUTER_API_KEY 或 OPENAI_API_KEY
  • Claude：OpenRouter 或 Anthropic，需要 OPENROUTER_API_KEY 或 ANTHROPIC_API_KEY
  • Gemini：OpenRouter 或 Google，需要 OPENROUTER_API_KEY 或 GOOGLE_API_KEY
  • Perplexity：OpenRouter 或 Perplexity，需要 OPENROUTER_API_KEY 或 PERPLEXITY_API_KEY
  • DeepSeek、Grok、Llama、Mistral、Cohere、Qwen、Kimi、GLM：均通过 OpenRouter，需要 OPENROUTER_API_KEY

提示：OpenRouter（https://openrouter.ai/keys）用一个密钥即可访问所有模型。

密钥获取地址：

  • OpenRouter：https://openrouter.ai/keys
  • OpenAI：https://platform.openai.com/api-keys
  • Anthropic：https://console.anthropic.com/
  • Google：https://aistudio.google.com/apikey
  • Perplexity：https://docs.perplexity.ai/

密钥写入 .env 文件，且绝不回显给用户。

处理提供商（Processing provider）用于内部 LLM 调用（调研、查询生成、分析），与执行提供商相互独立。若显示 "configured" 则无需操作；若显示 "NOT CONFIGURED"，用户需要至少一个 ANTHROPIC_API_KEY、OPENAI_API_KEY、GOOGLE_API_KEY 或 OPENROUTER_API_KEY。若已为执行提供商设置了 OPENROUTER_API_KEY，处理提供商会自动检测到它，可重新运行 voyage-geo providers 确认。

适用场景

适用于希望了解自身品牌在各类生成式 AI 引擎回答中曝光情况、情感倾向、竞品排名与叙事覆盖的营销或品牌分析场景。

限制

  • 需要安装 voyage-geo 并配置相应 API 密钥才能运行。
  • 具体收费、价格、平台支持范围等资料暂未提供。
  • 该技能允许使用的工具为 Bash、Read、Glob、Grep、Write、Edit。