← 返回 Skills 市场
tangyuanmile-coder

AIDSO 虾搜 GEO

作者 tangyuanmile-coder · GitHub ↗ · v2.0.1 · MIT-0
cross-platform ⚠ suspicious
162
总下载
0
收藏
0
当前安装
2
版本数
在 OpenClaw 中安装
/install aidso-xiasou-geo
功能描述
AIDSO_虾搜GEO - GEO品牌诊断、知识库、GEO内容生产。 **当以下情况时使用此 Skill**: (1) 用户要发起或查询品牌 GEO 诊断:如「帮我做一个XX的GEO诊断报告」「查一下XX的GEO表现」 (2) 用户要管理知识库:如「建知识库」「加到知识库」 (3) 用户要生成 GEO 优化内容:...
使用说明 (SKILL.md)

AIDSO_虾搜GEO Skill

⚠️ Agent 必读约束

🌐 站点与域名

  • API 主域名:https://api.aidso.com
  • 官网:https://geo.aidso.com
  • API key 获取地址:https://geo.aidso.com/setting?type=apiKey&platform=GEO
  • 诊断结果查看页:https://geo.aidso.com/completeAnalysis

所有业务 API 请求必须使用 AIDSO 的正式 API 域名。
官网链接仅用于用户查看、获取 API key、购买积分或查看结果。

🔑 API key 绑定规则

AIDSO GEO 能力依赖用户已绑定的 API key。

每次调用任何 AIDSO GEO 相关 API 前,先检查当前用户是否已保存 API key。

  • 若已保存:直接继续执行用户原本请求
  • 若未保存:进入 API key 绑定流程
  • 若后端返回 401invalid token鉴权失败、明确表示 API key 无效:清空已保存 API key,并要求用户重新绑定

⚠️ 当前绑定流程 不做预验证
用户输入 API key 后,直接保存
后续任意真实业务请求都会自动携带该 API key。
若 API key 不正确,由后端返回错误后再提示用户重新绑定。

API key 绑定的完整规则见: references/apikey.md

🔒 安全规则

  • 不要主动展示用户已保存的完整 API key
  • 不要在回复中回显完整 API key
  • 不要要求用户重复输入已保存的 API key
  • API key 仅用于调用 AIDSO GEO 相关接口
  • 若用户未绑定 API key,不要尝试调用任何需要鉴权的业务接口

🧭 总体执行原则

  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优化」

试试说吧!

安全使用建议
This skill appears to do what it says (GEO diagnostics, knowledge-base uploads, and content generation via api.aidso.com), but there are a few red flags to consider before installing: - It asks you to provide an AIDSO API key and instructs the agent to save that key directly into openclaw.json without validating it first. That means your key could be stored persistently (likely plaintext) in the agent config. Only proceed if you trust the AIDSO provider and understand where openclaw.json is stored and who can access it. - There are multiple minor inconsistencies in the docs vs code (different content endpoint paths, stray double-slashes in URLs, README advising packages not used by the scripts). These look like sloppy documentation rather than active malicious behavior, but they reduce confidence. - The skill will send whatever API key you supply to api.aidso.com in x-api-key headers as part of normal operation. If you prefer not to have the skill persist the key, consider providing the key via an environment variable (AIDSO_GEO_API_KEY) under your control and confirm whether the platform allows preventing permanent storage. What you can do before installing: 1) Verify the skill publisher / homepage (https://geo.aidso.com) and confirm trustworthiness and privacy policy. 2) Ask the publisher to (a) add pre-validation of API keys before saving, (b) avoid unconditional storing of secrets or at least advise on storage protection, and (c) fix endpoint/documentation inconsistencies. 3) If you must use it, prefer supplying the API key only in an environment variable scope you control (AIDSO_GEO_API_KEY) and audit openclaw.json after first use to confirm whether the key was saved and where. If you want, provide the path where openclaw.json would be stored on your system or ask the skill author for a version that only uses ephemeral environment variables and performs a validation check before persisting keys; that would raise confidence to 'benign.'
功能分析
Type: OpenClaw Skill Name: aidso-xiasou-geo Version: 2.0.1 The skill bundle provides integration with the AIDSO GEO platform for brand diagnosis, knowledge base management, and content generation. The Python scripts (content_poll.py and diagnosis_poll.py) are standard polling utilities that use the requests library to communicate with the official API (api.aidso.com) and do not contain any shell execution or data exfiltration logic. The instructions in SKILL.md and the references/ directory are well-structured, focusing on business logic and security best practices, such as masking API keys and validating user intent before processing.
能力标签
requires-sensitive-credentials
能力评估
Purpose & Capability
Name/description map to the included scripts and API calls (brand diagnosis, knowledge base upload, content generation). The skill expects an API key for api.aidso.com which is proportionate to the stated purpose. Minor inconsistencies exist in documented endpoint paths (see instruction_scope) but overall required capabilities align with the stated purpose.
Instruction Scope
SKILL.md and references instruct the agent to check/bind an API key and to call AIDSO APIs only. However: (1) the binding flow explicitly states it will 'directly save' whatever the user provides without pre-validation; (2) the docs and code have inconsistent endpoint paths (e.g., content API listed as /openapi/skills/run_realtime_report in references and /openapi/skills/geo_content/generate in scripts; some docs show double slashes); (3) README suggests installing packages (markdown, weasyprint) not used by the included polling scripts. The direct-save behavior and documentation mismatches are sloppy and raise operational/privacy concerns.
Install Mechanism
There is no formal install spec (instruction-only), so little is written to disk during install. The package includes Python scripts that require python3 (declared in _meta.json). README suggests 'pip install requests markdown weasyprint' but scripts only import requests; the extra suggested packages appear unnecessary. No remote downloads or unusual install URLs are present.
Credentials
The only credential surface is an API key for the AIDSO GEO service (AIDSO_GEO_API_KEY marked optional). Requesting an API key is proportional to the skill's networked functionality. No unrelated credentials or system config paths are requested.
Persistence & Privilege
The skill explicitly instructs saving the user's API key into openclaw.json (a persistent agent config) and to continue executing requests using that saved key. The binding flow does not pre-validate or sanitize the key and forbids echoing it back, which increases the chance that a secret will be stored plaintext. While writing its own credential into agent config can be legitimate, the unconditional 'direct save' without validation and lack of guidance about storage security is a notable privacy/persistence risk.
如何使用
  1. 确保已安装 OpenClaw(本地或 Docker 部署)
  2. 在对话框中输入安装命令:/install aidso-xiasou-geo
  3. 安装完成后,直接呼叫该 Skill 的名称或使用 /aidso-xiasou-geo 触发
  4. 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
v2.0.1
- Expanded GEO诊断相关 API 路由,新增 /openapi/skills/get_questions 和 /openapi/skills/band_report/md/v2 支持 POST 方法 - 更新 GEO诊断 API 路由表,替换原有 GET 请求为 POST,并采用新版路径 - 其他功能与规则保持一致,无破坏性变更 - 品牌诊断新增诊断问题确认环节,诊断问题数量不同,消耗的积分数不一样。
v2.0.0
AIDSO_虾搜GEO 2.0.0 - 全新支持 GEO 品牌诊断、知识库管理和 GEO 优化内容生产三大能力 - 新增 API key 绑定和鉴权流程,提升账户安全管理 - 引入详细的指令路由和自然语言意图识别机制 - 完善错误处理和用户积分提示逻辑 - 提供清晰的使用文档与执行约束,确保安全、准确响应
元数据
Slug aidso-xiasou-geo
版本 2.0.1
许可证 MIT-0
累计安装 0
当前安装数 0
历史版本数 2
常见问题

AIDSO 虾搜 GEO 是什么?

AIDSO_虾搜GEO - GEO品牌诊断、知识库、GEO内容生产。 **当以下情况时使用此 Skill**: (1) 用户要发起或查询品牌 GEO 诊断:如「帮我做一个XX的GEO诊断报告」「查一下XX的GEO表现」 (2) 用户要管理知识库:如「建知识库」「加到知识库」 (3) 用户要生成 GEO 优化内容:... 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 162 次。

如何安装 AIDSO 虾搜 GEO?

在 OpenClaw 或 Claude Code 对话框中运行命令「/install aidso-xiasou-geo」即可一键安装,无需额外配置。

AIDSO 虾搜 GEO 是免费的吗?

是的,AIDSO 虾搜 GEO 完全免费,采用 MIT-0 许可证,可自由下载、安装和使用。

AIDSO 虾搜 GEO 支持哪些平台?

AIDSO 虾搜 GEO 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。

谁开发了 AIDSO 虾搜 GEO?

由 tangyuanmile-coder(@tangyuanmile-coder)开发并维护,当前版本 v2.0.1。

💬 留言讨论