用途:校验或生成多语言与多地区网站的 hreflang 标签,支持 HTML、HTTP 头、XML 站点地图三种实现方式;处理前会先检查 .seo-cache/ 中可复用的缓存数据,用户要求 refresh 或 re-run 时忽略缓存并覆盖写入。
主要校验项:1)自引用标签,且其 URL 须与页面 canonical 完全一致,缺失会导致整组 hreflang 被忽略;2)返回标签,A↔B 必须双向互指,构成完整网状引用;3)x-default,每组仅一个,指向回退页且需有返回标签;4)语言代码使用 ISO 639-1 两位码,常见错误如 eng、jp、无地区限定的 zh;5)地区代码使用 ISO 3166-1 Alpha-2,格式为 language-REGION,常见错误如 en-uk、es-LA;6)hreflang 仅应出现在 canonical URL 上;7)同一组 URL 协议须一致;8)跨域配置需双向返回标签并建议用站点地图实现。
实现方式:HTML link 标签置于 head,适合每页少于 50 个变体;HTTP 头适合 PDF 等非 HTML 文件;XML 站点地图适合大型站点与跨域场景,需声明 xmlns:xhtml,每个 url 条目包含全部语言变体(含自身),单文件上限 50000 条 URL。
其他能力:文化适配评估(基于 cultural-profiles.md,标记为 Medium)、内容对等审计(命令 /seo hreflang audit <directory-or-url>,含字数比例与时效性检查)、地区格式校验(数字、日期、货币、地址、电话,参考 locale-formats.md)。输出为校验报告、生成的标签或站点地图及修复建议。
限制:URL 不可达时报错而不猜测结构;无 hreflang 时报告缺失并推荐实现方式;无对应文化画像时使用默认清单;价格、收费、平台支持等信息暂未提供。