安装指南

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

什么是

SEOmatic Client SEO Report 技能使用连接网站的真实性能数据，创建适合客户或利益相关者的月度 SEO 报告。它将 Google Search Console 结果与上一时期进行比较，区分品牌和非品牌性能，解释季节性，审查已完成的 SEO 工作，并确定更改是否产生了可衡量的结果。
该技能还在可用时结合了 Google Analytics 数据，报告跨跟踪搜索引擎的 AI 搜索可见性，并为下个月制定重点突出的三个优先级计划。每个数字都源自工具并绑定到明确的日期范围。它避免了不受支持的主张，解释了负面结果，并使提出的更改受用户批准的约束。

应用场景

为客户、经理、老板或高管利益相关者创建月度 SEO 报告。
使用点击次数、展示次数、CTR 和平均排名将当前月份与上一时期进行比较。
解释可能反映季节性而非 SEO 工作的流量下降或增长。
将非品牌搜索性能与品牌需求分开，以衡量 SEO 驱动的增长。
总结已验证、无效、退步、无结论且仍在成熟的 SEO 任务。
连接 GA4 时报告自然会话、流量来源和着陆页。
跟踪 ChatGPT、Claude、Google AI Overviews 和其他受监控 AI 引擎中的品牌可见性和观察到的引用。
将策略建议和拟议任务转化为下个月的三个明确优先级。

工作原理

当用户管理多个网站时，确认目标网站和工作区。
检查 Google Search Console 是否已连接。如果未连接，请将用户引导至 SEOmatic 连接页面并停止，而不是估算性能。
运行带有 compare_periods 的 gsc_performance，用于请求的月份和上一时期，在未提供日期时默认为 28 天周期。
收集点击次数、展示次数、平均 CTR 和平均排名，然后使用 gsc_insights 进行季节性和品牌与非品牌分析。
如果可用，使用 traffic_analytics 从连接的分析数据中检索会话、流量来源和自然着陆页。
按状态审查 task_manage 结果，包括已验证、无效、退步、无结论、进行中和验证中的工作。仅在任务证据支持该主张时归因结果。
查询 get_ai_visibility 以获取按搜索引擎划分的可见性，并将其与先前的扫描进行比较；使用 ai_citations 查看引用该网站的观察到的答案。
当不存在扫描时省略 AI search 部分，而不是用假设填充它。
使用来自 strategy_insights 的策略建议和来自 task_manage 的拟议任务，为下个月选择三个排名的优先级。
组装报告，包含准确的网站名称、日期范围、结果摘要、源指标、完成的工作、AI 搜索结果、下一步以及等待批准的更改数量。

配置指南

在 Openclaw 兼容环境中安装或启用该技能。
使用来自 SEOmatic AI 智能体设置的 OAuth 或 Bearer smk_ API 密钥添加 SEOmatic MCP 服务器。
在生成报告之前连接 Google Search Console。此技能使用的每次读取都是免费的。
可选连接 GA4 以包括会话、流量来源和着陆页分析。
管理多个网站时，确认活动的 SEOmatic 工作区和网站。

MCP endpoint

https://app.seomatic.ai/api/mcp
Configuration details:
MCP server: seomatic
Transport: streamable HTTP
Authentication: OAuth or Bearer smk_ API key
Google Search Console connection: https://app.seomatic.ai/connect/gsc
API key settings: https://app.seomatic.ai/dashboard/settings?tab=ai-agents
Required MCP dependency: seomatic
Required local environment variables: none
Required binaries: none
SEOmatic Client SEO Report 数据架构与分类体系
该技能围绕单个网站、明确的比较期、源指标、有证据支持的工作、AI 可见性和批准的后续行动来组织每个报告。
Section Source Data captured
Report identity User and workspace context Site, workspace, exact reporting dates, comparison dates
Search performance gsc_performance.compare_periods Clicks, impressions, average CTR, average position, period-over-period change
Search interpretation gsc_insights Seasonality assessment and brand/non-brand click split
Analytics traffic_analytics Sessions, traffic sources, and organic landing pages when GA4 is connected
Completed work task_manage.list Page, change made, status, evidence, measured result, and attribution
AI search get_ai_visibility and ai_citations.observed_citations Visibility by engine, change from the prior scan, and real cited answers
Next-month plan strategy_insights.strategy and proposed tasks Ranked opportunities, reasons, approval status, and recommended priorities
标准输出包括：
[Site] SEO report, [exact dates]
一句话结果摘要
点击次数、非品牌点击次数、展示次数和平均排名的结果表格
带有测量结果或直到测量成熟的日期的更改计数和列表
仅在存在扫描数据时出现的 AI 搜索部分
下个月的三个优先操作
等待批准的拟议更改数量和相关的批准链接。
任务状态分类法包括 verified、ineffective、regressed、inconclusive、in_progress、verifying 和 proposed。报告必须保留工具的数字和日期，而不能进行美化四舍五入或不受支持的归因。

高级特性

基于证据的报告，区分已验证的胜利与无效、退步、无结论和仍在成熟的工作。
具有季节性背景的期对期 Google Search Console 比较。
分离的非品牌搜索报告，以更好地隔离 SEO 驱动的性能。
可选的 GA4 丰富功能，包括会话、流量来源和着陆页分析。
跨多个引擎的 AI search 监控，包括跟踪时的 ChatGPT、Claude 和 Google AI Overviews。
基于引用该网站的真实 AI 答案的观察到的引用报告。
多网站工作区感知，在报告前进行明确的网站确认。
源自 SEOmatic 策略见解的排名的下个月建议。
具备批准意识的工作流，可浮现拟议更改而不暗示它们已上线。
专为两分钟客户或高管审查而设计的通俗易懂的格式。
通过 SEOmatic MCP 服务器集成的 Openclaw Skills，无需本地二进制文件或环境变量。

name: seomatic-client-report description: 'Write a monthly SEO report for a client or a boss from the connected site''s real data: Search Console clicks and positions against the prior period, what was changed and whether it worked, AI search visibility, and next month''s plan, in plain language with every number sourced. Use when the user asks for a client report, monthly SEO report, agency report, or an update for their boss or stakeholders. 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