AIDSO 虾搜 GEO
by @tangyuanmile-coder
AIDSO虾搜 GEO 一体化 Skill,支持统一 API Key 绑定、检查、品牌诊断报告、品牌知识库、GEO 内容生产、GEO 问题挖掘。
clawhub install aidso-xiasou-geo📖 About This Skill
name: AIDSO_虾搜GEO description: | AIDSO_虾搜GEO - GEO品牌诊断、知识库、GEO内容生产。
当以下情况时使用此 Skill: (1) 用户要发起或查询品牌 GEO 诊断:如「帮我做一个XX的GEO诊断报告」「查一下XX的GEO表现」 (2) 用户要管理知识库:如「建知识库」「加到知识库」 (3) 用户要生成 GEO 优化内容:如「GEO内容生产」 user-invocable: true metadata: {"openclaw":{"emoji":"🦐","baseUrl":"https://api.aidso.com","homepage":"https://geo.aidso.com","optionalEnv":["AIDSO_GEO_API_KEY"]}}
AIDSO_虾搜GEO Skill
⚠️ Agent 必读约束
🌐 站点与域名
https://api.aidso.comhttps://geo.aidso.comhttps://geo.aidso.com/setting?type=apiKey&platform=GEOhttps://geo.aidso.com/completeAnalysis> 所有业务 API 请求必须使用 AIDSO 的正式 API 域名。 > 官网链接仅用于用户查看、获取 API key、购买积分或查看结果。
🔑 API key 绑定规则
AIDSO GEO 能力依赖用户已绑定的 API key。每次调用任何 AIDSO GEO 相关 API 前,先检查当前用户是否已保存 API key。
401、invalid token、鉴权失败、明确表示 API key 无效:清空已保存 API key,并要求用户重新绑定> ⚠️ 当前绑定流程 不做预验证。 > 用户输入 API key 后,直接保存。 > 后续任意真实业务请求都会自动携带该 API key。 > 若 API key 不正确,由后端返回错误后再提示用户重新绑定。
API key 绑定的完整规则见: references/apikey.md
🔒 安全规则
🧭 总体执行原则
1. 先做意图识别,再路由到对应模块 2. 命中具体能力后,读取对应references/*.md 获取完整规则和接口说明
3. 业务处理必须严格基于后端返回,不自行猜测品牌不存在、报告失败、内容生成失败等结论
4. 所有 JSON 返回都按 UTF-8 解析
5. 后台返回的错误文案应尽量原样返回给用户
6. 若出现“积分不足”,在原始后台文案后追加购买提示:
请前往 https://geo.aidso.com 购买积分指令路由表
> 匹配指令后, 用 read 工具 读取对应的 references/xxx.md 获取完整 API 文档。
| 指令 | 角色 | 说明 | 详细文档 |
|------|------|------|---------|
| /aidso config 或「绑定 API key」 | ⚙️ 配置 | 绑定、更新、重绑 API key | references/apikey.md |
| /aidso diagnosis 或「GEO诊断」 | 📊 诊断官 | 品牌诊断、结果轮询、报告返回 | references/diagnosis.md |
| /aidso knowledge 或「品牌知识库」 | 📚 知识管理员 | 品牌知识库CRUD | references/knowledge.md |
| /aidso content 或「GEO内容生产」 | ✍️ 内容生产官 | 根据品牌 + 问题 + 平台生成 GEO 优化内容 | references/content.md |
自然语言路由
「配置/绑定/连接爱搜」 → /aidso config
「GEO诊断」相关 → /aidso diagnosis
「品牌知识库」相关 → /aidso knowledge
「生产内容/优化」相关 → /aidso content
决策原则:优先匹配最具体的意图。
API 路由表
> > ⚠️ 构造请求时必须使用下表中的完整路径,Base URL 为 https://api.aidso.com。如果收到 404,说明路径不对,请对照此表检查。
GEO诊断
| 方法 | 路径 | 说明 | 详细文档 |
|------|------|------|----------|
| POST | /openapi/skills/get_questions | GEO诊断 | references/diagnosis.md |
| POST | /openapi/skills/band_report/md/v2 | GEO诊断 | references/diagnosis.md |
品牌知识库
| 方法 | 路径 | 说明 | 详细文档 |
|------|------|------|----------|
| POST | /openapi/skills/save_content/md | 品牌知识库 | references/knowledge.md |
GEO内容生产
| 方法 | 路径 | 说明 | 详细文档 |
|------|------|------|----------|
| POST | /openapi/skills/run_realtime_report | 品牌知识库 | references/content.md |
鉴权方式
所有 AIDSO GEO 相关请求都使用用户已绑定的 API key。
请求头格式:x-api-key: {用户已绑定的_api_key}
通用错误处理
{
"code": XXX,
"msg": "XXXX"
}
| 错误码 | 说明 | 处理方式 |
|--------|------|---------|
| 401 | 鉴权失败 | 检查 API Key ,或重新绑定 |
| 405 | 积分不足 | 引导充积分:请前往https://geo.aidso.com 购买积分 |
| 405 | 其他错误 | 返回后台 msg |
首次API Key配置成功后回复
✅ AIDSO_虾搜GEO 配置完成! 凭证已写入 openclaw.json,服务已自动热加载生效。 现在你可以使用以下功能了: 🔍 GEO诊断 — 「帮我做一个 XX 的GEO诊断」「做一个 XX 的品牌GEO报告」 📚 品牌知识库 — 「上传品牌知识库」「把品牌介绍加入知识库」 📝 GEO生产内容 - 「GEO优化」
试试说吧!