Add SEO skills 19-28, 31-32 with full Python implementations

12 new skills: Keyword Strategy, SERP Analysis, Position Tracking, Link Building, Content Strategy, E-Commerce SEO, KPI Framework, International SEO, AI Visibility, Knowledge Graph, Competitor Intel, and Crawl Budget. ~20K lines of Python across 25 domain scripts. Updated skill 11 pipeline table and repo CLAUDE.md. Enhanced skill 18 local SEO workflow from jamie.clinic audit. Note: Skill 26 hreflang_validator.py pending (content filter block). Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-13 12:05:59 +09:00
parent 159f7ec3f7
commit a3ff965b87
125 changed files with 25948 additions and 173 deletions
--- a/custom-skills/31-seo-competitor-intel/desktop/SKILL.md
+++ b/custom-skills/31-seo-competitor-intel/desktop/SKILL.md
@@ -0,0 +1,147 @@
+---
+name: seo-competitor-intel
+description: |
+  Competitor intelligence and SEO benchmarking. Triggers: competitor analysis, competitive intelligence, competitor comparison, threat assessment, market position, benchmarking.
+---
+
+# SEO Competitor Intelligence & Benchmarking
+
+## Purpose
+
+Comprehensive competitor intelligence for SEO: auto-discover competitors, build profile cards, create head-to-head comparison matrices, analyze keyword overlap, track traffic trends, and score competitive threats. Supports Korean market analysis including Naver Blog/Cafe presence.
+
+## Core Capabilities
+
+1. **Competitor Discovery** - Auto-discover organic competitors via Ahrefs
+2. **Profile Cards** - DR, traffic, keywords, referring domains, top pages, content volume
+3. **Comparison Matrix** - Multi-dimensional head-to-head comparison
+4. **Keyword Overlap** - Shared, unique, and gap keyword analysis
+5. **Threat Scoring** - 0-100 score based on DR gap, traffic ratio, keyword overlap, growth
+6. **Competitive Monitoring** - Traffic trends, DR changes, keyword movement, content velocity
+7. **Alert Generation** - Flag significant competitive movements
+8. **Market Share Estimation** - Organic traffic share within competitive set
+
+## MCP Tool Usage
+
+### Ahrefs for Competitive Data
+```
+mcp__ahrefs__site-explorer-organic-competitors: Discover organic competitors
+mcp__ahrefs__site-explorer-metrics: Current organic metrics
+mcp__ahrefs__site-explorer-metrics-history: Historical metric trends
+mcp__ahrefs__site-explorer-domain-rating: Domain Rating score
+mcp__ahrefs__site-explorer-domain-rating-history: DR trend over time
+mcp__ahrefs__site-explorer-organic-keywords: Keyword rankings per domain
+mcp__ahrefs__site-explorer-top-pages: Top performing pages
+mcp__ahrefs__site-explorer-pages-by-traffic: Pages ranked by traffic
+mcp__ahrefs__site-explorer-referring-domains: Referring domain list
+mcp__ahrefs__site-explorer-backlinks-stats: Backlink overview
+mcp__ahrefs__site-explorer-pages-history: Page index history
+```
+
+### Notion for Report Storage
+```
+mcp__notion__notion-create-pages: Save reports to SEO Audit Log
+```
+
+### WebSearch for Korean Market
+```
+WebSearch: Check Naver Blog/Cafe presence for competitors
+```
+
+## Workflow
+
+### Competitor Profiling
+1. Accept target URL/domain
+2. Auto-discover competitors via Ahrefs organic-competitors (or use provided list)
+3. Build profile card for target and each competitor (DR, traffic, keywords, backlinks, content)
+4. Analyze keyword overlap between target and each competitor
+5. Build multi-dimensional comparison matrix
+6. Score competitive threats (0-100)
+7. Determine market position (leader/challenger/follower/niche)
+8. If Korean market: check Naver Blog/Cafe presence
+
+### Competitive Monitoring
+1. Accept target, competitors, and monitoring period
+2. Fetch traffic trend history for all domains
+3. Fetch DR trend history for all domains
+4. Track keyword movement (new/lost keywords)
+5. Compare content publication velocity
+6. Generate alerts for significant changes (>20% traffic, DR jump, keyword surge)
+7. Estimate market share within competitive set
+
+## Output Format
+
+### Profiling Report
+```markdown
+## Competitor Intelligence Report: [domain]
+
+### Target Profile
+- Domain Rating: [DR]
+- Organic Traffic: [traffic]
+- Keywords: [count]
+- Referring Domains: [count]
+
+### Competitors (by threat score)
+1. **[competitor.com]** - Threat: [score]/100
+   - DR: [value] | Traffic: [value] | Keywords: [value]
+   - Keyword Overlap: [shared] shared, [gap] gap
+   - Strengths: [list]
+   - Weaknesses: [list]
+
+### Comparison Matrix
+| Dimension | Target | Comp1 | Comp2 |
+|-----------|--------|-------|-------|
+
+### Market Position: [leader/challenger/follower/niche]
+```
+
+### Monitoring Report
+```markdown
+## Competitive Monitoring Report: [domain]
+### Period: [N] days
+
+### Alerts
+- [severity] [message]
+
+### Traffic Trends
+| Domain | Direction | Growth | Current |
+
+### Keyword Movements
+| Domain | New | Lost | Net |
+
+### Market Share
+| Domain | Traffic% | Overall% |
+```
+
+## Threat Scoring Methodology
+
+| Factor | Weight | Scale |
+|--------|--------|-------|
+| DR Gap | 20% | -30 to +30 mapped to 0-100 |
+| Traffic Ratio | 30% | 0x to 2x+ mapped to 0-100 |
+| Keyword Overlap | 25% | 0-50%+ mapped to 0-100 |
+| Gap Keywords | 25% | Ratio to target keywords |
+
+## Alert Thresholds
+
+| Alert Type | Threshold | Severity |
+|------------|-----------|----------|
+| Traffic change | >20% | warning; >50% critical |
+| DR change | >3 points | warning; >5 critical |
+| Keyword surge | >15% growth | warning |
+| Content burst | >2x avg velocity | info |
+
+## Limitations
+
+- Ahrefs data has ~24h freshness lag
+- Keyword overlap limited to top 1,000 keywords per domain
+- Content velocity based on Ahrefs page index (not real-time crawl)
+- Naver presence detection is heuristic-based
+
+## Notion Output (Required)
+
+All reports MUST be saved to OurDigital SEO Audit Log:
+- **Database ID**: `2c8581e5-8a1e-8035-880b-e38cefc2f3ef`
+- **Properties**: Issue (title), Site (url), Category ("Competitor Intelligence"), Priority, Found Date, Audit ID
+- **Language**: Korean with English technical terms
+- **Audit ID Format**: COMP-YYYYMMDD-NNN
--- a/custom-skills/31-seo-competitor-intel/desktop/skill.yaml
+++ b/custom-skills/31-seo-competitor-intel/desktop/skill.yaml
@@ -0,0 +1,8 @@
+name: seo-competitor-intel
+description: |
+  Competitor intelligence and SEO benchmarking. Triggers: competitor analysis, competitive intelligence, competitor comparison, threat assessment, market position, benchmarking.
+allowed-tools:
+  - mcp__ahrefs__*
+  - mcp__notion__*
+  - WebSearch
+  - WebFetch
--- a/custom-skills/31-seo-competitor-intel/desktop/tools/ahrefs.md
+++ b/custom-skills/31-seo-competitor-intel/desktop/tools/ahrefs.md
@@ -0,0 +1,35 @@
+# Ahrefs
+
+> MCP tool documentation for competitor intelligence skill
+
+## Available Commands
+
+- `site-explorer-metrics` - Get current organic metrics for a domain
+- `site-explorer-metrics-history` - Get historical organic metrics trends
+- `site-explorer-organic-competitors` - Discover organic search competitors
+- `site-explorer-organic-keywords` - Get keyword rankings per domain
+- `site-explorer-top-pages` - Get top performing pages by traffic
+- `site-explorer-pages-by-traffic` - Get pages ranked by organic traffic
+- `site-explorer-domain-rating` - Get Domain Rating score
+- `site-explorer-domain-rating-history` - Get DR trend over time
+- `site-explorer-referring-domains` - Get list of referring domains
+- `site-explorer-backlinks-stats` - Get backlink overview statistics
+- `site-explorer-pages-history` - Get page index history
+
+## Configuration
+
+- Requires Ahrefs MCP server configured in Claude Desktop
+- API access via `mcp__ahrefs__*` tool prefix
+
+## Examples
+
+```
+# Discover competitors
+mcp__ahrefs__site-explorer-organic-competitors(target="example.com")
+
+# Get domain metrics
+mcp__ahrefs__site-explorer-metrics(target="example.com")
+
+# Get keyword rankings
+mcp__ahrefs__site-explorer-organic-keywords(target="example.com", limit=100)
+```
--- a/custom-skills/31-seo-competitor-intel/desktop/tools/notion.md
+++ b/custom-skills/31-seo-competitor-intel/desktop/tools/notion.md
@@ -0,0 +1,33 @@
+# Notion
+
+> MCP tool documentation for saving competitor intelligence reports
+
+## Available Commands
+
+- `notion-create-pages` - Create new pages in the SEO Audit Log database
+- `notion-update-page` - Update existing audit entries
+- `notion-query-database-view` - Query existing reports
+- `notion-search` - Search across Notion workspace
+
+## Configuration
+
+- Database ID: `2c8581e5-8a1e-8035-880b-e38cefc2f3ef`
+- All reports saved with Category: "Competitor Intelligence"
+- Audit ID format: COMP-YYYYMMDD-NNN
+
+## Examples
+
+```
+# Create competitor intelligence report
+mcp__notion__notion-create-pages(
+  database_id="2c8581e5-8a1e-8035-880b-e38cefc2f3ef",
+  properties={
+    "Issue": {"title": [{"text": {"content": "경쟁사 분석 보고서 - 2025-01-15"}}]},
+    "Site": {"url": "https://example.com"},
+    "Category": {"select": {"name": "Competitor Intelligence"}},
+    "Priority": {"select": {"name": "High"}},
+    "Found Date": {"date": {"start": "2025-01-15"}},
+    "Audit ID": {"rich_text": [{"text": {"content": "COMP-20250115-001"}}]}
+  }
+)
+```
--- a/custom-skills/31-seo-competitor-intel/desktop/tools/websearch.md
+++ b/custom-skills/31-seo-competitor-intel/desktop/tools/websearch.md
@@ -0,0 +1,28 @@
+# WebSearch
+
+> Web search tool documentation for competitor intelligence
+
+## Available Commands
+
+- `WebSearch` - Search the web for competitor information, market data, and Korean market presence
+
+## Configuration
+
+- No additional configuration required
+- Available as built-in Claude tool
+
+## Examples
+
+```
+# Check Naver Blog presence
+WebSearch(query="site:blog.naver.com competitor-domain.com")
+
+# Check Naver Cafe presence
+WebSearch(query="site:cafe.naver.com competitor-domain.com")
+
+# Research competitor market presence
+WebSearch(query="competitor-domain.com market share industry analysis")
+
+# Korean market competitor discovery
+WebSearch(query="경쟁사 분석 industry-keyword")
+```