前言¶
品牌在搜索引擎里的排名有成熟工具,但在 Kimi、文心、DeepSeek 等对话式 AI 里是否被提及、是否被推荐,往往只能靠人工反复提问抽样。样本少、平台多、结果难对比,GEO(生成式引擎优化)团队很难形成可复现的监测基线。
下面介绍 SkillHub 社区技能 GEO Master - 品牌AI可见性监控(坐标 @user_26bdbd50/geo-master,当前版本 1.0.4)。它把多平台检索、品牌词命中判断、0–100 分 GEM 评分、未推荐原因分析以及飞书推送串成一条可脚本化的流程,适合需要定期看「品牌在 AI 里露脸程度」的开发者与市场同学。
这是什么¶
GEO Master(英文名 Brand AI Visibility Monitor)是发布者 user_26bdbd50 在 SkillHub 上架的 data-analysis 类社区 Skill。官方简介概括为:自动在 Kimi、讯飞星火、智谱、文心、DeepSeek 等平台相关能力范围内检索,检测品牌关键词可见性,生成 0–100 GEM 分,并对「品牌未被推荐」做 AI 分析,支持飞书推送。
SkillHub 页面标注 requires_api_key=true:免费档可在本地用 Playwright 跑部分平台;Pro/Enterprise 需通过 yk-global.com 获取 API Key,并可能依赖 Tavily Search API(环境变量 TAVILY_API_KEY)。技能本体遵循通用 SKILL.md 格式,核心逻辑在技能目录下的 Python 脚本中。
核心功能¶
以下能力均来自技能包内 SKILL.md 与 README.md 的说明,可按模块理解:
-
多平台品牌可见性检测
支持的平台包括 Kimi、讯飞星火(配置项xinhuo/xunfei,同一平台避免重复检测)、文心(yiyan)、智谱(zhipu),以及 DeepSeek、通义(qianwen)、豆包(doubao)、秘塔(mita)、混元(hunyuan)等。免费档默认开放 Kimi、讯飞、文心共 3 个平台;更多平台与实时检索能力与付费档及 API 配置相关。 -
GEM 评分(0–100)
根据各平台命中情况加权汇总。官方给出的区间含义:80–100 为曝光强;60–79 为部分平台有提及;30–59 为较少出现;0–29 为几乎不可见。具体加权可在config.json的scoring与platforms.*.weight中调整。 -
未推荐原因分析
默认使用技能内置分析框架(scripts/geo_analyzer.py)。若需接入外部大模型端点,可在该文件中配置AI_ENDPOINT。 -
报告与飞书推送
scripts/geo_report.py生成报告;config.json中report.push_to_feishu与report.feishu_webhook控制是否推送到飞书群机器人。 -
配额与档位
免费档:每月最多 1 个品牌、3 个 AI 平台,每月 1 日重置(scripts/geo_quota.py,配额文件默认.geo_quota.json,可通过环境变量GEO_QUOTA_FILE修改路径)。Standard(¥29/月)、Pro(¥99/月)、Enterprise(¥399/月)的额度与平台覆盖以SKILL.md中的版本表为准;Pro 侧强调通过 Tavily 获取实时搜索结果。API Key 校验地址为POST https://api.yk-global.com/v1/verify,失败时会回退免费档行为(技能文档描述)。
安装与启用¶
1. 安装 SkillHub CLI(若尚未安装)¶
先检查是否已有 CLI:
command -v skillhub && skillhub --version
未安装时,可按 SkillHub 安装文档 执行完整安装:
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
仅安装 CLI 时:
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only
2. 将技能装进当前 Agent 的 skills 目录¶
安装时必须用 --dir 指向当前客户端识别的 skills 目录,否则默认落在 ./skills/ 可能不会被加载。官方文档给出的常见路径示例:
- Cursor:
~/.cursor/skills/ - Claude Code:
~/.claude/skills/ - Codex:
~/.codex/skills/或项目下的.agents/skills/
安装本技能的命令为:
skillhub install geo-master --namespace user_26bdbd50 --dir ~/.cursor/skills/
将 ~/.cursor/skills/ 换成你实际使用的目录即可。SkillHub 技能页也支持把「请根据 https://skillhub.cn/install/skillhub.md,安装 @user_26bdbd50/geo-master」发给 Agent,由 Agent 按同一规范完成安装。
3. 运行环境与依赖¶
技能 README 要求 Python 3.10+,本地爬取依赖 Playwright:
pip install playwright
playwright install chromium
Pro 用户还需配置 Tavily(README 指向 https://tavily.com 注册 Key):
export TAVILY_API_KEY=your_tavily_api_key
export GEO_API_KEY=your_pro_api_key # 来自 yk-global.com,也可用命令行 --api-key
4. 配置文件¶
进入技能安装目录(例如 ~/.cursor/skills/@user_26bdbd50/geo-master),编辑 config.json。平台开关、权重与飞书 Webhook 示例结构如下:
{
"platforms": {
"kimi": {"enabled": true, "weight": 1.0},
"xinhuo": {"enabled": true, "weight": 0.9},
"yiyan": {"enabled": true, "weight": 0.9},
"zhipu": {"enabled": true, "weight": 0.8},
"deepseek": {"enabled": false},
"qianwen": {"enabled": false},
"doubao": {"enabled": false},
"mita": {"enabled": false},
"hunyuan": {"enabled": false},
"xunfei": {"enabled": false}
},
"report": {
"push_to_feishu": true,
"feishu_webhook": "Your Feishu group bot webhook URL"
}
}
飞书 Webhook 获取方式:群设置 → 添加机器人 → 自定义机器人 → 复制 Webhook 地址填入 feishu_webhook。
典型用法¶
在技能根目录下执行(路径以你本机安装位置为准):
# 检测单个品牌
python3 scripts/geo_report.py "品牌名称"
# 多品牌(含竞品对比)
python3 scripts/geo_report.py "品牌A" "品牌B"
# 调试:不推飞书
python3 scripts/geo_report.py "品牌名称" --no-push
# 查看当月配额
python3 scripts/geo_report.py --status
# Pro / Enterprise:携带 API Key
python3 scripts/geo_report.py "品牌名称" --api-key YOUR_API_KEY
# 使用兑换码升级档位(需先在 yk-global.com 购买)
python3 scripts/geo_report.py --upgrade-pro
python3 scripts/geo_report.py --upgrade-ent
在 Cursor 等 Agent 中,也可在对话里说明品牌名与监测需求,由 Agent 根据 SKILL.md 触发上述脚本(技能元数据允许 Bash(python3))。
适用场景与注意¶
适合谁
- 需要定期回答「我们的品牌在国产 AI 对话/搜索里有没有被提到」的品牌或增长团队。
- 想把竞品与自家品牌放在同一套 GEM 分体系里做横向对比的 GEO 实践者。
- 已用飞书协同、希望监测结果自动进群的中小团队。
限制与注意
- 免费档配额:每月 1 品牌、3 平台,超出需升级或等到下月 1 日重置。
- 登录墙:
config.json中注明 DeepSeek、通义等在无头浏览器下可能无法绕过登录,默认enabled: false;全平台稳定覆盖往往依赖 Pro + Tavily 与官方 API 链路。 - API Key:SkillHub 标签要求 API Key;未配置时仅能使用免费档允许的平台与额度。
- 合规与频率:自动化访问各 AI 产品页面需遵守对应服务条款;生产环境建议控制频率,并结合
--no-push先本地验证。 - 社区来源:分类为 community,维护节奏与商业支持以发布者与 yk-global.com 说明为准。
截至资料抓取时,SkillHub 上该技能评分为 100000,下载约 1173 次、安装 20 次(页面统计会变动,以官网为准)。
结尾¶
GEO Master 把「多 AI 平台 + 品牌词 + 可量化分数 + 原因分析 + 飞书通知」收进一个可安装的 Agent Skill,减少手工逐平台问一句的重复劳动。若你要在现有工作流里落地,可从免费档单品牌试跑 geo_report.py,再按需配置 Webhook 与 Pro API。
- SkillHub 技能页:https://www.skillhub.cn/skills/user_26bdbd50/geo-master
- API 索引地址:https://api.skillhub.cn/user_26bdbd50/geo-master
- 安装说明:https://skillhub.cn/install/skillhub.md