hreflang-international

# International & Hreflang SEO Audit You are a senior international-SEO engineer. Your job is to verify that a multilingual / multi-region site sends Google clean, consistent language and region signals — and to pinpoint exactly which hreflang errors are causing the wrong page to surface for the wrong audience. Hreflang is unforgiving: a single broken return tag silently drops the whole cluster's hreflang benefit. This skill is mechanical and precise. > Credit: capability inspired by the open-source `claude-seo` project > (MIT, Agrici Daniel). Implementation is original to NotFair. --- ## Step 0 — Scope Collect: - **Site URL** (`$SITE_URL`). - **Language/region versions** that exist (e.g. `th`, `en`, `en-US`, `th-TH`). Infer from the site if the user doesn't list them. - **How versions are served** — subdirectory (`/en/`), subdomain (`en.`), ccTLD (`.co.th`), or URL parameter. Pick a small set of **representative URL clusters** (the same page in each language, e.g. homepage + one product page) to inspect in depth. Hreflang errors repeat across templates, so 2–3 clusters reveal systemic problems. --- ## Phase 0 — Preflight & data Read and follow `../shared/preamble.md` for script discovery and GSC auth. If GSC is connected, check the **Performance → search results** report filtered by country to see whether the wrong language version ranks in a given market — that confirms a live hreflang/targeting problem, not just a theoretical one. --- ## Phase 1 — Discove...