用途:校验已有的 hreflang 实现,或为多语言、多地区站点生成正确的 hreflang 标签,支持 HTML、HTTP 头、XML 站点地图三种实现方式。
主要能力:校验自引用标签、返回标签(双向关系)、x-default、语言代码(ISO 639-1,如 en、ja;脚本子标签如 zh-Hans、zh-Hant)、地区代码(ISO 3166-1 Alpha-2,如 en-US、en-GB)、canonical 对齐、协议一致性及跨域支持;输出校验报告与可实施的标签代码。另含文化适配评估、内容对等审计(命令 /seo hreflang audit <directory-or-url>)与本地化格式校验,按需加载 references/cultural-profiles.md、references/locale-formats.md、references/content-parity.md。
用法:HTML 方式在 head 中放置 link rel="alternate" hreflang 标签,每页须包含全部语言版本(含自身);HTTP 头方式适用于 PDF 等非 HTML 文件;大型站点或跨域推荐 XML 站点地图,需声明 xmlns:xhtml 命名空间,每个 url 条目包含全部语言替代项,单文件上限 50,000 个 URL 或 50MB。
限制:hreflang 只是提示而非指令;Google 已移除 Search Console 国际定位报告与手动国家定位设置,不应再建议在 GSC 设置国家定位。URL 不可达时报告错误而不猜测站点结构;未发现 hreflang 时报告缺失并建议实现方式;无效代码需列出正确替换。文化适配评估在无对应预置档案时使用默认清单,并说明基于通用指南。