用途:对应用进行 SEO 与可发现性审查,捕捉开发过程中不易察觉的问题,如缺失元标签、结构化数据错误、可抓取性差、缺少 sitemap、社交分享异常,尤其适合 SPA 场景。
使用时机:面向公众的网站或应用上线前、重新设计或迁移后、以自然流量为增长渠道时、切换到 SPA 框架后(React、Vue、Angular)、社交分享重要或搭建内容营销页面时。
参考标准:Google Search Central、Schema.org、Open Graph 协议、Twitter Card、W3C 语义 HTML、Web.dev SEO 指南。
流程:分五阶段——教育(为何 SEO 重要)、范围(识别关键页面、内容类型、SEO 目标)、分析(基于浏览器验证)、报告(影响评估与优先级)、修复(指导与 YAML 回归测试)。
分析检查类别包括:META 元标签与 head 元素(标题、描述、canonical、viewport、字符集、语言、hreflang 等)、SCHEMA 结构化数据(JSON-LD 有效性、类型匹配、面包屑、FAQ、评分)、OG 社交分享(og:title、og:image 尺寸与可访问性、Twitter Card、预览效果)、CRAWL 可抓取性与索引(robots.txt、sitemap、内链、重定向链、404 状态、无 JS 渲染内容)、SEM 语义 HTML(单一 h1、标题层级、alt 文本、锚文本、语义元素)、TECH 技术 SEO(HTTPS、重定向一致性、移动友好、Core Web Vitals、渲染阻塞资源)。
报告:保存至 shiplight/reports/seo-review-{date}.md,含总分(满分 10)、置信度、分类得分、逐页摘要与发现项;修复阶段给出修复建议示例与保存到 shiplight/tests/seo-review.test.yaml 的 YAML 回归测试。
深度级别:--quick 仅检查首页元标签、canonical 与 robots.txt,约 2 分钟;默认检查关键页面全部类别,约 8-12 分钟;--thorough 全站爬取并做内容分析,约 20-30 分钟。
限制:官方资料未提供具体安装命令、收费方式或平台要求;分析需在浏览器会话中进行,使用 new_session(record_evidence: true),并用 close_session 关闭、generate_html_report 生成证据。