international-seolisted
Install: claude install-skill visibian/seo-geo-skills
# International SEO
Make sure each language and country version is found, shown to the right readers, and not treated as a duplicate.
## What Google asks for
From "Tell Google about localized versions of your page" (Google Search Central, updated 21 September 2026):
- hreflang values are an ISO 639-1 language code, optionally an ISO 15924 script (zh-Hant) and an ISO 3166-1 Alpha 2 region (en-GB). Other codes are not supported; Google names es-419 as an example.
- Each version lists every version, itself included, and the links must be returned: if page X names Y, Y must name X, or the pair may be ignored.
- x-default marks the page for readers who match none of the languages, such as a language selector.
- The annotations can sit in the HTML head, in HTTP headers, or in the sitemap; "the three methods are equivalent from Google's perspective".
## Steps
1. Check what the site has, from this skill's folder:
- a few pages and their alternates: `python3 scripts/hreflang_check.py https://example.com/ https://example.com/de/`
- the whole site, after a `seo-audit` crawl: `python3 scripts/site_audit.py https://example.com --out seo-audit/` then `python3 scripts/hreflang_check.py --audit seo-audit/audit.json`
2. Fix in this order: invalid codes, missing self-references and return links, alternates that redirect, answer an error, ask not to be indexed or name another canonical, then x-default and `<html lang>`.
3. Check the structure: one address per language or country ver