# OurSEO Agent (CLI + MCP)

**Default** for hreflang validation, content parity, redirect logic, and the fix engine. Only backend that owns the hreflang **fix** path end-to-end.

## CLI commands (Claude Code)

```bash
# Crawl all language versions
our collect crawl https://<site> --max-pages 500

# Technical audit including hreflang
our audit tech https://<site>

# Hreflang fix (writes back to CMS if --deploy and CMS adapter configured)
our fix hreflang --site https://<site>

# Per-region SERP / Naver expansion checks
our research naver serp "<keyword>"
our research keywords compare "<keyword>" --engines naver
```

## MCP tools (Claude Desktop)

```
mcp__ourseo__crawl_website(url="<site>", max_pages=500)
mcp__ourseo__audit_page(url="<url>", audit_type="tech")
```

## Strengths for this skill

- **Hreflang validation:** bidirectional links, self-reference, x-default, language/region code validation.
- **Hreflang fix:** auto-corrects tags via Ghost/WordPress/Strapi adapters.
- **Content parity audit:** page counts, key-page availability, freshness comparison across language versions.
- **Naver / regional engine coverage** — Semrush/Ahrefs only cover Google.

## Not for this skill when

- **Per-country traffic distribution KPI** — Ahrefs `web-analytics-countries` is cleaner.
- **Per-database organic visibility comparison** — Semrush per-`database` calls.
- **Redirect-logic audit with custom Accept-Language headers** — WebFetch directly.

See also: `docs/user-manual.md` for the full `our fix` command surface.
