关于 seo
seo 是一项通过审计、实施、需求研究、撰写简报和效果衡量来提升搜索可见性的技能,涵盖常规搜索和 AI 搜索。它依据限定范围的证据提出建议,并区分实测数据与数据缺口。
主要功能
- 01审计索引和网站可发现性
- 02实施范围明确的 SEO 修正
- 03研究搜索需求和页面机会
- 04制作可持续使用的写作简报
- 05衡量搜索和 AI 可见性
适用场景
- 01诊断网站的索引问题
- 02按路由模式排定技术修复优先级
- 03选择页面目标前研究需求
- 04明确数据缺口并追踪搜索或 AI 可见性
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ mblode/ agent-skills --skill seo安装后在 Claude Code 中输入/seo确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
evals/evals.jsonreferences/answer-engines.mdaudit.mdbrief-template.mdmetadata-copy.mdmonitoring.mdnextjs-implementation.mdresearch-protocol.mdsources.mdvalidation-evidence.md详细介绍
SEO
- **是:**为搜索可见性提供统一入口,涵盖以证据为依据的审计、实施、需求研究、作者简报,以及搜索引擎和 AI 搜索的效果衡量(AEO 指搜索内 AI 答案的优化,GEO 指独立助手的优化;参见
references/answer-engines.md)。 - **不是:**撰写文章或独立营销文案(
ghostwriter)、视觉重新设计(ui-design)、租户基础设施(multi-tenant-architecture),或实现 AFDocs / Is Agentic / Is It Agent Ready 评分卡(agent-ready)。如果 SEO 文案和标记属于所请求实施的一部分,则修复它们。
为任务选择路径
| 请求 | 加载 | 交付内容 |
|---|---|---|
| 审计网站、诊断索引问题、审查迁移 | references/audit.md 和 references/validation-evidence.md | 按优先级排列的发现,包含 URL、观察到的证据、影响和修正措施 |
| 修复或实施 SEO | 审计参考资料,然后加载下方适用的实施参考资料 | 代码变更、限定范围的检查,以及变更行为在实际提供的页面中的证据 |
| 研究需求、选择目标、撰写页面简报 | references/research-protocol.md;撰写简报时加载 references/brief-template.md | 有来源依据的需求表和决策,或可长期使用的作者简报 |
| 解释流量变化、衡量 AI 可见性、监控 SEO | references/monitoring.md | 限定资源范围的诊断,或已配置的监控,并明确列出数据缺口 |
对于组合请求,在不同模式中重复使用同一份资源和 URL 清单。审计请求应产出发现;修复这些问题的请求则应在用户授权范围内继续实施和验证。仅研究的请求不要求抓取每个 URL 或更改代码。
明确证据边界
确定确切的公开主机、URL 前缀或网域资源、生产环境、项目/子路径、受众和业务目标。在共享网域上,分别按各项目的路径筛选。在分析数据中,先核实主机名、路径、转化事件和归因窗口,再解读数值。
先发现已连接的工具和现有项目绑定。优先使用已建立的报告来源,其次使用可用的同类工具,再其次使用已登录的浏览器。不要求使用任何特定供应商。所有权验证、API 授权和成功执行限定范围的查询是彼此独立的状态。相邻资源的导出数据不能作为替代。
对于无法访问、缺失、不受支持或未衡量的指标,使用 No data 并说明原因;将这些情况与衡量结果为零区分开。历史导出数据应标明其实际日期。认证指标不可用时,仍应开展有用的公开检查。
工作流程
对于较大规模的混合工作,仅跟踪适用的步骤:
- 确认属性、范围、基线和预期结果。
- 检查实时证据,并梳理受影响的路由模式或研究问题。
- 优先处理阻塞性缺陷和高价值机会;区分观察结果与假设。
- 实施获准的修正,或交付所请求的研究/简报。
- 重新检查变更后的行为,说明测试环境,并报告尚存的差距。
先处理影响抓取和索引的缺陷,再调整装饰性元数据。页面标题、标题层级和内容结构应符合页面目的和读者意图。描述性的非品牌词有助于用户发现类别;以品牌为主的作品集和产品页面也可能是合适的。固定的标题字符数和疑问句式的标题都不是排名要求。改写标题或描述属于定位调整,而非技术修复:请遵循 references/metadata-copy.md,并将文案与技术修复提交分开。
在 AI 可见性方面,所有者负责构建抓取通道、内容和可提取的结构;独立评测、比较和报道需要争取获得,且它们提供了回答中关于品牌的大部分信息。先修复自有内容层,再说明剩余的提升空间在哪里,而不是为了凑内容而填充网站。原创证据、实用比较和坦诚的产品局限性,比刻意制造的关键词变体更有价值。研究读者可能提出的问题;不要把编造的查询扩展说成搜索引擎遥测数据,也不要为每种变体都创建一个页面。
参考资料
| 文件 | 适用场景 |
|---|---|
| references/audit.md | 抓取、诊断或确定网站审计的优先级;规范链接、重定向、排除规则和程序化页面;hreflang;影响发现的 CDN、响应标头或预览环境 |
| references/nextjs-implementation.md | 实现 App Router 元数据、站点地图、渲染、状态码、Markdown 副本或架构标记;请对照已安装的 Next.js 文档核实 API |
| references/answer-engines.md | SEO、AEO 和 GEO 术语、AI 可见性、爬虫策略、自有内容与外部报道、Markdown 替代内容或 llms.txt |
| references/metadata-copy.md | 撰写或更改页面标题、元描述或社交标题;判断元数据编辑是机械性修改,还是需要所有者批准 |
| references/validation-evidence.md | 验证发现、构建后的页面或已部署的修正 |
| references/research-protocol.md | 关键词/提示词指标、机会选择和问题地图 |
| references/brief-template.md | 编写作者简报 |
| references/monitoring.md | 搜索/AI 表现、归因、异常或周期性工作 |
| references/sources.md | 某项论断依赖于搜索引擎的当前行为、受支持的报告或供应商研究 |
交付
除非用户要求提供文件,否则在聊天中提交发现结果。作者简报应放到指定的项目位置;制作新版本时,保留之前带日期的简报。不要将临时抓取数据和导出文件放入代码仓库。撰写报告或简报时不得使用破折号。
报告变更内容、变更原因、确切的验证证据,以及仍未测量的事项。本地构建成功、部署就绪、公共 URL 探测结果、Google 索引记录和测得的转化率是不同的证据。明确指出实际验证到的最强状态。
向他人发送总结、安排周期性工作、购买工具以及部署到生产环境,均须遵循用户授权和主机规则。应复用现有的匹配监控,不要另设负责人或时间表。
注意事项
- 网站地图可以成功解析,但其中列出的
/studio会故意返回 404。请检查其中的 URL,而不只是 XML 是否有效。 - 如果画布受挂载状态限制,首页和分类中心页面的初始 HTML 中可能只包含导航。请同时检查这些中心页面和深层页面;仅使用
use client并不意味着缺少服务端渲染的内容。 lastModified: new Date()或构建时间戳描述的是生成时间,不一定代表页面有过重要更新。请使用内容日期,或省略该字段。- 每个 URL 都有 canonical 标签,并不能解决两个副本都将自身标记为首选 URL 的问题。请比较内容并选择首选 URL。
- 两个一致的 JSON-LD 脚本并非错误。请核实实体身份、符合条件的属性和可见的佐证内容,而不是统计脚本数量。
- DNS 验证不需要虚构的 meta token。请另外确认是否有受限范围的数据访问权限。
- 探测爬虫 user-agent 并不能验证机器人 IP,也不能证明页面已被收录。请将 CDN 日志与搜索引擎检查作为不同证据分别处理。
- 提示词需求、实测引用、提及、AI 展示次数和引荐会话是不同的指标。请保留搜索引擎、来源、匹配类型、范围和时间窗口等信息。
- 单次提示词运行,或跨搜索引擎求出的单个平均分,都不能衡量可见度。请重复运行每个提示词,按搜索引擎分别报告,并将召回率与引用分开统计。
- Schema、
llms.txt和固定长度的答案区块并非经过衡量的引用影响因素。请将它们用于真正需要它们的场景,不要将其包装成提升 AI 可见度的手段。 - 一份审计 PR 同时改写了优先页面和营销活动页面的标题,因此被退回并撤销了这些改写,因为措辞属于内容所有者的定位决策。请提交机械性的元数据修复,并将其余建议列出交由所有者处理。
- 供应商提供的 Search Console 连接器可能会少报数据。诊断流量下降前,请将资源、筛选条件和聚合方式与原生 Search Console 核对。
仅用于维护:evals/evals.json 保存行为场景和路由提示词。更改技能时会加载它,常规 SEO 工作期间不会加载。