hreflang Is Probably Broken on Your Site — Here's a Zero-Dependency CLI to Prove It

说明与用途

hreflang-audit CLI 可检测多语言网站的 hreflang 错误，帮助快速修复不匹配、死链和无效地区码问题。

问题

Many multi-language sites have broken hreflang annotations, causing search engines to serve incorrect country versions and split rankings without obvious alerts.

结果

The CLI provides a concise report of hreflang clusters with failures, allowing teams to address return-tag mismatches, dead URLs, and invalid locale codes efficiently.

工作流

• Install Node 20+. Run hreflang-audit <domain-or-sitemap>. Review the generated report for clusters and failure types. Fix the identified hreflang issues. Re-run the audit to confirm resolution. Integrate the CLI into CI to fail builds on new hreflang errors.

证据

After hitting the same three failure modes in audit after audit, I built hreflang-audit, an open-source, zero-dependency Node CLI.

来源

Return-tag mismatches. Page A declares B as its French alternate, but B never points back to A. Google treats the whole cluster as invalid.

来源