ourdigital/our-claude-skills
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

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

Browse Source 
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
Download Patch File Download Diff File Expand all files Collapse all files

64
custom-skills/31-seo-competitor-intel/desktop/SKILL.md
View File

@@ -24,24 +24,72 @@ Comprehensive competitor intelligence for SEO: auto-discover competitors, build
7. **Alert Generation** - Flag significant competitive movements
8. **Market Share Estimation** - Organic traffic share within competitive set
## MCP Tool Usage
## Data Source Selection
### SEO Data
Competitor intelligence spans **organic profile** (traffic, keywords), **backlink profile** (DR, refdomains), **content velocity** (top pages, new content), and **Korean platform presence**. Different backends own different slices.
| Backend | Best for | Notes |
|---|---|---|
| **Semrush MCP** (`mcp__semrush__*`) | **Default** for organic competitor profile, keyword overlap, traffic trends | `organic_research`, `trends_research`, `overview_research` → `get_report_schema` → `execute_report`. Auto-discovery of competitors. |
| **Ahrefs MCP** (`mcp__ahrefs__*`) | Backlink profile, organic competitor discovery, top-pages-by-traffic, historical DR | `site-explorer-organic-competitors`, `site-explorer-organic-keywords`, `site-explorer-top-pages`, `site-explorer-domain-rating-history`, `site-explorer-backlinks-stats`. Pair with Semrush for cross-check. |
| **OurSEO** (CLI + MCP) | SERP overlap spot-checks, content similarity, crawl-derived content velocity | `mcp__ourseo__check_serp`, `mcp__ourseo__find_similar_pages`, `mcp__ourseo__crawl_website`. CLI: `our serp competitors`, `our serp ranked-keywords`. |
| **OurSEO CLI — Korean** (`our research naver *`) | Naver-engine competitor analysis (Blog/Cafe/Smart Store presence, Naver SERP) | Naver-only; required for Korean market since Semrush/Ahrefs don't cover Naver. |
| **WebSearch** | Korean Blog/Cafe/Tistory/Brunch presence checks | Supplement Korean platform mapping when Semrush/Ahrefs underrepresent these. |
| **DataForSEO MCP** (`mcp__dfs-mcp__*`) | Fallback for ranked-keywords / SERP competitors when `our` CLI isn't running | Same data as `our serp *`. |
### How to pick
1. **User named a backend explicitly** → use it.
2. **User preference memory** — read `feedback_seo_tool_preferences.md`; honor the task-type default.
3. **Task is backlink-focused** (DR comparison, link gap) → Ahrefs (backlink-graph moat).
4. **Task is keyword/traffic-focused** → Semrush (organic competitor view is strongest).
5. **Task is Korean-market competitor analysis** → **OurSEO CLI** (`our research naver *` + `our serp * --location 2410`). Korean platforms aren't covered by Semrush/Ahrefs.
6. **Default**: Semrush MCP for organic + Ahrefs for backlinks (paired). Korean override: OurSEO CLI.
7. **Still ambiguous + non-trivial** → ask once via `AskUserQuestion`.
### Backend call patterns
**Semrush MCP (default organic):**
```
our-seo-agent CLI: Primary competitive data source (future); use --input for pre-fetched JSON
WebSearch / WebFetch: Supplementary competitor data
mcp__semrush__organic_research(query="<target>", database="us")
mcp__semrush__organic_research(query="<competitor>", database="us")
mcp__semrush__trends_research(query="<target>", database="us")
mcp__semrush__overview_research(query="<target>", database="us")
```
### Notion for Report Storage
**Ahrefs MCP (backlink + top pages):**
```
mcp__notion__notion-create-pages: Save reports to SEO Audit Log
mcp__ahrefs__site-explorer-organic-competitors(target="<target>")
mcp__ahrefs__site-explorer-organic-keywords(target="<target>", country="us", limit=500)
mcp__ahrefs__site-explorer-top-pages(target="<competitor>", country="us")
mcp__ahrefs__site-explorer-domain-rating-history(target="<target>", history="weekly")
mcp__ahrefs__site-explorer-backlinks-stats(target="<target>")
```
### WebSearch for Korean Market
**OurSEO (SERP overlap + content similarity):**
```
WebSearch: Check Naver Blog/Cafe presence for competitors
mcp__ourseo__check_serp(keyword="<keyword>", domain="<target>", country="kr")
mcp__ourseo__find_similar_pages(crawl_path="<path>", query="<topic>")
mcp__ourseo__crawl_website(url="<competitor>", max_pages=50)
```
**OurSEO CLI (Korean batch):**
```bash
our serp ranked-keywords <competitor.com> --location 2410 --limit 100
our serp competitors <target.com> --location 2410
our research naver serp "<keyword>"
our research naver keywords ideas "<keyword>"
```
**Korean platform presence (WebSearch):**
```
WebSearch: blog.naver.com "<competitor brand>"
WebSearch: cafe.naver.com "<competitor brand>"
WebSearch: tistory.com "<competitor brand>"
```
Always record the chosen data source(s) in the report **Overview** so future runs can compare like-for-like.
## Workflow
### Competitor Profiling