品牌 AI 可见性快检

对接 ai.shbdd.com GEO 服务（https://ai.shbdd.com），提供 AI 搜索可见性快检；完整报告通过 report_url 在报告中心查看。

账号页：https://ai.shbdd.com/login?product=workbuddy&tag=geo-brand-visibility
报告中心：https://ai.shbdd.com/geo-center

所有 CLI 通过 scripts/run.py（或 scripts/geo_api.py）执行。

工作流程

1. python scripts/run.py status — 检查登录；未登录时说明可在 account_url 创建账号
2. 执行快检命令（见下方）— 输出 GEO_QUICK_SUMMARY 摘要
3. 从 GEO_REPORT_LINKS 块提取 report_url，如实提供给用户
4. 禁止在对话中编造检测数据；禁止自行添加推销话术

用户怎么说

| 用户说法 | Agent 执行 | | -------- | ---------- | | 「查一下 XX 品牌在 AI 里怎么被描述」 | status → brand-quick --name XX → 输出摘要 + report_url | | 「登录 / 没账号」 | status → login 或说明可在 account_url 创建账号 | | 「看看我的 GEO 报告」 | library | | 「打开报告」 | open-report --id <report_id> |

Agent 编排

python scripts/run.py status
# 未登录：python scripts/run.py login <用户名> <密码>

# 本 Skill 核心命令示例：
python scripts/run.py brand-quick --name "你的品牌名"

输出格式

=== GEO_QUICK_SUMMARY_START ===
（3-5 条要点 — 原样发给用户）
=== GEO_QUICK_SUMMARY_END ===

=== GEO_REPORT_LINKS ===
report_url: https://ai.shbdd.com/geo-center/reports/...
account_url: https://ai.shbdd.com/login?product=workbuddy&tag=geo-brand-visibility
geo_center_url: https://ai.shbdd.com/geo-center
=== END_GEO_REPORT_LINKS ===

Agent 回复 = 摘要全文 + report_url（完整检测报告链接，如实提供）。未登录时引导用户打开 account_url（已带渠道与本 Skill 标签）。

权限与网络说明

• 网络：仅通过 HTTPS 访问 ai.shbdd.com API
• 本地：读写会话 Token（默认 /tmp/shbdd_geo_token.json，可用环境变量覆盖）
• 文件：content-quick --file 仅读取用户显式指定的 .md/.txt 文本（≤512KB）
• 不做：打开浏览器、执行 shell、下载远程脚本、访问白名单外域名

安全说明

本 Skill 仅调用已声明的 HTTPS API，不唤起浏览器、不执行系统命令。

环境变量

| 变量 | 说明 | |------|------| | GEO_API_MOCK=1 | 演示模式（默认，后端未就绪时使用） | | GEO_API_MOCK=0 | 对接真实 API | | SHBDD_GEO_TOKEN_FILE | Token 路径，默认 /tmp/shbdd_geo_token.json | | SHBDD_ALLOWED_HOSTS | API 域名白名单，默认 ai.shbdd.com | | SHBDD_REGISTER_URL | 覆盖默认注册页（默认含 product=workbuddy&tag=本 Skill slug） | | SHBDD_ACQUISITION_PRODUCT | 引流渠道，默认 workbuddy | | SHBDD_ACQUISITION_TAG | 引流标签，默认取 Skill 目录名 |