# OurSEO Agent (CLI + MCP)

**Default** for Knowledge Graph + entity SEO end-to-end. Only backend with an integrated KG lookup → entity audit → schema build → schema fix workflow.

## CLI commands (Claude Code)

```bash
# KG lookup (Google KG Search API)
our research kg lookup "<entity>" --language ko
our research kg resolve "<entity>" --domain <site> --language ko

# Entity audit (sameAs, entity schemas on the site)
our audit entity https://<site> --entity "<entity>" --language ko
our audit sameas https://<site> --brand "<brand>"

# Build entity schema as JSON-LD @graph
our build kg-schema --type Organization --name "<entity>" --url https://<site> --auto-sameas

# Fix entity schema in CMS (Ghost / WordPress / Strapi)
our fix entity-schema --site https://<site> --type Organization \
  --entity-name "<entity>" --auto-sameas --cms ghost --deploy

# Archive audit to Notion
our output notion kg-audit --input entity-report.json
```

## MCP tools (Claude Desktop)

```
mcp__ourseo__search_knowledge_graph(query="<entity>", language="ko")
```

## Strengths for this skill

- **Only end-to-end path**: KG lookup → entity audit → schema build → CMS deploy.
- **sameAs validation** — checks that JSON-LD sameAs links resolve (not 404 / 403).
- **Korean coverage** — Korean entity workflows (Naver encyclopedia, 지식iN) baked in via the CLI.
- **`@graph` JSON-LD output** with auto-sameAs — produces deploy-ready schema.

## Not for this skill when

- **Knowledge Panel detection on Google SERP** — WebSearch (no MCP exposes Knowledge Panel structure).
- **Wikipedia / Wikidata presence** — WebSearch / WebFetch.
- **First-party brand-query data** (impressions, CTR for brand searches) — GSC or Ahrefs `gsc-keywords`.

## Config

| Env var | Purpose |
|---|---|
| `GOOGLE_KG_API_KEY` | Knowledge Graph Search API key (op://Development/...) |
| `OURSEO_GHOST_API_KEY` / `OURSEO_WP_*` / `OURSEO_STRAPI_API_TOKEN` | CMS adapter auth for `--deploy` |

Cross-reference: [[reference_1password_api_credentials]] in memory.