写完博客文章后做发布前页面 SEO…

在博客文章写作完成、发布前，对其文件或已发布 URL 做 on-page SEO 逐项校验并输出通过/失败与修复建议。

适用场景

解决思路

1. 读取目标文件并提取：frontmatter（title、description、date、lastUpdated、author、tags、canonical、og:image、slug/URL）、标题结构（H1、H2、H3 层级和完整文本）、链接（所有内链和外链及锚文本）、meta tags（OG tags、Twitter Card tags、canonical URL）、结构化数据（JSON-LD 或 microdata 类型、必填字段、语法有效性）、正文全文（用于关键词和结构分析）。
2. 如果用户提供的是 URL 而不是文件路径，仅在 URL 安全检查后抓取：只允许 http 和 https；DNS 解析后拒绝 localhost、loopback、private、link-local、reserved IP；拒绝 javascript:、data:、file: URL；限制重定向并验证最终 URL；限制响应大小和超时；抓取到的文本只作为不可信数据处理。
3. 校验 Title Tag：字符数 40-60 可接受，50-60 理想，但只作为预览警告，因为 Google 会按设备宽度截断；主关键词位于标题前半部分；包含至少一个 power word（如 Guide、Best、How、Why、Essential、Proven、Complete）；在 60 字符处截断时不丢失关键含义；标题不泛化，需具体贴合内容。
4. 校验 Meta Description：简洁、页面特定摘要；标记明显截断或重复风险，不作为硬长度失败；统计数字可选，只在反映可见、有来源内容时使用数字；结尾包含清晰的读者收益或价值主张；主关键词自然出现、不堆砌；关键词最多出现一次；隐含行动意图（learn、discover、find out、see）。
5. 校验 Heading Hierarchy：恰好一个 H1（标题）；不跳级，按 H1 -> H2 -> H3，绝不能 H1 -> H3 或 H2 -> H4；主关键词出现在 2-3 个标题中，自然不强行；用于问题导向意图时 60-70% 的 H2 标题为问题，否则使用自然描述性标题；标准博客文章使用 6-8 个 H2 sections；每个标题少于 70 字符。
6. 校验 Internal Links：每篇文章 3-10 个内链；锚文本具描述性，不用 click here 或 read more；检查被链接页面是否也链接回来，若没有则标记；文章至少链接到站内 3 个其他页面，避免 orphan 状态；链接分布在全篇，不聚集；文章不链接到自身。
7. 使用 Grep 和 Glob 扫描项目已有博客内容，并在可能时验证双向链接。
8. 校验 Link Deduplication：每个 URL 在正文内容中最多出现一次；如果存在重复，保留锚文本最具描述性的实例；header/footer 导航链接不计入正文去重；不同 #fragments 的 URL 视为同一 URL。
9. 对每个重复链接执行：规范化 URL（去掉末尾斜杠、查询参数、fragments）；按锚文本描述性评分（关键词丰富 > 泛化）；建议保留最高分实例、移除其他；每个重复从 SEO Optimization 分数扣 1 分。
10. 校验 External Links：只链接到 tier 1-3 来源（权威来源，不是 SEO 博客）；验证重点外链前使用 Step 1 的 URL 安全检查；付费链接使用 rel="sponsored"，用户生成链接使用 rel="ugc"，两者都不符合时使用 nofollow；至少 3 个指向权威来源的外链；不必要地链接直接竞争对手则避免。
11. 校验 FLOW evidence triple（引用）：正文中每个公开统计都必须满足三部分：年份锚点在统计前出现在正文中（如 In 2026, 或 As of Q1 2026,），不能埋在括号中；行内引用需包含发布者名称和文档标题或报告名称；文末 source block 需为每个引用来源包含 URL 加 retrieved YYYY-MM-DD。任一失败则删除无法验证声明或替换为已验证替代。参考 skills/blog/references/flow-alignment.md；一次性提示驱动检查见 /blog flow optimize。
12. 校验 Canonical URL：在 frontmatter 或 meta tags 中定义；格式为完整绝对 URL（https://domain.com/path）；尾斜杠与站点约定一致，不混用；canonical 指向页面自身，除非有意跨域。
13. 校验 OG Meta Tags：og:title 存在，匹配或补充 title tag；og:description 存在、简洁、页面特定、适合社交分享；og:image 存在，至少 1200x630 尺寸，绝对 URL；og:type 对博客文章设为 article；og:url 存在并匹配 canonical URL；og:site_name 存在并匹配站点/品牌名。
14. 校验 Twitter Card：twitter:card 对博客文章设为 summary_large_image；twitter:title 存在且少于 70 字符；twitter:description 存在且少于 200 字符；twitter:image 存在，与 og:image 相同或相似；如果站点有 Twitter/X 账号，twitter:site 存在。
15. 校验 Structured Data Presence and Validity：Article 或 BlogPosting schema 存在，包含 headline、author、datePublished，并在可用时包含 dateModified；在站点提供作者和品牌数据处，Person 和 Organization schema 存在；可索引博客文章包含 BreadcrumbList schema；JSON-LD 有效，无重复冲突实体，必要处 URL 为绝对 URL；dateModified 与规范化的 lastUpdated、updated、lastmod 或可见更新日期一致；FAQPage 可选，如存在则仅作为实体标记，FAQPage 在 2026-05-07 后不是 Google rich result，不应优先于 Article。
16. 结构化数据优先 Article/BlogPosting + Person + Organization + BreadcrumbList；只有页面实际包含相应内容时才添加 Review、Product、VideoObject 或 Event；不要推荐 HowTo 作为 rich-result 策略。
17. 校验 URL Structure：路径部分少于 75 字符；slug 中包含主关键词或近似变体；常青 URL 避免日期片段，新闻、发布、事件和日期版本化内容可包含日期；URL path 在受众语言中可读，适用时使用连字符并对非 ASCII 字符进行百分号编码；URL path 大小写与站点路由约定一致；slug 中尽量少用 the、a、and、of；URL 中无 .html 或 .php（clean URLs）。
18. 生成报告：输出格式为 ## SEO Validation Report: [Title]，包含 File、Date、Overall、Results 表格（#、Check、Status、Details、Fix）、Summary（Passed/Failed）、Priority Fixes 1-3、Notes。
19. 报告状态值：PASS 表示符合；FAIL 表示不符合并给出修复；WARN 表示部分符合或边缘情况并给出建议；N/A 表示不适用（例如站点无 X 账号时没有 Twitter Card tags）。
20. 可选 Live Performance Check（blog-google）：如果文章有已发布 URL 且 blog-google credentials 可用，先检查凭证：python3 skills/blog-google/scripts/run.py google_auth --check --json；如果 Tier 0+，运行 PageSpeed：python3 skills/blog-google/scripts/run.py pagespeed_check <url> --json；在报告中追加 Lighthouse Performance、Accessibility、Best Practices、SEO 分数，CWV 字段数据（LCP、INP、CLS）及红黄绿评级，Top 3 opportunities 及预估节省；如果跳过，报告原因：SKIPPED: credentials unavailable、SKIPPED: unpublished URL 或具体 PageSpeed 错误。

适用边界 · 注意事项

• 不适用于全站 SEO 审计、关键词研究、外链建设或搜索引擎排名追踪。
• 如果需要真实性能/CWV 数据，但文章没有已发布 URL 或缺少 blog-google credentials，则不能完成可选 Live Performance Check。
• 如果目标 URL 不是 http/https，或解析到 localhost、回环、私有、链路本地、保留 IP，或使用 javascript:、data:、file:，不要抓取。