e527fb4b0f
Replaces single-vendor (Ahrefs-only) tool defaults with a per-task backend menu across all 14 SEO skills. Each skill now lists every capable MCP in allowed-tools and documents how to pick between Semrush, Ahrefs, OurSEO Agent (CLI + MCP), DataForSEO, and GSC in its SKILL.md Data Source Selection section. Tool stubs (~40 new files) populated per skill with capability deltas, call patterns, and explicit "not for this skill when" callouts so the menu is self-correcting. Skills affected: 19-keyword-strategy, 20-serp-analysis, 21-position-tracking, 22-link-building, 23-content-strategy, 24-ecommerce, 25-kpi-framework, 26-international, 27-ai-visibility, 28-knowledge-graph, 31-competitor-intel, 32-crawl-budget, 33-migration-planner, 34-reporting-dashboard. Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2.0 KiB
2.0 KiB
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)
# 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.
@graphJSON-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.