安装指南

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

什么是

SEOmatic SEO Audit 是一项 Openclaw Skills 集成，可通过 SEOmatic MCP 服务器，为已连接的网站执行完整、零成本的健康检查。它将 Google Search Console 的表现趋势、预计算的 SEO 诊断、索引检查、全站技术抓取以及 AI 搜索引用可见度整合为一份可执行报告。
此技能强调建议的可信度：它只报告已连接工具返回的数据，明确指出抓取覆盖范围是否不完整，并且绝不会要求用户提供域名，因为这些工具已限定在已连接的工作区内。可以通过 SEOmatic 准备修复方案以供审批，但只有用户明确批准后，任何更改才会生效。

应用场景

当用户询问网站表现如何或要求检查网站健康状况时，执行完整的 SEO 审计。
比较 Google Search Console 最近 28 天与前一时期的表现。
找出排名良好但点击率偏低的页面，并识别可快速见效的机会。
通过预计算的 Search Console 洞察，发现关键词蚕食、季节性模式、站点地图问题及其他情况。
检查网站中影响最大的页面的索引健康状况。
通过技术抓取发现重复或缺失的元数据、单薄内容、noindex 泄漏和失效链接。
查看已存储的 AI 搜索引用结果，并评估网站在 AI 生成答案中的可见度。
当已连接的套餐支持代理操作时，为可修复的问题创建待审批的 SEO 任务。

工作原理

使用 gsc_performance 建立基准，将最近 28 天的点击次数、展示次数、CTR 和平均排名与前一时期进行比较。
查看 gsc_insights 中预计算的诊断，例如关键词蚕食、CTR 异常值、季节性和站点地图健康状况；不要从原始数据重新生成这些诊断。
使用 gsc_indexing 批量检查在表现基准中识别出的最重要页面。
运行 site_audit，评估已连接网站的技术问题和页面问题，并在抓取不完整时明确说明。
使用 ai_citations 的 scan_results 操作读取已存储的 AI 可见度结果。只有当用户要求重新扫描时，才提供 run_ai_visibility_scan，因为它会消耗额度。
将发现综合为按优先级排序的清单，先列出快速见效项，尤其是平均排名达到 10 或更高但 CTR 异常的页面，其次列出结构性问题。
使用返回的 Search Console 指标量化建议，并针对每个问题说明具体修复方法。
使用 task_manage 的 create 操作为已批准的修复创建待处理任务。任务暂存要求付费套餐具有 agents:act 范围权限，不消耗额度，也不会自动执行更改。
如果某个数据源不可用，请提供工具返回的连接链接，不要猜测或补充缺失信息。

配置指南

使用 OAuth 或 Bearer smk_ API 密钥连接 SEOmatic MCP 服务器。免费套餐涵盖此技能所用的所有读取操作；暂存操作需要相应的付费套餐权限。

MCP 端点

https://app.seomatic.ai/api/mcp
配置详情：
MCP 服务器名称：seomatic
传输方式：可流式传输的 HTTP
身份验证：OAuth 或 Bearer smk_ API 密钥
API 密钥位置：https://app.seomatic.ai/dashboard/settings?tab=ai-agents
所需 MCP 服务器：seomatic
环境变量：无
本地二进制文件：无
完成身份验证后，请确保已连接的 SEOmatic 工作区可以访问目标 Google Search Console 和网站数据。无需提供域名参数，因为这些工具已限定在已连接的工作区内。

数据架构

此技能按数据来源、诊断层级和操作状态组织审计数据，而不是生成本地文件。
数据区域 工具 返回的信息
表现基准 gsc_performance 最近 28 天与前一时期的点击次数、展示次数、CTR、平均排名及趋势
搜索诊断 gsc_insights 关键词蚕食、CTR 异常值、季节性判断及站点地图健康状况
索引健康 gsc_indexing 优先页面的批量检查结果及索引状态
技术审计 site_audit 重复或缺失的元数据、单薄内容、noindex 泄漏、失效链接及抓取覆盖范围
AI 搜索可见度 ai_citations AI 搜索可见度分析中已存储的引用扫描结果
全新 AI 扫描 run_ai_visibility_scan 新生成的 AI 可见度结果；可能消耗额度
修复工作流 task_manage 暂存以供审核和批准的修复任务
问题分类按以下优先级排列：
快速见效项：平均排名达到 10 或更高的页面存在 CTR 表现不佳的情况。
结构性 SEO 问题：索引问题、技术抓取发现、内容质量问题和全站元数据缺陷。
AI 可见度发现：根据已存储的扫描结果，判断是否存在引用。
操作状态：已观察、已建议、已暂存待审批，或因已连接套餐缺少所需操作范围而不可用。
此技能不承诺固定的导出格式或本地文件目录。报告应保留返回的指标，区分完整抓取与部分抓取，并通过提供的连接链接标明缺失的数据源。

高级特性

使用真实的 Google Search Console 数据，而不只是依赖通用 SEO 启发式规则。
采用 28 天周期对比，区分当前表现与此前趋势。
利用预计算的 SEOmatic 诊断来识别关键词蚕食、CTR 异常、季节性和站点地图健康状况。
在一个工作流中整合搜索表现、索引覆盖率、技术抓取和 AI 搜索可见度。
免费复用已存储的 AI 引用扫描，并将其与会消耗额度的可选全新扫描区分开来。
以量化方式排列建议优先级，将排名高但 CTR 偏低的页面排在队列前面。
task_manage
支持基于审批的修复，不会直接发布或执行更改。
保留用户控制权：每项暂存的更改都必须经过批准，并且可以通过 SEOmatic 回滚。
如实报告缺失数据、部分抓取、权限不可用以及免费套餐的操作限制。
无需本地环境变量或二进制文件，便于在 Openclaw Skills 部署中轻量集成。

name: seomatic-seo-audit description: Run a complete, zero-cost SEO audit of the connected site through the SEOmatic connector - real Search Console data, technical crawl, on-page issues, and AI-search visibility - ending with a prioritized fix list the agent can stage for approval. Use when the user asks for an SEO audit, "how is my site doing", or a health check. version: 1.0.0
license: MIT
homepage: https://app.seomatic.ai