# OurSEO Agent (CLI + MCP)

In the reporting dashboard, OurSEO owns the **technical health**, **indexed pages**, **first-party (GSC / GA4 / GBP)**, **schema coverage**, and **Korean engine** sections.

## Tools used in dashboard sections

| Section | Command / tool |
|---|---|
| Technical health score | `our audit tech https://<site>` |
| Crawl errors / issues | `our analyze mysql-batch --session <id>` |
| Indexed page count | `our research google index --domain <site>` / `mcp__ourseo__check_index` |
| Schema coverage | `our analyze mysql-batch --session <id> --export missing-schema` |
| First-party clicks/impressions | `our research search-console queries --site sc-domain:<site> --days 28` |
| GA4 sessions / channels | `our research ga4 traffic --property-id <id>`, `our research ga4 channels` |
| GBP visibility | `our collect gbp reviews/locations`, `our audit local` |
| Korean SERP / Naver visibility | `our research naver serp "<keyword>"` |
| Knowledge Graph entity status | `our research kg lookup "<entity>"` |
| Content freshness | `our collect crawl https://<site>` |
| SERP spot-check | `mcp__ourseo__check_serp(...)` |

## MCP tools (Claude Desktop equivalents)

```
mcp__ourseo__check_index(domain="<site>")
mcp__ourseo__audit_page(url="<url>", audit_type="tech")
mcp__ourseo__check_serp(keyword="<kw>", domain="<site>", country="kr")
mcp__ourseo__search_knowledge_graph(query="<entity>")
```

## Strengths for the dashboard

- **First-party data routed through one CLI** — GSC + GA4 + GBP all in `our research *`.
- **MySQL workspace** — period-over-period diff is a SQL query, not a re-pull.
- Only path for **Korean engine** + **Knowledge Graph entity** sections.
- **Audit ID format** convention (KW-, RANK-, COMP-, etc.) baked into the CLI — keeps Notion Audit Log entries consistent.

## Reporting rule

Whenever OurSEO feeds a section, list it in the report's **Sources** subsection with the specific command + date window (e.g., `Technical health: OurSEO audit tech (crawl 2026-05-14)`, `GSC: 28-day window 2026-04-16 → 2026-05-14`).

## Not for this skill when

- **Modelled traffic / traffic value** — Semrush `overview_research`.
- **Backlinks / DR** — Ahrefs `site-explorer-domain-rating`.
- **AI visibility / Brand Radar** — Ahrefs `brand-radar-*`.
- **Multi-vendor visibility benchmarks** — pair with Semrush / Ahrefs.

Cross-reference: see skill 25 (KPI framework) for the per-metric backend map used to feed this dashboard.