下载地址
https://www.zhengdianxue.com/wp-content/uploads/skills/org-xdpui3zs--shengliang-geo.zip将提示词发送给你的 AI 安装该 skills
请根据 https://skillhub.cn/install/skillhub.md,安装 @org-xdpui3zs/shengliang-geo。声量GEO客户端。查品牌在中文 AI 助手上的真实表现:核心指标与环比、各平台可见度、竞品对比、口碑倾向、引用来源,也可发起新一轮检测。当用户问「我的 GEO 数据怎么样」「豆包上我的可见度多少」「竞品比我强在哪」「哪些网站被 AI 引用了」「跑一轮检测」时使用。需要 SHENGLIANG_API_KEY。
阅读全文 (展开查看完整说明)
概述
声量 GEO 监测
读取用户在声量平台上真实探测出来的 GEO 数据。
这和同系列的
shengliang-geo-check是两个不同的东西。那个零配置、只检查站点「有没有为被 AI 引用做好准备」;这个读的是 AI 实际怎么回答,需要付费账号。
用户问「AI 现在怎么说我」用这个,问「我的网站对 AI 友好吗」用那个。
前置条件
需要环境变量 SHENGLIANG_API_KEY。没有就先让用户去控制台「API Key」页创建,明文只显示一次。
接入时第一件事先验 Key,别直接调业务命令 —— 失败时分不清是 Key 还是参数的问题:
npx -y shengliang-geo whoami最常用的三件事
1. 看现在怎么样
npx -y shengliang-geo brands # 先拿 brand_id
npx -y shengliang-geo overview <brand_id> # 核心指标 + 各平台 + 竞品 + 预警overview 是回答「我的 GEO 怎么样」的默认入口。它给的是:
- 核心指标:提及率 / 首推率 / 前三率 / 正向率,带环比
- 各平台可见度:哪个平台差一眼看出来
- 竞品对比:你和竞品的提及率并排
- 预警:环比下滑、口碑偏低等
2. 往下定位
| 用户想知道 | 用哪个 |
|---|---|
| 哪些问题上表现差 | visibility <brand_id> —— 逐意图词 × 平台 |
| AI 对我的评价是正面还是负面 | sentiment <brand_id> |
| 该去哪儿发内容 | citations <brand_id> —— AI 引用了哪些域名 |
citations 值得特别推荐:它直接回答「内容该发到哪个平台才会被 AI 读到」,是从「知道问题」到「能动手」之间最短的一条路。
3. 发起新一轮检测
npx -y shengliang-geo run <brand_id>⚠️ 这一条必须先征求用户同意。 见下一节。
⚠️ 发起检测前必读
run 会消耗真实配额,而且品牌版每天只有 1 次。
CLI 自己会弹确认,但在 AI 客户端里你多半拿不到终端交互 —— 所以由你在调用前向用户说清楚并拿到同意,然后用 --yes 执行:
这会发起一轮真实检测,消耗你今天的检测额度(品牌版每天 1 次 / 超级品牌版 3 次,
次日 00:00 重置),之后一小时内不能再发起。确认要跑吗?
得到明确同意后:
npx -y shengliang-geo run <brand_id> --yes平台没有「查剩余配额」的接口,所以说不出「你今天还剩几次」。不要编一个数字 ——配额真用完了会返回明确的中文提示,照实转达即可。
检测是异步的
返回 run_id 就结束,不要在会话里死等。一轮要几分钟到几十分钟。
npx -y shengliang-geo status <run_id>告诉用户过几分钟回来问一句就行。要轮询的话30 秒一次,更密只会更快触发限流。
几种会让人误判的情况
| 现象 | 真实原因 | 怎么说 |
|---|---|---|
返回 status: queued 而不是 running | 检测资源繁忙,先排队 | 正常,资源空出来会自动开始 |
某个平台 status: skipped | 该平台本轮不可用,reason 里写了 | 不是调用出错,如实转述 reason |
发起检测返回 3004 | 没有已启用的意图词 | 先 prompts <brand_id> 看一眼;AI 生成的意图词默认停用,要逐条启用 |
返回 2002 | 当日配额已用完 | 明日 00:00 重置,不要让用户今天反复重试 |
返回 2003 | 距上次检测间隔不够 | 等提示里给的时间点,这是数据质量闸门不是限流 |
返回 3001 说资源不存在 | ID 错了,或者资源在团队空间 | API 只能读个人空间的数据 |
CLI 对这些都会打印出处置建议,直接转述即可,不用自己编。
渲染器没覆盖的数据
visibility / sentiment / citations 目前输出的是结构化 JSON,overview 也有几块细分数据没渲染成表格。需要完整返回时加 --json:
npx -y shengliang-geo overview <brand_id> --json拿到 JSON 之后请自己读懂再讲给用户,不要整坨贴出来。
本 SKILL 不做什么
- 不改配置。 建品牌、增删意图词、改竞品请到控制台 —— 在对话里改配置,用户很难
看清自己改了什么。
- 不做软文发稿。 那是另一个产品。
- 不替用户决定要不要花配额。 发起检测永远先问。