SEOmatic AI Citations

安装指南

1. ClawHub CLI 从源直接安装技能的最快方式。
   npx clawhub@latest install seomatic-ai-citations
2. 手动安装 将技能文件夹复制到以下位置之一
   全局模式
   ~/.openclaw/skills/
   工作区
   /skills/
   优先级：工作区 > 本地 > 内置
3. 提示词安装 将此提示词复制到 OpenClaw 即可自动安装。
   请帮我使用 Clawhub 安装 seomatic-ai-citations。如果尚未安装 Clawhub，请先安装（npm i -g clawhub）。
   更倾向于下载？
   获取包含原生技能文件的ZIP压缩包。
   下载技能 (.zip)

什么是

SEOmatic AI Citations 使用存储的第一方证据，帮助你衡量 AI 平台如何使用你的网站：在真实的登录状态 AI 答案中观察到的引用、服务器端扫描结果、AI 爬虫抓取记录，以及由 AI 助手引荐的访问。这是一项 Openclaw Skills 集成，可用于调查 AI 可见度，避免将干净的未登录扫描结果误认为真实用户看到的内容。
此技能还会检查规范业务事实和内部链接健康状况，帮助解释不准确的 AI 答案。读取免费，范围限定于已连接的 SEOmatic 工作区，也不会触发扫描或消耗额度。SEOmatic 使用真实的 Google Search Console 数据，拟议的网站更改必须经用户批准后才能上线。

应用场景

查明 ChatGPT 或其他 AI 助手是否确实引用了该网站。
衡量 AI 爬虫抓取了哪些页面，以及哪些页面获得了 AI 引荐访问。
调查 AI 读取但未引用或链接到的页面。
比较不同 AI 引擎中观察到的引用，包括引用率和最佳位置。
当 AI 答案错误描述业务时，核查已发布的业务事实。
没有可用的观察引用数据时，使用服务器端扫描结果作为明确标注的备用数据。

工作原理

使用 observed_citations 操作查询 ai_citations，以检索通过用户浏览器扩展捕获的真实答案。默认报告时间范围为 28 天。
有观察数据时优先使用。查看各引擎的引用率、观察到的答案数、引用数和最佳引用位置。如果没有观察数据，请说明扩展可能尚未安装或日志记录可能已关闭；不要将空结果解读为 AI 从未引用该网站的证据。
如果没有观察数据，则使用 scan_results 操作查询 ai_citations，获取基于干净、未登录提示词的可比较服务器端结果。明确指出这些是扫描结果，而非观察结果。
使用 ai_pages 操作查询 traffic_analytics，查看每个页面的 AI 爬虫抓取量（fetchedByAi）和 AI 引荐访问量（aiVisits）。结合解读这些指标，以区分 AI 阅读并向访客推荐的页面，以及 AI 阅读但未链接的页面。
调查错误业务信息时，使用 brand_facts 操作查询 ai_citations。将 AI 的说法与已发布的规范事实进行比较，并检查内部链接健康状况；缺少权威事实可能是不准确答案的原因之一。
最后根据证据给出建议，例如改进易读但不易引用的页面，或补充缺失的业务事实。绝不要声称存在数据并未显示的引用。

配置指南

将 SEOmatic MCP 服务器连接到 AI 代理。服务器使用 https://app.seomatic.ai/api/mcp 上的 streamable HTTP 和 OAuth 身份验证。
或者，在 SEOmatic 控制面板的 AI 代理设置中创建一个以 smk_ 开头的 Bearer API 密钥：https://app.seomatic.ai/dashboard/settings?tab=ai-agents。
确保代理可以使用 SEOmatic MCP 服务器。此技能需要 seomatic MCP 服务器；不需要环境变量或本地二进制文件。
若要收集观察到的引用，请安装并启用 SEOmatic 浏览器扩展，以便捕获真实的登录状态 AI 答案。如果没有观察数据，此技能可以改用扫描结果。
此技能中的所有读取操作在 SEOmatic 免费套餐中均免费。它们使用存储的第一方数据，范围已限定于已连接的工作区，并且不会启动扫描或消耗额度。不要向用户询问其域名。

数据架构

此技能通过两个工具读取存储的数据：
工具 操作 返回的数据 解读
ai_citations observed_citations 按引擎统计的观察答案数和引用数、引用率及最佳引用位置；默认时间范围为 28 天 用户浏览器扩展从真实的登录状态 AI 答案中捕获的证据
ai_citations scan_results 针对干净、未登录提示词的服务器端结果 去个性化、可比较的扫描数据；应标注为扫描结果，而非观察结果
ai_citations brand_facts 已发布的规范业务事实、官方档案和内部链接健康状况读数 用于将 AI 的说法与网站声明的事实进行比较
traffic_analytics ai_pages 每个页面的 fetchedByAi 和 aiVisits 指标 显示 AI 爬虫抓取情况，以及由 AI 助手引荐的访问
未指定生成文件或本地数据存储。此技能从已连接的 SEOmatic 工作区读取存储的第一方数据。抓取量高且访问量高，说明 AI 可能在使用该页面并将用户引导至此；抓取量高但访问量少，说明页面可能易于阅读但不值得引用；抓取量接近零，则可能表示存在可索引性问题，或页面未能回答相关问题。

高级特性

区分真实用户观察到的引用与干净、未登录状态下的服务器端扫描，避免产生误导性比较。
按 AI 引擎报告引用率、答案量和最佳引用排名；当网站被引用时，最佳位置接近 1 表示排名靠前。
将爬虫抓取与 AI 引荐访问关联起来，揭示普通分析工具可能归类为 Direct 的流量。
审核规范业务事实和内部链接健康状况，帮助诊断不准确的 AI 答案。
使用限定于工作区范围的读取操作，无需输入域名、使用本地二进制文件或设置环境变量。
通过 SEOmatic MCP 服务器支持 OAuth 或 Bearer
smk_
API 密钥。
仅收集只读证据；除非用户批准，否则不会将网站更改上线；SEOmatic 的更改可以回滚。

name: seomatic-ai-citations description: 'Find out whether AI answers actually cite this site, using first-party evidence - real logged-in AI answers captured by the browser extension, which pages AI answer-crawlers fetch, and which pages AI sends visitors back to. Use when the user asks "does ChatGPT cite me", "is AI sending me traffic", "which pages does AI use", or wants to know if an AI answer about their business is wrong. Runs on SEOmatic, the SEO agent that works from the site''s real Google Search Console data; nothing goes live until the user approves it.' version: 1.0.0
license: MIT
homepage: https://app.seomatic.ai