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

52
custom-skills/22-seo-link-building/desktop/SKILL.md
View File

@@ -20,20 +20,58 @@ Analyze backlink profiles, detect toxic links, find competitor link gaps, track
5. **Broken Backlink Recovery** - Find and reclaim broken high-DR backlinks
6. **Korean Platform Mapping** - Naver Blog, Cafe, Tistory, Brunch, Korean news
## MCP Tool Usage
## Data Source Selection
### SEO Data
This skill can pull backlink data from multiple backends. **Pick one per task** — don't fan out by default (cost + rate limits). Backlink graphs are the most cost-sensitive of all SEO data.
| Backend | Best for | Notes |
|---|---|---|
| **Ahrefs MCP** (`mcp__ahrefs__*`) | **Default** — Ahrefs' backlink graph remains the strongest in the industry. All `site-explorer-*` endpoints. | Primary capability: `site-explorer-domain-rating`, `-backlinks-stats`, `-referring-domains`, `-anchors`, `-broken-backlinks`, `-refdomains-history`. |
| **Semrush MCP** (`mcp__semrush__*`) | Alternative when user is already in Semrush context or wants a second opinion | `backlink_research` covers similar ground; Authority Score replaces DR. Coverage is competitive but not identical to Ahrefs. |
| **OurSEO** | **Not a backlink source.** No backlink graph in the OurSEO stack. | If asked, use OurSEO MCP / CLI only as a supplement for on-page link inventory (`crawl_website` extracts internal/outbound links from the target site itself). |
| **WebSearch / WebFetch** | Manual spot-check of a specific referring URL | Useful for verifying anchor / context of a high-value referring page. |
### 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 comparison across vendors** (e.g., "verify Ahrefs claims with Semrush") → run both, document the source per metric.
4. **Default**: **Ahrefs MCP** — backlink work is the one SEO task where Ahrefs is the default, not Semrush.
5. **Still ambiguous + non-trivial** → ask once via `AskUserQuestion`.
### Backend call patterns
**Ahrefs MCP (default):**
```
our-seo-agent CLI: Primary backlink data source (future); use --input for pre-fetched JSON
WebSearch / WebFetch: Supplementary backlink data
mcp__ahrefs__site-explorer-domain-rating(target="<domain>")
mcp__ahrefs__site-explorer-backlinks-stats(target="<domain>")
mcp__ahrefs__site-explorer-referring-domains(target="<domain>", limit=100)
mcp__ahrefs__site-explorer-anchors(target="<domain>")
mcp__ahrefs__site-explorer-broken-backlinks(target="<domain>", limit=100)
mcp__ahrefs__site-explorer-refdomains-history(target="<domain>", history="weekly")
mcp__ahrefs__site-explorer-all-backlinks(target="<domain>", limit=500)
mcp__ahrefs__site-explorer-linked-anchors-external(target="<competitor>")
```
### Notion for Report Storage
**Semrush MCP (alternative):**
```
mcp__notion__notion-create-pages: Save audit report to SEO Audit Log
mcp__notion__notion-update-page: Update existing audit entries
mcp__semrush__backlink_research(query="<domain>", database="us")
mcp__semrush__get_report_schema(report_id="...")
mcp__semrush__execute_report(report_id="...", params={...})
```
**OurSEO (on-page link inventory, supplement only):**
```
mcp__ourseo__crawl_website(url="<domain>", max_pages=100)
# Extract internal/outbound link inventory from crawl output — NOT a backlink graph.
```
### Korean platform mapping
Backlinks from Korean platforms (Naver Blog, Cafe, Tistory, Brunch, Korean news) are often underrepresented in both Ahrefs and Semrush. After pulling from the chosen backend, supplement with `WebSearch` for major Korean directories and brand-name queries on Naver to spot-check coverage gaps.
Always record the chosen data source in the report **Overview** so future audits can compare like-for-like.
## Workflow
### 1. Backlink Profile Audit