让任意 AI Agent 一句话生成 GEO 品牌报告
SouGEO Skill + CLI 接入指南
搜极星 GEO 报告能力深度接入Agent对话流，让 AI Agent 一句话搞定全流程。零配置、零代码，无需任何编程门槛，从登录、生成、进度追踪到取链分享，覆盖国内外 11 大主流 AI 平台。
这是什么
GEO 是 SEO 的 AI 时代继任者，而 SouGEO Skill 是把这份能力交给 AI Agent 的说明书。
GEO：生成引擎优化
GEO（Generative Engine Optimization）衡量品牌在 AI 大模型（豆包、DeepSeek、千问、文心一言、Kimi、ChatGPT、Claude、Gemini 等）生成回答中的可见度、引用率、排名与口碑。
当越来越多用户「有事问 AI」，品牌在 AI 回答里是否被提及、被推荐，直接决定生意流向。
sougeo-brand-report：面向 Agent 的 Skill
Skill 本身是给 Agent 看的「使用说明书」，真正执行报告生成的是 SouGEO CLI（命令名 sougeo）。两者配合，用户只需一句话，Agent 就能替你完成全流程。
设备码登录 / Token 登录双通道，auth status -o json 输出结构化登录态，可脚本化判断。
引导式生成、状态轮询、取报告链接、分页查询历史、share_code 二次分享。
权益余额查询、可购买套餐列表、下单购买与订单校验。
Windows / macOS / Linux（x64 / arm64），0 npm 依赖，安装时自动下载原生二进制。
豆包
文心
DeepSeek
Kimi
通义千问
智谱清言
元宝
ChatGPT
Claude
Gemini
Grok三步快速上手
完整安装分两步：先装 Skill，再装 CLI。Skill 是说明书，CLI 是执行器，只装 Skill 跑不了报告。
第一步 · 安装 Skill
三种方式任选其一：
npx -y skills add https://github.com/YOOTeam/SouGEO-CLI直接对任意已接入 Skill 机制的 Agent（WorkBuddy、千问办公、豆包、Trae、Claude Code、Cursor 等）说下面这段话，Agent 会自动拉取并安装到自己的技能目录：
帮我安装搜极星 SouGEO 的技能。技能文件在仓库下的 skills/sougeo-brand-report/ 目录（含 SKILL.md）：
- GitHub：https://github.com/YOOTeam/SouGEO-CLI
- Gitee（国内更快）：https://gitee.com/AiDoDesign/sougeo_cli
请从其中任一仓库下载该目录并放入你的技能目录，
然后验证 sougeo CLI 是否可用，不可用就用 npm 帮我装好（npm i -g @yooai/sougeo-cli）。从仓库下载 skills/sougeo-brand-report/ 目录（含 SKILL.md），复制到你的 Agent 技能目录即可。
第二步 · 安装 SouGEO CLI
Skill 装好后还不能直接出报告——必须安装它驱动的 SouGEO CLI（要求 Node 16 以上）：
npm i -g @yooai/sougeo-cli
sougeo version show国内网络提示：若 npm 默认镜像源报 404（新包同步延迟），改用官方源安装：npm i -g @yooai/sougeo-cli --registry=https://registry.npmjs.org
第三步 · 一句话生成报告
对 Agent 说一句话即可触发完整闭环，Agent 会自动完成以下流程：
帮我分析一下小米在 AI 里的表现- 1检测 CLI 可用性（未安装则自动 npm 安装）
- 2识别报告类型 → 询问企业 / 个人品牌
- 3据品牌名生成产品类型候选（如智能手机 / 智能家居 / 汽车）
- 4生成一批用户视角 GEO 测试问题 → 用户点选（品牌不超过 3 条，不含品牌名）
- 5地域解析（模糊词按 IP 归属地兜底）→ 参数确认单 → 用户确认
- 6创建报告 → 轮询状态至完成 → 取回在线报告链接
- 7交付：品牌指数等基础小结 + 在线报告链接
sougeo report create -r brand -b 小米 -a company -p 智能手机 \
-q "除了几个大牌，还有哪些性价比高的手机值得考虑？" \
-q "适合学生党、预算 3000 以内的手机推荐哪款？" \
-l 1 -P 1,3,4,5,6,7,8
sougeo report status <report_id> --watch
sougeo report read <report_id> --type linkAgent 令牌：创建与管理
令牌让 Agent 以你的账号身份安全访问 SouGEO 服务，无需暴露账号密码。
什么是 Agent 访问令牌
Agent 访问令牌是授权 Agent（或 CLI）通过服务接口访问你账号的专属凭证，适合把 SouGEO 能力接入自己的自动化工作流。每个令牌可独立命名、独立设置有效期、独立吊销。
创建令牌
- 1登录 sougeo.com，进入「个人中心 → Agent 访问」。
- 2点击「新增令牌」，输入令牌名称（不超过 32 字，例如：数据分析助手）。
- 3选择有效时间：7 / 30 / 90 / 365 天，或永久。
- 4点击「创建令牌」，系统生成令牌并仅展示一次——立即复制并妥善保存，关闭弹窗后将无法再次查看。
- 5把令牌交给 Agent 登录：sougeo auth token 加你的令牌，即可开始使用。
令牌管理
在令牌列表点击铅笔图标即可重命名，便于区分不同 Agent 或使用场景。
点击垃圾桶图标并确认后，使用该令牌的 Agent 连接将立即失去访问权限。
列表中可查看创建时间与有效时间；过期令牌标记为「已过期」，需新建令牌替换。
安全须知
- 令牌仅在创建成功时完整展示一次，列表中始终脱敏显示。
- 请勿把令牌提交到代码仓库或分享给不受信任的一方。
- 怀疑泄露时，立即删除该令牌并创建新令牌。
在 CLI 中使用令牌登录
Agent 在终端中使用以下命令完成登录（Token 登录为非交互式，Agent 首选）：
sougeo auth token <YOUR_TOKEN>
sougeo auth status -o json无令牌时也可使用设备码登录（会自动打开浏览器完成授权）：
sougeo auth login主流 Agent 体验：10+ Agent 平台（+Personal Agent）
全面兼容 10+ Agent 平台（+Personal Agent）。Skill 只需安装一次，任何支持 Skill / 技能机制的 Agent 都能驱动 SouGEO CLI，支持「一句话安装」或手动复制到技能目录。
WorkBuddy
千问办公
豆包工作
Codex
Claude Code
Cursor
Muse
CueGrok Bot
Today.ai帮我安装搜极星 SouGEO 的技能。技能文件在仓库下的 skills/sougeo-brand-report/ 目录（含 SKILL.md）：
- GitHub：https://github.com/YOOTeam/SouGEO-CLI
- Gitee（国内更快）：https://gitee.com/AiDoDesign/sougeo_cli
请从其中任一仓库下载该目录并放入你的技能目录，
然后验证 sougeo CLI 是否可用，不可用就用 npm 帮我装好（npm i -g @yooai/sougeo-cli）。WorkBuddy
对 WorkBuddy 说一句话即可自动安装；也可手动复制到 ~/.workbuddy/skills/ 目录。
适合办公场景下的随时洞察：在对话中直接发起品牌 / 行业 GEO 分析，报告链接直接在会话中交付。
千问办公
对千问办公说一句话自动安装；或手动复制到 ~/.qwenworkcn/skills/ 目录。
与日常办公流程无缝衔接，适合在文档整理、行业调研时顺带生成 GEO 洞察报告。
豆包工作
在支持技能 / Agent 工作台的豆包端内，粘贴安装提示词即可自动完成安装。
国内平台覆盖最完整的入口之一：默认勾选豆包在内的 7 大国内平台，一次生成横向对比。
Codex
对 Codex 说一句话即可自动安装到其技能目录。
AI IDE 场景首选：边写代码边测品牌，适合开发者把 GEO 检测嵌入产品迭代流程。
Claude Code
对 Claude Code 说一句话自动安装；或手动复制到 ~/.claude/skills/ 目录。
命令行原生体验：适合在终端中批量跑品牌矩阵监测，配合 JSON 输出做自动化脚本。
WorkBuddy
对 WorkBuddy 说一句话即可自动安装；也可手动复制到 ~/.workbuddy/skills/ 目录。
适合办公场景下的随时洞察：在对话中直接发起品牌 / 行业 GEO 分析，报告链接直接在会话中交付。
千问办公
对千问办公说一句话自动安装；或手动复制到 ~/.qwenworkcn/skills/ 目录。
与日常办公流程无缝衔接，适合在文档整理、行业调研时顺带生成 GEO 洞察报告。
豆包工作
在支持技能 / Agent 工作台的豆包端内，粘贴安装提示词即可自动完成安装。
国内平台覆盖最完整的入口之一：默认勾选豆包在内的 7 大国内平台，一次生成横向对比。
Codex
对 Codex 说一句话即可自动安装到其技能目录。
AI IDE 场景首选：边写代码边测品牌，适合开发者把 GEO 检测嵌入产品迭代流程。
Claude Code
对 Claude Code 说一句话自动安装；或手动复制到 ~/.claude/skills/ 目录。
命令行原生体验：适合在终端中批量跑品牌矩阵监测，配合 JSON 输出做自动化脚本。
Cursor
对 Cursor 说一句话即可自动安装到其技能目录。
在 AI 代码编辑器中直接调用报告创建、状态轮询等能力，适合技术团队集成验证。
Muse
Personal Agent在 Muse 中粘贴安装提示词即可自动装入技能库，无需任何配置文件。
个人智能助理场景：随口一问即可发起 GEO 分析，把品牌洞察融入日常对话。
Cue
Personal Agent对 Cue 说一句话即可自动安装；或手动复制到其技能目录。
轻量快捷的个性化入口：适合随时查询品牌在 AI 中的最新表现。
Grok Bot
Personal Agent在 Grok Bot 中发送安装提示词即可完成技能装载。
偏好实时风格的用户入口：一句话发起分析，快速拿到 11 平台对比结果。
Today.ai
Personal Agent对 Today.ai 说一句话即可自动安装到其技能目录。
个人 AI 门户场景：把 GEO 监测嵌入每日信息流，持续追踪品牌变化。
Cursor
对 Cursor 说一句话即可自动安装到其技能目录。
在 AI 代码编辑器中直接调用报告创建、状态轮询等能力，适合技术团队集成验证。
Muse
Personal Agent在 Muse 中粘贴安装提示词即可自动装入技能库，无需任何配置文件。
个人智能助理场景：随口一问即可发起 GEO 分析，把品牌洞察融入日常对话。
Cue
Personal Agent对 Cue 说一句话即可自动安装；或手动复制到其技能目录。
轻量快捷的个性化入口：适合随时查询品牌在 AI 中的最新表现。
Grok Bot
Personal Agent在 Grok Bot 中发送安装提示词即可完成技能装载。
偏好实时风格的用户入口：一句话发起分析，快速拿到 11 平台对比结果。
Today.ai
Personal Agent对 Today.ai 说一句话即可自动安装到其技能目录。
个人 AI 门户场景：把 GEO 监测嵌入每日信息流，持续追踪品牌变化。
提示：手动安装时请认准仓库的 skills/sougeo-brand-report/ 子目录；安装后记得完成上方第二步的 SouGEO CLI 安装。
CLI 命令速查
安装后命令名为 sougeo（Linux / macOS 大小写敏感时使用 SouGEO）。
sougeo auth login设备码登录（自动打开浏览器）sougeo auth token <token>Token 登录（Agent 首选，非交互）sougeo auth status -o json查询登录状态（-o json 结构化输出）sougeo auth logout退出登录（删除本地凭证）sougeo report create ...引导式创建报告（-q 关注问题必填，品牌不超过 3 条 / 行业不超过 6 条）sougeo report status <id> --watch轮询生成状态直至完成sougeo report read <id> --type link读取在线报告链接（默认；--type json 取结构化数据）sougeo report list -t brand分页查询历史报告（brand / industry / shield）sougeo report share start <id> -t 3days开始分享（-t 3days、week 或 always）并拼装 share_code 分享链接sougeo report share stop <id>停止分享sougeo rights list查询账户权益余额sougeo rights sku list查询可购买套餐列表sougeo rights pay创建订单并购买sougeo rights check <order>校验订单支付状态关于分享链接
分享后生成 sougeo.com/ReportResults?share_code=xxx 格式的链接。打开分享链接仍需登录 SouGEO 账号才能查看；分享后可在官网查看查看者与访问记录。
相关链接
准备好了吗？
创建一枚 Agent 令牌，让你的 AI 助手现在就开始洞察品牌在 AI 世界里的真实表现。