mcpField
S
seo-technical

seo-technical

github.com/rampstackco营销与增长1.0k298 次安装2 周前更新
代码仓库

关于 seo-technical

面向站点负责人和 SEO 团队的通用技术 SEO 审查指南,覆盖抓取、索引、渲染、架构、结构化数据和页面体验,并按优先级整理问题报告。

主要功能

  1. 01六层技术 SEO 框架
  2. 02抓取与索引检查
  3. 03渲染和站点架构审查
  4. 04结构化数据与安全检查
  5. 05问题优先级排序
  6. 06迁移清单与重定向映射

适用场景

  1. 01在迁移前后审查站点
  2. 02调查索引或排名下滑
  3. 03为新站建立 SEO 基础
  4. 04检查多语言站点配置

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/rampstackco/claude-skills --skill seo-technical

安装后在 Claude Code 中输入/seo-technical确认已加载。

包含的文件

除 SKILL.md 外,安装时一起下载的参考资料和脚本。

README.md
references/
audit-template.md
migration-checklist.md

详细介绍

技术 SEO

审核并修复内容之下的技术层:搜索引擎如何抓取、渲染、编入索引并信任网站。与技术栈无关。


适用场景

  • 网站迁移前后进行全站审核
  • 调查索引或排名下降
  • 为新网站搭建 SEO 基础
  • 审核 Core Web Vitals 或页面体验信号
  • 修复抓取浪费、重定向链或规范网址问题
  • 搭建多语言或多区域网站

不适用场景

  • 单页站内优化(使用 seo-onpage)
  • 关键词策略或内容规划(使用 seo-keyword)
  • 竞争对手反向链接或 SERP 分析(使用 seo-competitor)
  • 不涉及 SEO 的纯性能优化(使用 performance-optimization)

所需输入

  • 网站 URL 或预发布 URL
  • 至少具备查看渲染后 HTML、robots.txt 和站点地图的权限
  • 最好还能提供:Search Console 访问权限、服务器日志和爬虫

如果网站规模较大(10K+ 个 URL),请确认审核采用全量抓取还是抽样抓取。


框架:6 个层级

技术 SEO 分为六个层级,依次叠加。较低层级出现故障,会影响其上的所有层级。

1. 可抓取性

搜索引擎能否访问这些 URL?

  • robots.txt 不会屏蔽重要路径
  • 可编入索引的页面没有意外设置 noindex
  • 没有意外的 disallow 规则屏蔽 CSS 或 JS(会导致渲染失败)
  • 站点地图存在、返回 200,且只列出规范 URL
  • robots.txt 中引用了站点地图
  • 不存在无限空间(分面导航生成无穷无尽的 URL)
  • 抓取预算没有浪费在低价值 URL 上
2. 可索引性

在可抓取的 URL 中,哪些应该编入索引?

  • 每篇内容只有一个规范 URL(没有重复内容)
  • 规范页面上的规范标签指向自身
  • 在预发布环境、搜索结果、筛选页面、感谢页面和内部管理页面上设置 noindex
  • 不存在相互矛盾的信号(规范标签指向一个方向,站点地图指向另一个方向,内部链接又指向第三个方向)
  • 正确处理分页(rel=next/prev 已弃用,但规范标签仍需保持一致)
  • 有意处理参数(UTM、会话 ID、排序顺序)
3. 渲染

渲染后的 HTML 是否与爬虫看到的内容一致?

  • 无需 JavaScript 即可查看关键内容(或通过服务器端正确渲染)
  • 对于 SPA:确认 Googlebot 能看到渲染后的内容(使用 URL 检查工具进行测试)
  • 没有伪装(向爬虫和用户展示不同的内容)
  • 延迟加载的内容具有正确的加载属性
  • 水合错误不会从渲染后的 DOM 中移除内容
4. 网站架构

网站结构是否便于用户和爬虫浏览?

  • URL 层级清晰,并与网站结构相对应
  • 从首页出发,重要页面最多 3 次点击即可到达
  • 内部链接合理地传递权威性
  • 提供面包屑导航,并使用 schema 标记
  • 没有孤立页面(没有内部链接指向的页面)
  • 没有重定向链(最多一次重定向)
  • 内部链接指向的 URL 没有 4xx 错误
5. 结构化数据和信号

网站是否使用爬虫能够理解的语言?

  • 在适当的页面类型上使用 Schema.org 标记
  • 使用 JSON-LD 格式(优于微数据)
  • 通过富媒体搜索结果测试进行验证
  • 在首页或关于页面上使用 Organization 或 LocalBusiness schema
  • 在嵌套页面上使用 BreadcrumbList schema
  • 在内容页面上正确关联作者和发布者 schema
  • 根目录下存在 llms.txt(供 AI 爬虫使用,参见 seo-aeo-geo)
6. 页面体验和安全性

网站是否达到页面体验基准?

  • 所有页面均使用 HTTPS,且没有混合内容
  • 已设置 HSTS 响应头
  • Core Web Vitals 达标(LCP、INP、CLS 均在阈值范围内)
  • 适配移动设备(响应式布局、无水平滚动、点击目标大小合适)
  • 移动设备上没有侵入式插页
  • URL 结构稳定(不同部署之间不会随机更改 URL)
  • 404 页面返回 404,而不是返回 200 并显示“找不到页面”(软 404)

工作流

  1. 定义范围。 整个网站、某个子文件夹、迁移检查,还是某个具体问题。
  2. 确认访问权限。 实际能看到哪些内容(HTML、robots、站点地图、搜索控制台、服务器日志、预发布环境)?
  3. 抓取。 使用爬虫列出 URL 和状态码。如果网站规模很大,则抽样检查。
  4. 运行 6 层框架。 对每层评分,并记录具体问题及示例 URL。
  5. 交叉核对。 在搜索控制台中查看实际已编入索引的内容,并与站点地图和抓取结果进行比较。
  6. 确定优先级。 严重(阻碍编入索引或导致流量损失)、重要(有待优化)、锦上添花(润色)。
  7. 撰写报告。 使用 references/audit-template.md 中的模板。

常见问题模式

  • 在设为 noindex 的页面上优化排名。 进行内容优化前,务必先检查是否可编入索引。
  • 未修复规范网址问题就添加站点地图。 包含重复 URL 的站点地图还不如没有。
  • 阻止爬虫访问 CSS 或 JS。 这会破坏 Google 的渲染。过度限制的 robots.txt 文件中常见此问题。
  • 过度依赖规范标签。 规范标签只是提示,并非指令。如果内容确实已迁移,请使用重定向。
  • 迁移时未准备重定向映射。 这是迁移后流量损失的首要原因。
  • 将 Core Web Vitals 视为唯一排名信号。 页面体验很重要,但不能凌驾于相关性之上。

输出格式

默认输出为 Markdown 格式的审计报告,保存至 seo-technical-audit.md。结构如下:

  1. 范围和方法
  2. 执行摘要(3 至 5 个严重问题)
  3. 6 层评分
  4. 严重问题(附示例 URL)
  5. 重要问题
  6. 锦上添花的优化项
  7. 实施路线图(按顺序排列)

对于迁移,请在报告之外另附 CSV 格式的重定向映射。


如果所需数据不可用

此技能的输出依赖于其无法自行生成的数据、测量结果或工具结果。如果所需输入、工具或数据源不可用或无法验证,合规的输出方式是提交交付内容并说明缺口:需要哪些内容、实际获取或验证了哪些内容,以及缺口会影响输出的哪些部分。绝不可通过捏造、估算或插值来补齐所需数值。说明缺口本身就是完整答复。


参考文件

评论

支持 Markdown