用途 seo-hreflang 用于多语言与多地区站点的 hreflang 实现校验与生成,帮助发现国际化 SEO 中的常见配置错误,并输出可直接实施的修正方案。
主要能力
- 校验检查:每个页面必须包含指向自身的 hreflang 标签,且与 canonical URL 完全一致;A 页指向 B 页时,B 页必须回指 A 页(双向返回标签,全网格互指);每组 alternates 需要唯一 x-default 兜底页;语言代码须为 ISO 639-1 两字母(如 en、fr、ja,避免 eng、jp,中文需用 zh-Hans 或 zh-Hant);地区代码为 ISO 3166-1 Alpha-2,格式为“小写语言-大写地区”(如 en-US、en-GB,避免 en-uk、es-LA);hreflang 只能出现在 canonical URL 上;同一组 URL 协议须一致;支持跨域名 hreflang,两侧均需返回标签并在 Search Console 验证。
- 实现方式:HTML link 标签适用于每页语言变体少于 50 个的小型站点;HTTP 头适用于 PDF 等非 HTML 文件;XML 站点地图适合大型站点与跨域名场景。生成站点地图时需声明 xmlns:xhtml 命名空间,每个 url 条目包含全部语言 alternates(含自身),每个 alternate 单独成条目,单文件上限 50,000 个 URL。
- 生成流程:识别站点语言信号(URL 路径、子域名、顶级域名、HTML lang 属性),映射各语言对应页面,校验代码,生成含自引用的标签,确认返回标签双向,补充 x-default,最后输出 HTML、HTTP 头或站点地图代码。
- 扩展审计:文化适配评估(按 DACH、法语区、西语区、日语区等预设档案检查 CTA、信任信号、外币品牌引用、数字日期货币格式);内容对等性审计(页面存在性、H2/H3 结构、title/meta/schema 本地化、字数比例、翻译时效、文化标记),可通过 /seo hreflang audit <目录或 URL> 触发;本地化格式校验(数字、日期、货币、地址、电话)。
- 共享数据缓存:执行前可读取 .seo-cache/ 中的站点元数据、审计评分和页面分析,用户要求 refresh 或 re-run 时忽略缓存并覆盖写入。
使用方式 以 URL 或本地目录为输入,工具先检查缓存,再抓取证据执行校验,输出验证报告(汇总、各语言 URL 的检查结果表)、生成的 hreflang 标签代码以及修复建议。报告按严重程度分级:缺少自引用和返回标签为 Critical,缺 x-default、无效代码、非 canonical 上的 hreflang 为 High,协议不匹配与尾斜杠不一致为 Medium,HTML 与站点地图重复实现、需要地区限定却缺失为 Low。
适用场景 多语言电商与国际站点的上线前 hreflang 检查、多语言目录日常维护、跨域名/多地区站点排查、翻译内容对等性与本地化格式审核。
限制 无法访问目标 URL 时会明确报错,不推测站点结构;未发现 hreflang 时只报告缺失并建议实现方式;缺少某语言文化档案时使用通用检查清单;本地目录为空时提示确认路径。工具不提供收费或价格信息,以上功能均以资料描述为准。