feat(seo-skills): multi-backend Data Source Selection (#7)

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>
This commit is contained in:
Andrew Yim
2026-05-14 03:15:32 +09:00
committed by GitHub
parent 1ca84f67ed
commit e527fb4b0f
71 changed files with 2647 additions and 258 deletions

View File

@@ -0,0 +1,42 @@
# OurSEO Agent (CLI + MCP)
**Default** for hreflang validation, content parity, redirect logic, and the fix engine. Only backend that owns the hreflang **fix** path end-to-end.
## CLI commands (Claude Code)
```bash
# Crawl all language versions
our collect crawl https://<site> --max-pages 500
# Technical audit including hreflang
our audit tech https://<site>
# Hreflang fix (writes back to CMS if --deploy and CMS adapter configured)
our fix hreflang --site https://<site>
# Per-region SERP / Naver expansion checks
our research naver serp "<keyword>"
our research keywords compare "<keyword>" --engines naver
```
## MCP tools (Claude Desktop)
```
mcp__ourseo__crawl_website(url="<site>", max_pages=500)
mcp__ourseo__audit_page(url="<url>", audit_type="tech")
```
## Strengths for this skill
- **Hreflang validation:** bidirectional links, self-reference, x-default, language/region code validation.
- **Hreflang fix:** auto-corrects tags via Ghost/WordPress/Strapi adapters.
- **Content parity audit:** page counts, key-page availability, freshness comparison across language versions.
- **Naver / regional engine coverage** — Semrush/Ahrefs only cover Google.
## Not for this skill when
- **Per-country traffic distribution KPI** — Ahrefs `web-analytics-countries` is cleaner.
- **Per-database organic visibility comparison** — Semrush per-`database` calls.
- **Redirect-logic audit with custom Accept-Language headers** — WebFetch directly.
See also: `docs/user-manual.md` for the full `our fix` command surface.