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

Описание и применение

CLI hreflang-audit выявляет ошибки 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.

Источник