international-seo-hreflang-audit
Installation
SKILL.md
International SEO & Hreflang Visibility Audit
Audit multilingual and multi-regional website configurations to ensure search engines and AI answer engines correctly index, disambiguate, and cite regional content (pricing, currency, inventory, and language variations).
Workflow
-
Discover Language & Regional Architecture:
- Inspect sampled URLs across language/regional prefixes (
/en/,/es/,/de/,/fr-ca/), subdomains (uk.example.com), or ccTLDs. - Extract
<link rel="alternate" hreflang="..." href="...">tags in HTML<head>andLink:HTTP response headers[GOOGLE-HREFLANG-01]. - Inspect XML sitemaps for
xhtml:linklocalized alternate declarations[GOOGLE-HREFLANG-01].
- Inspect sampled URLs across language/regional prefixes (
-
Verify Language & Region Code Validity:
- Validate language subtags against ISO 639-1 (e.g.,
en,es,de,fr,zh)[W3C-ISO-LANG-01]. - Validate optional regional subtags against ISO 3166-1 Alpha-2 (e.g.,
en-US,en-GB,es-MX,pt-BR)[W3C-ISO-LANG-01]. - Flag invalid combinations (e.g., using country codes as language codes, or using script codes incorrectly).
- Validate language subtags against ISO 639-1 (e.g.,
-
Audit Bidirectional Return Links (Reciprocity):
- For every sampled page A with
hreflangpointing to alternate page B, fetch page B and verify it contains a reciprocalhreflanglink pointing back to page A[GOOGLE-HREFLANG-01]. - Flag broken or missing return links that cause search engines to ignore regional clustering.
- For every sampled page A with