our-claude-skills/.claude/commands/seo-international.md

description

description
International SEO - hreflang validation, content parity, multi-language audit

SEO International Audit

Multi-language and multi-region SEO audit with hreflang validation and content parity analysis.

Triggers

• "international SEO", "hreflang", "multi-language SEO", "다국어 SEO"

Capabilities

1. Hreflang Validation - Bidirectional links, self-referencing, x-default, ISO code checks
2. URL Structure Analysis - ccTLD vs subdomain vs subdirectory with recommendations
3. Content Parity - Page count, key page availability, freshness comparison across languages
4. Language Detection - HTML lang attribute, Content-Language header, actual content analysis
5. Redirect Logic Audit - IP-based and Accept-Language redirect behavior
6. Korean Expansion - Priority markets (ko->ja, ko->zh, ko->en), CJK URL encoding, Naver/Baidu considerations

Scripts

# Hreflang validation
python /Users/ourdigital/Project/our-claude-skills/custom-skills/26-seo-international/code/scripts/hreflang_validator.py \
  --url https://example.com --json

# With sitemap-based discovery
python /Users/ourdigital/Project/our-claude-skills/custom-skills/26-seo-international/code/scripts/hreflang_validator.py \
  --url https://example.com --sitemap https://example.com/sitemap.xml --json

# Check specific pages from file
python /Users/ourdigital/Project/our-claude-skills/custom-skills/26-seo-international/code/scripts/hreflang_validator.py \
  --urls-file pages.txt --json

# Full international audit
python /Users/ourdigital/Project/our-claude-skills/custom-skills/26-seo-international/code/scripts/international_auditor.py \
  --url https://example.com --json

# URL structure analysis only
python /Users/ourdigital/Project/our-claude-skills/custom-skills/26-seo-international/code/scripts/international_auditor.py \
  --url https://example.com --scope structure --json

# Content parity check only
python /Users/ourdigital/Project/our-claude-skills/custom-skills/26-seo-international/code/scripts/international_auditor.py \
  --url https://example.com --scope parity --json

# Korean expansion focus
python /Users/ourdigital/Project/our-claude-skills/custom-skills/26-seo-international/code/scripts/international_auditor.py \
  --url https://example.com --korean-expansion --json

Output

• Hreflang error report (missing bidirectional, self-reference, x-default)
• URL structure recommendation
• Content parity matrix across languages (page count, freshness)
• Redirect logic assessment (forced vs suggested)
• International SEO score
• Reports saved to Notion SEO Audit Log (Category: International SEO)