# OurSEO Agent (CLI + MCP)

Two paths:

1. **CLI** (Claude Code) — `our serp *` and `our keywords *` (DataForSEO under the hood).
2. **MCP** (Claude Desktop) — `mcp__ourseo__check_serp` for single-keyword spot-check.

## CLI commands

```bash
# Ranked keywords for a domain (modelled)
our serp ranked-keywords <domain> --location 2410 --limit 100 --format json
our serp domain-overview <domain> --location 2410 --format json
our serp competitors <domain> --location 2410

# Volume / KD pulls to weight visibility scores
our keywords volume "<kw1>" "<kw2>" --location 2410 --language ko
```

Location codes: `2410` Korea, `2840` US, `2392` Japan.

## MCP tool (spot-check)

```
mcp__ourseo__check_serp(keyword="<keyword>", domain="<target>", country="kr")
```

## Strengths

- Cheapest per call for Korean batch rank pulls (`--location 2410`).
- No project setup required — just call.
- MCP `check_serp` is the cheapest live position verification path.

## Not for this skill when

- **Historical trend / period-over-period continuity** — needs an Ahrefs / Semrush project that polls regularly. OurSEO is point-in-time only; pair with MySQL workspace to keep history.
- **First-party position truth** — GSC.
