# OurSEO Agent (CLI + MCP)

In the KPI framework, OurSEO owns **technical health**, **indexed pages**, **GA4**, **GBP local**, and **first-party crawl-derived** KPIs. It is also the gateway to GSC via `our research search-console`.

## KPI dimensions served by OurSEO

| KPI | Command |
|---|---|
| Technical health score | `our audit tech https://<site>` |
| Crawl efficiency / errors | `our analyze mysql-batch --session <id>` |
| Indexed pages | `our research google index --domain <site>` / `mcp__ourseo__check_index` |
| First-party clicks/impressions/CTR | `our research search-console queries --site sc-domain:<site> --days 28` |
| GA4 sessions / traffic / channel | `our research ga4 traffic --property-id <id>` |
| GA4 landing pages | `our research ga4 landing-pages --property-id <id>` |
| GA4 channel mix | `our research ga4 channels --property-id <id>` |
| GBP visibility / reviews / posts | `our collect gbp reviews/locations/posts ...`, `our audit local` |
| Content freshness | `our collect crawl https://<site>` (extracts last-modified) |
| Schema coverage | `our analyze mysql-batch --session <id> --export missing-schema` |

## MCP equivalents (Claude Desktop)

```
mcp__ourseo__check_index(domain="<site>")
mcp__ourseo__audit_page(url="<url>", audit_type="tech")
mcp__ourseo__crawl_website(url="<site>", max_pages=100)
```

## Strengths for this skill

- **First-party** GSC + GA4 + GBP all routed through one CLI — easiest way to get ground-truth KPIs.
- **Owns technical health + indexed pages** end-to-end.
- Stores results in MySQL workspace — supports period-over-period KPI comparison without re-pulling.

## Not for this skill when

- **Modelled traffic-value** — Semrush `overview_research` is the cleanest source.
- **Backlinks / DR / Authority** — Ahrefs (or Semrush) backlink endpoints.
- **AI visibility KPI** — Ahrefs Brand Radar.
