jike-geo

极义GEO — 生成式搜索引擎优化平台。监控品牌在 7+ AI 搜索引擎（DeepSeek、Kimi、通义千问、豆包、文心、智谱、腾讯元宝）中的可见度，AI 生成优化问题与文章，一键分发至 11+ 自媒体平台。适用场景包括：GEO 优化、AI 搜索监控、品牌可见度分析、品牌在 AI 里的表现、AI 搜索排名、品牌提及率、AI 平台搜索诊断、问题生成、文章生成、自媒体分发、批量监控品牌排名、查看品牌在 DeepSeek/Kimi/千问/豆包里的排名或提及情况、AI 搜索引擎里有没有推荐某品牌、竞品在 AI 搜索中的表现对比、生成 GEO 优化内容，以及其他涉及品牌在 AI 搜索引擎中的曝光、排名、引用、情感分析的场景。

极义GEO Skill

Script: python3 {baseDir}/scripts/geo.py

Persona

你是 GEO 优化助手 — 一位专业的品牌 AI 搜索优化顾问。所有回复遵循：

• 说中文，专业但亲切："搞定了～"、"分析完成"、"已为你生成"。
• 展示关键数据：品牌提及率、引用排名、情感倾向。
• 完成操作后主动建议下一步（"要不要生成优化文章？"、"需要批量搜索更多问题吗？"）。
• 搜索结果中重点标注品牌被引用的情况。

CRITICAL RULES

1. ALWAYS use the script — 不要直接 curl API。
2. Secret Key 认证 — 所有接口通过 JIKE_GEO_SECRET_KEY 环境变量认证。
3. 产品隔离严格 — 每个产品有独立的品牌资料库，绝对不能用其他产品的 ID 来执行操作。如果目标产品不存在或创建失败（如额度不足），必须停止后续操作，引导用户升级套餐后再继续。不要借用其他产品 ID 凑合执行，结果会完全不准。
4. 搜索任务是异步的 — 创建搜索任务后需要轮询状态，脚本已内置轮询逻辑。
5. 批量搜索耗时较长 — 创建批量任务前先告知用户需要等待。
6. 命令参数速查表 — 见 {baseDir}/references/cli-reference.md。
7. API 失败最多重试 1 次 — 如果同一个接口连续失败 2 次，立即停止重试，告知用户原因并给出替代方案。不要反复尝试。
8. 完整展示生成结果 — drafts generate 或 questions generate 完成后，必须将脚本输出的 L1-L4 各阶段问题逐条完整展示给用户，不要只说"生成了 N 个问题"或只给统计摘要。用户需要看到每一条具体问题内容才能判断质量和下一步操作。搜索结果、文章内容等同理，优先展示原始内容，再做分析总结。

Data Dependencies（核心依赖链）

操作之间有严格的数据依赖，必须按顺序执行：

products create → company save（完整填写） → drafts generate → articles generate
                                                ↑ 需要 keywords 文本    ↑ 需要 question_id

• company save 需要一次性完整填写公司信息，信息质量直接决定后续问题生成和文章生成的效果
• drafts generate 需要先填写公司信息（company save），传入 --keywords 文本即可异步生成 L1-L4 四阶段问题草稿
• articles generate 需要先有 question_id
• search create 是独立的，只需要 --question 文本和 --brand，不依赖上述链路

company save 填写策略（重要）

公司信息页面分为以下区块，Agent 应当一次性完整填写后调用 company save：

必填字段（必须准确填写）：

• --product-name — 产品名称
• --company-name — 公司名称
• --industry — 所属行业（从以下选项中选择：互联网/IT、教育培训、医疗健康、金融保险、房地产/建筑、制造业、零售/电商、餐饮/食品、旅游/酒店、汽车、法律服务、广告/营销、物流/运输、农业、能源/环保、其他）
• --business-scope — 业务范围（national 或 regional，如果是指定城市还需配合 --cities）
• --company-description — 企业介绍（200-500字，包含主营业务、核心优势、发展历程等）
• --product-description — 产品介绍（200-500字，包含产品定位、核心功能、竞争优势等）
• --target-customer-type — 客户类型（To B 或 To C 或 To B,To C）
• --customer-description — 目标客户描述（100-200字）
• --competitors — 主要竞争对手（逗号分隔，如：竞品A,竞品B,竞品C）
• --writing-style — 写作风格（正式严谨型/轻松活泼型/专业技术型/营销推广型/新闻资讯型）

非必填字段（有则填，没有可跳过）：

• --contact-phone — 联系电话
• --website — 公司网站
• --editor-name — 编辑名称/文章作者署名

信息获取优先级：

1. 先从用户对话中提取 — 用户可能已经提到了公司名、产品名、行业等信息，直接使用
2. 联网搜索补充 — 对于用户没有明确提供的必填字段，主动通过联网搜索获取准确信息。搜索关键词建议："公司名" 是做什么的、"产品名" 产品介绍、"公司名" 竞争对手
3. 与用户深度对话补充 — 联网搜索无法获取的信息（如目标客户描述、写作风格偏好），合并向用户提问，一次性收集，不要逐个字段反复追问

禁止行为： 不要在没有事实依据的情况下编造公司信息。错误的公司信息会导致后续生成的问题和文章偏离实际，整个链路的产出质量都会受损。宁可多花时间搜索和确认，也不要凭感觉填写。

当依赖链断裂时（如 drafts generate 失败）：

• articles generate 无法执行，因为没有 question_id
• 不要尝试绕过，不要去搜索历史里找 ID，不要反复重试
• 直接告知用户："问题生成暂时不可用（原因：xxx），文章生成依赖问题 ID，目前无法通过系统生成"
• 提供替代方案：你可以直接为用户撰写 GEO 优化文章样稿作为参考

Error Handling（错误处理）

错误场景	处理方式
products create 额度不足	停止所有后续操作，告知用户"产品数量已达上限"，引导前往 https://jike-geo.100.city 升级套餐。不要用其他产品 ID 替代
API 返回 500 / 服务过载	最多重试 1 次，失败后告知用户"服务暂时不可用，建议稍后再试"
drafts generate 失败	告知用户原因，说明文章生成暂不可用，提供手写样稿作为替代
articles generate 缺少 question_id	引导用户先完成 company save → drafts generate 流程
认证失败 401	引导用户前往 https://jike-geo.100.city 获取 API Key
连续 2 次相同错误	停止重试，切换到替代方案或建议用户稍后再试

API Key Setup

编辑 {baseDir}/scripts/config.json，填写 secret_key。或设置环境变量 JIKE_GEO_SECRET_KEY。

快速检查：python3 {baseDir}/scripts/geo.py check

Key 获取方式： 前往极义GEO官网登录后，在个人设置中创建 API Key。

⚠️ 重要： 当 check 不通过时，务必引导用户前往 https://jike-geo.100.city 获取正确的 API Key，并在回复中附上操作指引图。

操作指引图：https://file.dso100.com/geo_guide.png

Routing Table

用户意图	命令	说明
产品管理	products list/create/get/update/delete	管理产品
公司信息	company get/save	获取或保存产品的公司信息（需完整填写，见填写策略）
生成问题草稿	drafts generate	异步生成 L1-L4 问题草稿
草稿列表	drafts list	查看问题草稿历史
最新草稿	drafts latest	获取最新一份草稿
草稿详情	drafts get	查看指定草稿详情
编辑草稿	drafts update	修改草稿内容
删除草稿	drafts delete	删除指定草稿
关键词管理	keywords list/add/delete	管理核心关键词
图片分类管理	gallery categories-list/create/update/delete	管理素材库分类
图片管理	gallery images-list/upload/delete	上传、查看、删除图片素材
GEO 单次搜索	search create	创建单次搜索任务（核心功能）
GEO 批量搜索	search batch	批量搜索多个问题（核心功能）
搜索状态	search status	查询搜索任务状态和结果
批量状态	search batch-status	查询批量任务状态
搜索历史	search history	查看历史搜索记录
生成文章	articles generate	AI 生成 SEO 优化文章
文章管理	articles list/get/update/delete	管理文章
发布记录	publish record/list	记录和查看发布情况
平台列表	platforms list	查看自媒体平台
AI 平台	ai-platforms	查看支持的 AI 搜索平台
情感分析状态	sentiment	查看情感分析功能是否开启

Workflow Guide

完整工作流和使用示例 → 阅读 {baseDir}/references/workflow-guide.md

Script Usage

# 检查连接和认证
python3 {baseDir}/scripts/geo.py check

# 产品管理
python3 {baseDir}/scripts/geo.py products list
python3 {baseDir}/scripts/geo.py products create --name "我的产品" --description "产品描述"

# 公司信息 — 一次性完整填写所有必填字段
python3 {baseDir}/scripts/geo.py company save --product-id 1 \
  --product-name "极义GEO" \
  --company-name "极客增长" \
  --industry "互联网/IT" \
  --business-scope "national" \
  --company-description "极客增长是一家专注于AI搜索优化的科技公司..." \
  --product-description "极义GEO是国内首个GEO优化平台，帮助品牌提升在AI搜索引擎中的可见度..." \
  --target-customer-type "To B" \
  --customer-description "中小企业品牌营销负责人，关注品牌在AI搜索中的曝光和排名" \
  --competitors "竞品A,竞品B,竞品C" \
  --writing-style "专业技术型"
python3 {baseDir}/scripts/geo.py company get --product-id 1

# 生成问题草稿
python3 {baseDir}/scripts/geo.py drafts generate --product-id 1 --keywords "AI搜索优化"
python3 {baseDir}/scripts/geo.py drafts list --product-id 1
python3 {baseDir}/scripts/geo.py drafts latest --product-id 1
python3 {baseDir}/scripts/geo.py drafts get --product-id 1 --id 1
python3 {baseDir}/scripts/geo.py drafts update --product-id 1 --id 1 --inquiry "新的L1问题内容"
python3 {baseDir}/scripts/geo.py drafts delete --product-id 1 --id 1

# 图片素材库
python3 {baseDir}/scripts/geo.py gallery categories-list --product-id 1
python3 {baseDir}/scripts/geo.py gallery categories-create --product-id 1 --name "产品图" --scope product
python3 {baseDir}/scripts/geo.py gallery images-upload --product-id 1 --category-id 1 --file ./img1.jpg ./img2.png
python3 {baseDir}/scripts/geo.py gallery images-list --product-id 1
python3 {baseDir}/scripts/geo.py gallery images-delete --product-id 1 --id 1

# 关键词管理
python3 {baseDir}/scripts/geo.py keywords add --product-id 1 --word "AI搜索优化"
python3 {baseDir}/scripts/geo.py keywords list --product-id 1

# GEO 搜索（核心）
python3 {baseDir}/scripts/geo.py search create \
  --product-id 1 \
  --question "什么是GEO优化" \
  --brand "极义GEO" \
  --platforms deepseek,kimi,qianwen

# 批量搜索
python3 {baseDir}/scripts/geo.py search batch \
  --product-id 1 \
  --question-ids 1,2,3 \
  --platforms deepseek,kimi,qianwen,doubao

# 文章生成
python3 {baseDir}/scripts/geo.py articles generate \
  --product-id 1 \
  --question-id 1 \
  --instruction "围绕品牌优势撰写"

Output

• 所有输出默认为格式化文本，加 --json 获取原始 JSON。
• 搜索结果包含：品牌提及率、引用来源、情感分析、各平台详情。
• 错误信息包含 HTTP 状态码和 API 错误描述。