---
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

```bash
# Hreflang validation
python /Users/ourdigital/Projects/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/Projects/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/Projects/our-claude-skills/custom-skills/26-seo-international/code/scripts/hreflang_validator.py \
  --urls-file pages.txt --json

# Full international audit
python /Users/ourdigital/Projects/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/Projects/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/Projects/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/Projects/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)