# OurSEO Agent (CLI + MCP)

**Default** for e-commerce crawl, product schema validation, category taxonomy audit, duplicate/canonical detection, and the schema-fix path. Only backend that owns the catalog audit → fix workflow end-to-end.

## CLI commands (Claude Code)

```bash
# Crawl the catalog
our collect crawl https://<store> --max-pages 500
our collect distributed https://<store> --workers 8 --max-pages 50000

# Technical + schema audit
our audit tech https://<store>
our analyze mysql-batch --session <id> --export missing-schema --format excel

# Build / fix Product schema
our build kg-schema --type Product --name "<product>" --url <product-url> --auto-sameas
our fix entity-schema --site https://<store> --type Product --entity-name "<product>" --cms <ghost|wordpress|strapi> --deploy

# Korean batch keyword work
our keywords ideas "<product>" --location 2410 --limit 50
our serp ranked-keywords <store> --location 2410 --limit 100
```

## MCP tools (Claude Desktop)

```
mcp__ourseo__crawl_website(url="<store>", max_pages=500)
mcp__ourseo__audit_page(url="<product-url>", audit_type="schema")
mcp__ourseo__audit_page(url="<product-url>", audit_type="tech")
```

## Strengths for this skill

- **Schema validation + deploy** — Product, Offer, AggregateRating, Review, BreadcrumbList. Validates AND can fix via CMS adapters.
- **Canonical + duplicate detection** — built into the crawl + audit stage.
- **Korean market batch** — `--location 2410` covers Korean e-commerce keyword work cheaply.
- **Distributed crawler** scales to multi-tenant catalog audits.

## Not for this skill when

- **Competitor organic research** — Semrush `organic_research` is cleaner.
- **Product/category backlink analysis** — Ahrefs `site-explorer-top-pages` + backlinks.
- **Korean marketplace presence detection** — WebSearch (Naver Smart Store, Coupang, Gmarket, 11번가).
