hreflang-audit

Detect incorrect or missing hreflang annotations in SF crawl exports.

25|4|Updated Apr 30, 2026
One-click install
npx skills add https://github.com/popiliadam/platinum-seo-engine --skill hreflang-audit
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: hreflang-audit
Source: https://github.com/popiliadam/platinum-seo-engine/tree/main/skills/discovery/hreflang-audit
Command: npx skills add https://github.com/popiliadam/platinum-seo-engine --skill hreflang-audit

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

The hreflang audit Skill detects incorrect or missing hreflang annotations on multi-lingual websites, preventing broken redirects and maintaining international SEO performance.

Core Features & Use Cases

  • Hreflang Analysis: Inspects hreflang elements to verify their presence and reciprocity across international URLs.
  • Code & x-default Validation: Validates hreflang codes for correctness and checks for the correct use of x-default.
  • Consistency Checks: Ensures the configuration matches the locale of the site it refers to, for proper locale consistency.
  • Use Case: For SEO professionals managing multi-lingual sites, this Skill automatically checks hreflang settings post-crawl, ensuring site performance is not hampered by inconsistent or broken hreflang implementations.

Quick Start

Execute the hreflang audit Skill with the project slug and optional export date.

Frequently Asked Questions about hreflang-audit

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I check hreflang annotations for missing or incorrect codes on a multilingual site?

You can check hreflang annotations by running an audit on SF crawl exports to detect missing hreflang elements, identify discrepancies in hreflang code usage, and validate x-default settings across international URLs.

What is hreflang reciprocity and why is it needed for international SEO?

Hreflang reciprocity requires every international URL to return alternate links to its referring pages, preventing broken redirects and maintaining international SEO performance across multilingual sites.

How do I validate x-default settings across international URLs?

You can validate x-default settings by inspecting hreflang elements in SF crawl exports, which checks for the correct use of x-default and ensures the configuration matches the locale of the site it refers to.

Can I audit hreflang annotations using Sitebulb crawl exports?

Yes, you can audit hreflang annotations by loading SF crawl exports using sf_list_crawls, sf_load_crawl, and sf_export_seo_element_urls tools, then running the audit with the project slug and optional export date.

Why does my hreflang configuration not match the locale of my international site?

Hreflang configuration mismatches occur when the hreflang codes do not match the locale of the site they refer to; consistency checks inspect hreflang elements to verify their presence and validate locale consistency.

Do I need SF crawl exports to validate hreflang code correctness?

Yes, SF crawl exports are required as they provide the crawl data loaded via sf_list_crawls, sf_load_crawl, and sf_export_seo_element_urls tools to detect incorrect hreflang codes and validate x-default settings.