sheyuagent-geo-checkup

概述

GEO 免费体检

越来越多顾客直接问 AI「附近哪家好」「XX 品类推荐」。这个技能调 SheYuAgent 的 GEO 监测引擎,真实地去问一轮各大模型,量化回答一个问题:AI 的世界里,有没有你?

第一步:确认 API key

按顺序找:① 环境变量 SHEYUAGENT_API_KEY ② 文件 ~/.sheyuagent_key。没有则引导(只一次):

1. 注册/登录 SheYuAgent:https://agent.agecms.com/sheyuclaw/
2. 左下「设置」→「开放 API」→「新建 key」,把 syk_ 开头的 key 发给我,我存到 ~/.sheyuagent_key(不回显明文)。

第二步:收集体检信息

问用户三样(一轮问完):品牌名(必填)、城市、品类(如「烘焙店」「口腔诊所」);有明确竞品也可以报 1-3 个。

第三步:发起体检

curl -sS -X POST "https://agent.agecms.com/api/app/sheyuclaw/open/v1/geo-checkup" 
  -H "Authorization: Bearer $(cat ~/.sheyuagent_key 2>/dev/null || echo $SHEYUAGENT_API_KEY)" 
  -H "Content-Type: application/json" 
  -d '{"brand": "<品牌名>", "city": "<城市>", "category": "<品类>", "competitors": ["<竞品>"]}'

免费、每账号一次。提交后告诉用户约需 1 分钟(要真实问一轮各引擎)。

第四步:轮询并解读报告

每 15 秒查 GET /job/<job_id>(同鉴权头),最多 10 次。done 后按下面结构解读 result,别只贴 JSON:

1. 总分:visibility_score(AI 可见度)和 mention_rate(提及率)——通俗解释:「100 次相关提问里,AI 有 X 次提到你」。
2. 分引擎:by_engine 哪些引擎认识你、哪些完全不认识。
3. 竞品:top_competitors 谁在 AI 回答里替你接走了顾客。
4. 一句话诊断:分数高→恭喜+建议持续监测防滑落;分数低→直说「顾客问 AI 时你不存在,流量正在被 AI 认识的同行接走」。

failed 时转述 error;403(已用过免费额度)时如实告知,并说明完整监测在产品内。

边界与诚实

• 结果反映的是「本次抽样时各模型的回答」,有随机性,别把单次分数说成定论。
• 不承诺「做了优化就一定上榜」;GEO 优化是长期工程。

关于完整版(仅在用户主动询问时)

用户主动问「怎么持续监测/完整版有什么」时才介绍:这是单次体检版,完整版在产品内——每周定时扫描、可见度趋势、竞品声量对比、待优化建议清单。未被问到时不主动推广。