前端 SEO 规范检查

要解决什么问题

前端页面在上线或改版后，常见问题不是「完全没做 SEO」，而是 title/description 重复、h1 结构混乱、图片缺 alt、外链未加 rel="nofollow"，以及营销页里堆 iframe、display:none 或大段   等。这类问题散落在大量路由和模板里，靠肉眼翻代码既慢又容易漏。

本技能面向 站内 SEO 合规：用脚本做可重复的机械检查，再按清单做标题语义、页面类型和渲染方式的人工判断，最后输出带严重级别与修复建议的报告。

技能如何工作

1. 确认检查对象：有构建产物或 SSR 输出时优先看生成后的 HTML；只有仓库源码时退回源码层检查。
2. 运行内置扫描脚本：默认在被检项目根目录生成 frontend-seo-report.md，也可指定输出路径。
3. 人工复核：对照 references/checklist.md，审查标题是否堆砌、重要页面元信息是否真正唯一、是否符合首页/列表/聚合/内容页命名习惯，以及核心内容是否依赖 JS 渲染导致源码缺失。
4. 扁平化报告：按 High（阻断或缺必需元信息）、Medium（削弱 SEO 的结构/标记）、Manual（需人工判断的语义项）归类，并给出检查范围、问题明细与上线前修复优先级。

脚本覆盖项包括：title / meta description / meta keywords、h1 数量、img 的 alt/title、a/video 的 title、外链 nofollow、iframe 与隐藏内容、超大源码、语义化标签不足，以及页面类文件中重复的静态 title/description。

适用边界

• 适合：上线前 SEO 审查、官网/营销/专题/内容页改版后的合规复查。
• 不适合：站外 SEO、关键词策略研究或纯数据分析。
• 注意：扫描结果是启发式的；框架 metadata API、动态标题、CMS 注入内容仍需人工确认。