hreflang validator

hreflang_validator

Builds the hreflang graph and checks return links, language codes, status, canonical and noindex on targets.

What it does

Builds the hreflang graph of a language cluster starting from one URL (HTML link tags, HTTP Link headers and optionally XML sitemaps), fetches every alternate URL and checks return links, self-references, ISO language/region codes, x-default, status 200, self-canonical and noindex on targets. Use when asked whether hreflang is implemented correctly or why the wrong language version ranks. Returns findings, the URL × language matrix and all edges with their source. Takes 3 to 20 seconds.

~8 s · up to 150 requests · v1.0.0

Call it from code

REST endpoint (POST)

https://tech-seo.de/api/v1/checks/hreflang_validator

MCP tool name

hreflang_validator

cURL

curl -X POST https://tech-seo.de/api/v1/checks/hreflang_validator \
  -H 'content-type: application/json' \
  -d '{"url":"https://example.com/"}'

Parameters and result format →