seo-hreflang

Validate and generate hreflang tags for HTML, HTTP headers, and XML sitemaps.

13.8k|2.0k|Updated Feb 7, 2026
One-click install
npx skills add https://github.com/AgriciDaniel/claude-seo --skill seo-hreflang-agricidaniel
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: seo-hreflang
Source: https://github.com/AgriciDaniel/claude-seo/tree/main/skills/seo-hreflang
Command: npx skills add https://github.com/AgriciDaniel/claude-seo --skill seo-hreflang-agricidaniel

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill addresses the complexities of international SEO by validating and generating correct hreflang implementations, preventing common errors that harm search engine visibility for multi-language and multi-region websites.

Core Features & Use Cases

  • Hreflang Validation: Detects critical errors like missing self-referencing tags, broken return tags, and incorrect language/region codes.
  • Hreflang Generation: Creates accurate hreflang tags for HTML, HTTP headers, or XML sitemaps.
  • Use Case: A global e-commerce site has separate domains for the US, UK, and France. This Skill can audit their current hreflang setup to ensure Google correctly serves the right language version to users worldwide, or generate a new sitemap-based implementation.

Quick Start

Validate the hreflang implementation on example.com.

Frequently Asked Questions about seo-hreflang

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

FAQPage Schema
How do I validate hreflang tags for international SEO?

Hreflang validation analyzes HTML, HTTP headers, and XML sitemaps to detect missing self-referencing tags, broken return tags, incorrect language/region codes, and canonical misalignment, ensuring search engines correctly serve regional website versions.

What is the best way to generate hreflang tags for HTML and XML sitemaps?

The best way to generate hreflang tags is to create accurate language and region annotations directly within HTML, HTTP headers, or XML sitemaps, ensuring proper x-default configuration and protocol consistency across all international domain versions.

Why does Google show the wrong language version of my multi-region website?

Google shows the wrong language version when your hreflang implementation contains errors like missing return tags, incorrect language/region codes, or canonical misalignment. Validating cross-domain implementations and protocol consistency corrects these international SEO visibility issues.

Can I implement hreflang tags across multiple cross-domain international websites?

Yes, you can implement hreflang tags across multiple cross-domain international websites by generating and validating consistent language tags, return tags, and x-default configurations across separate domains, ensuring correct global search engine visibility.

Do I need a self-referencing hreflang tag on every page?

Yes, a self-referencing hreflang tag is required on every page. Validation detects missing self-referencing tags as critical errors, alongside broken return tags and incorrect language/region codes, to maintain proper international SEO structure.