Vigilath GEO 优化

把本宿主 agent 链接到 Vigilath——检测·审计·优化·监控品牌在 AI 搜索引擎中的可见性。

两层能力,门槛完全不同:

• 免登录层:任何网站的 GEO + SEO 体检(check),免费、不限次、不需要任何凭证。先用这层—— 用户还没有 Vigilath 账号时也能立刻拿到真实分数。
• 授权层:绑定某账号的 GEO agent(一只"小龙虾"),看该账号的真实投放数据、跑一键全面诊断、 查舆情、产稿。需要装 skill 时做过设备码授权。

能做什么

下面每一项都是真做得到的,不是宣传语。免登录那几项装完就能用;其余需要跑一次 login 授权。

检测(免登录、免费)

| 能力 | 给什么 | 得到什么 | |---|---|---| | 网站 AI 可读性体检 | 一个网址 | 25 类逐项评分 + 0–100 分与等级,哪几项没做对 | | 传统 SEO 体检 | 一个网址 | 12 类 SEO 评分 + 独立分数(与 GEO 分分开算) | | AI 提及快测 | 品牌 + 行业词 | 3 个引擎 × 3 条品类问题的引擎原话,AI 推荐了谁、有没有你 | | 行业榜 | 行业名 | 该行业 AI 里谁是 TOP1、集中度、走势(仅已建库行业) |

诊断与数据(需授权)

| 能力 | 得到什么 | |---|---| | 一键全面诊断 | 八项子检测 · 五维评分 · 十一章报告 · 可导 PDF(整单 8–20 分钟) | | 报告中心 | 日报 / 周报 / 月报的六项指标 + 环比 + 达标判定 + 该期 AI 总结 | | 走势 | 最近若干期指标对比,涨了还是跌了 | | 累计覆盖 | 一共被 AI 搜到过多少个问题、多少个种子词 | | 命中清单 | 哪些问题已被命中(含引擎与次数)、哪些投了还没命中 | | 跑批状态 | 最近一次跑完没有、跑了多少条、哪个平台报错 | | 根因诊断 | 为什么没露出的归因与叙述 |

选词与监测(需授权)

| 能力 | 得到什么 | |---|---| | 建主题 | 新建品牌主题(每账号目前限 1 个,已有则拒绝) | | 看主题 | 当前品牌主题、种子词与扩展问题的数量与列表 | | 设定种子词 | 设定/覆盖主题的种子提示词(付费能力,未开通会被拦下并引导) | | 扩词 | 对一个种子词做四维场景扩展(检索 / 问答 / 意图 / 品牌),给候选 | | 落库选词 | 把选中的问题变成持续监测任务(付费能力) |

内容与发布(需授权)

| 能力 | 得到什么 | |---|---| | 生成文章 | 针对指定问题产出草稿(异步),发布前过广告法词库与资质校验 | | 文章管理 | 列文章 / 看全文 / 看待审 / 审核通过 / 驳回(带原因) | | 发文计划 | 确认模板 → 触发生成 | | 发布进度 | 已发布列表、今日发布 | | 真实外发 | 受平台护栏与合规闸门控制;收费 |

舆情(需授权,独立业务线)

| 能力 | 得到什么 | |---|---| | 今日舆情 | KPI · 7 天趋势 · 风险分布 · 最新简报 · 高风险 Top | | 历史回溯 | 某段时间有哪些负面 | | 实时热榜 | 当前热点,找可蹭的话题 | | 监测词 | 改关键词 / 别名 / 品牌名 |

优化任务与账户

| 能力 | 得到什么 | |---|---| | 优化任务中心 | 日报建议 / 复测退步 / 洞察建议 / 投放建议汇成的待办清单 | | 处理任务 | 转化、执行或忽略某条 | | 知识库 | 检索你自己上传的资料,据此回答 | | 账户 | 查余额、充值(网页扫码或 agent 直付)、看当前凭证能做什么 |

做不到的,也说清楚:引擎选择、查询调度与频率由平台固定,你和用户都不能指定; 每个账号目前限 1 个品牌主题;真实对外发布受平台护栏控制,不是随叫随发。

还有一个能力在这里用不到:平台 agent 能「替用户操作当前页面」(填表单 / 切主题 / 跳转), 但那要有网页上下文 —— skill 装在终端里没有页面可操作,别向用户承诺这件事。

何时用

用户(或上游任务)涉及以下任一,就调用本 skill:

网站体检(免登录,优先考虑这条)

• 「测一下这个网站」「这个站 GEO/SEO 怎么样」「帮我体检一下官网」
• 「我的网站对 AI 友好吗」「为什么 AI 抓不到我的站」
• 用户给了一个网址、想知道好不好——别问他要账号,直接 check

GEO 可见性

• 「我的品牌/产品在 AI 搜索里被搜到几个问题?」「AI 可见性怎么样?」
• 「帮我诊断 GEO/AEO 现状」「为什么 AI 不引用我?」
• 「竞品在 AI 引擎里的表现对比」
• 「今天/累计投放效果、命中率」「日报/周报/月报怎么样」「达标了吗」
• 「怎么优化/产稿提升被 AI 引用率」

舆情监控(同一个 token,同一套接口)

• 「今天舆情怎么样 / 有没有负面 / 风险高不高」
• 「以前/某段时间有哪些负面」(可追溯很久)
• 「今天有什么热点/热榜可以蹭」
• 「帮我把监测词/关键词改成 ⋯⋯」

不涉及以上两类的普通问题,不要调用。

怎么用

脚本在 scripts/geo_client.py,纯标准库、零依赖。

• 网站体检(免登录、免费、不限次;整站 25 类 GEO + 12 类 SEO 全跑,十几秒到一分钟):

  python scripts/geo_client.py check https://example.com
  python scripts/geo_client.py check https://example.com --no-seo   # 只要 GEO
  

  返回 geo / seo 两半,各有 0–100 分与等级。分数是全量跑出来的、真实; 但 visible_categories 只有免费档能看的那几类明细,其余在 locked_categories 里 只给类目名、不给结论,也没有修复建议。念分数和已见明细即可, 不要对锁住的类目编造结论;想要完整明细就照 note 引导用户注册后 login。

• 行业榜(同样免登录、免费):看某行业在 AI 搜索里谁是 TOP1、集中度多高。

  python scripts/geo_client.py industry                    # 已建库的行业清单
  python scripts/geo_client.py industry 商用清洁机器人      # 该行业详情
  

  只覆盖已建库的行业。用户的行业不在清单里就如实说, 绝不拿别的行业的数字替代,也不要把行业数据说成用户自己品牌的表现。

• 对话式(让 GEO agent 自己跑工具、给结论 + 结构化卡片):

  python scripts/geo_client.py chat "今天投放效果怎么样?累计被搜到几个问题?"
  

  输出 = 一段自然语言回答 + 一段「结构化卡片」JSON(命中数字、竞品等)。把卡片里的数字念给用户,别只复述自然语言。

• 只取数(不走大模型,更快、更省;只要数字时用):

  | 命令 | 拿到什么 | |---|---| | data overview | 报告中心最新数据:日/周/月各最新一期的六项指标 + 环比 + 达标 | | data period | 某一期详情:六项指标 + 环比 + 分平台整体露出率 + 该期 AI 总结正文 | | data periods | 最近若干期的六项指标(新→旧),看走势 | | data coverage | 累计被命中的问题数 / 种子词数(问题级去重) | | data publish | 发布进度 + 已发布文章列表 | | data diagnosis | 一键全面诊断的进度或结果摘要 | | data run | 最近一次跑批的执行状态(跑完没 / 多少条 / 哪个平台报错) |

  python scripts/geo_client.py data overview
  

  旧名 today / growth / batch / report 仍可用(分别等价于 overview / overview / run / diagnosis),新接入一律用上表的新名。

• 看权限(当前 token 能做什么,决定要不要提"产稿/发布"):

  python scripts/geo_client.py capabilities
  

鉴权

check 不需要凭证,没装 token 也能跑。其余命令都要:

脚本从环境变量读凭证,绝不硬编码、绝不打印 token:

• VIGILATH_AGENT_TOKEN(必填)—— 1 年期账号 token,由 Vigilath 领号发放。
• VIGILATH_BASE(选填)—— 默认 https://vigilath.cn/api/agent/v1;一行安装会按你的站点域名自动写好,通常不用管。

凭证失效时可重新授权(终端出配对码、用户到浏览器批准,不用重装 skill):

python scripts/geo_client.py login

数字口径(必须遵守,说错数比不说更糟)

• 只念接口返回的数字,绝不自己换算、绝不把不同命令的数字相加或相除。返回的百分比已经是最终值(0–100 且已四舍五入),不要再乘 100。
• 六项指标的名字照抄返回里的 metric_labels:整体露出率、TOP1露出率、TOP3露出率、内容中正率、文章引用率、品牌声量度。不要自创「命中率」「曝光率」「覆盖率」来指代它们。
• 以「已收口」的期次为准:日报最新一期是昨天,今天的还在跑。用户问「今天怎么样」时先给已收口的数字,再补一句今天的进行中数据并标明未收口、仅供参考,绝不拿它下结论。
• 「达标了吗」一律看周报,不要用日报数字回答。
• coverage(问题有没有被搜到过,按问题去重)与整体露出率(每条应答里有没有提到本品,按应答)是两个口径,不可混用、不可互相换算、不可在同一句里当同一指标解释。
• data diagnosis 是「一键全面诊断报告」,不是报告中心的日/周/月报,别混为一谈。

余额与付费(撞到 402 时看这里)

发文、投放这类动作是收费的,走账号的算力点钱包。

python scripts/geo_client.py wallet          # 看余额 —— 花钱的动作之前先看一眼
python scripts/geo_client.py topup 100       # 充值 100 元:返回怎么付
python scripts/geo_client.py topup 100 --tx 0x…   # 链上付完,带交易哈希来核销

撞到 402 不是出错,是「要付费」:响应里带着还需要多少、当前余额、以及两条充值路径。

• 让用户去网页充值(微信扫码):把响应里 web 给的页面地址告诉他
• 你自己付(agent 直付):按 accepts 里的网络、资产、收款地址、金额付款, 拿到交易哈希后 topup <金额> --tx <哈希> 核销入账

三条纪律:

• 金额和收款地址原样念,一个字都别改、别自己算。 付错地址的钱找不回来。
• 余额不足时不要反复重试 —— 每次都会失败,而且会让用户以为是系统故障。停下来说清要充多少。
• 不要替用户决定充多少。 报出这一单需要的数,让他决定。

边界(照实告诉用户)

• check 测的是站点自身对 AI 的友好度(可抓取性、结构化、元信息、权威信号等静态信号), 不等于 AI 引擎实际怎么说这个品牌。用户问「AI 到底提不提我 / 引不引用我」时, 别拿体检分回答——那要「一键全面诊断」(走 chat,需授权,整单 8–20 分钟)。
• 引擎选择、查询调度、频率由 Vigilath 平台固定,你和用户都不能指定,只看结果。
• 真实对外发布不在本 skill 能力内(受平台内部护栏控制);本 skill 只做查询 / 诊断 / 归因 / 优化建议。
• 一键全面诊断是重任务,整单 8–20 分钟:发起后如实告诉用户要等多久、让他稍后回来看,不要在同一轮里反复查进度,也不要谎称"马上好"。
• 遇到返回里有 gated: true:这是需开通的付费能力,如实转达并请用户联系 Vigilath,绝不谎称已设置成功或已落库;不要重试、不要换个说法再试。
• 一个 token = 一个账号,只能看该账号自己的数据。
• 出现 401 报错 = token 无效/过期。让用户跑 python scripts/geo_client.py login 重新授权; 仍不行再联系 Vigilath。别重试刷接口。