Andrew Yim
d2d0a2d460
New skills: - Skill 33: Site migration planner with redirect mapping and monitoring - Skill 34: Reporting dashboard with HTML charts and Korean executive reports Bug fixes (Skill 34 - report_aggregator.py): - Add audit_type fallback for skill identification (was only using audit_id prefix) - Extract health scores from nested data dict (technical_score, onpage_score, etc.) - Support subdomain matching in domain filter (blog.ourdigital.org matches ourdigital.org) - Skip self-referencing DASH- aggregated reports Bug fixes (Skill 20 - naver_serp_analyzer.py): - Remove VIEW tab selectors (removed by Naver in 2026) - Add new section detectors: books (도서), shortform (숏폼), influencer (인플루언서) Improvements (Skill 34 - dashboard/executive report): - Add Korean category labels for Chart.js charts (기술 SEO, 온페이지, etc.) - Add Korean trend labels (개선 중 ↑, 안정 →, 하락 중 ↓) - Add English→Korean issue description translation layer (20 common patterns) Documentation improvements: - Add Korean triggers to 4 skill descriptions (19, 25, 28, 31) - Expand Skill 32 SKILL.md from 40→143 lines (was 6/10, added workflow, output format, limitations) - Add output format examples to Skills 27 and 28 SKILL.md - Add limitations sections to Skills 27 and 28 - Update README.md, CLAUDE.md, AGENTS.md for skills 33-34 Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
4.1 KiB
4.1 KiB
name, description
| name | description |
|---|---|
| seo-kpi-framework | SEO KPI and performance framework for unified metrics, health scores, ROI, and period-over-period reporting. Triggers: SEO KPI, performance report, health score, SEO metrics, ROI, baseline, targets, SEO 성과 지표, KPI 대시보드, SEO 성과 보고서. |
SEO KPI & Performance Framework
Purpose
Aggregate SEO KPIs across all dimensions into a unified dashboard. Establish baselines, set targets (30/60/90-day), generate executive summaries with health scores, provide tactical breakdowns, estimate ROI using Ahrefs traffic cost, and support period-over-period comparison (MoM, QoQ, YoY).
Core Capabilities
- KPI Aggregation - Unified metrics across 7 dimensions (traffic, rankings, links, technical, content, engagement, local)
- Health Scoring - Weighted 0-100 score with trend direction
- Baseline & Targets - Establish baselines and set 30/60/90 day growth targets
- ROI Estimation - Traffic value from Ahrefs organic cost
- Performance Reporting - Period-over-period comparison with executive summary
- Tactical Breakdown - Actionable next steps per dimension
MCP Tool Usage
Ahrefs for SEO Metrics
mcp__ahrefs__site-explorer-metrics: Current organic metrics snapshot
mcp__ahrefs__site-explorer-metrics-history: Historical trend data
mcp__ahrefs__site-explorer-metrics-by-country: Country-level breakdown
mcp__ahrefs__site-explorer-domain-rating-history: Domain rating trend
mcp__ahrefs__site-explorer-total-search-volume-history: Keyword volume trend
Notion for Report Storage
mcp__notion__*: Save reports to SEO Audit Log database
Workflow
1. KPI Aggregation
- Fetch site-explorer-metrics for current organic data
- Extract traffic, ranking, link, technical, content metrics
- Calculate dimension scores with weights (traffic 25%, rankings 20%, technical 20%, content 15%, links 15%, local 5%)
- Compute overall health score (0-100)
- Set 30/60/90 day targets (5%/10%/20% improvement)
- Estimate ROI from Ahrefs traffic cost (divide raw cost by 100 for USD)
2. Performance Reporting
- Determine date range from period (monthly/quarterly/yearly/custom)
- Fetch metrics-history for current and previous period
- Calculate period-over-period changes
- Identify wins (>5% improvement) and concerns (>5% decline)
- Generate executive summary with trend arrows
- Create tactical breakdown with actionable next steps
- Compare against targets if provided
Output Format
## SEO KPI Dashboard: [domain]
### Health Score: [score]/100 ([trend])
### KPI Summary
| Dimension | Score | Key Metric | Trend |
|-----------|-------|------------|-------|
| Traffic | [score] | [organic_traffic] | [arrow] |
| Rankings | [score] | [visibility] | [arrow] |
| Links | [score] | [DR] | [arrow] |
| Technical | [score] | [health] | [arrow] |
| Content | [score] | [indexed_pages] | [arrow] |
### Executive Summary
- Top Wins: [list]
- Top Concerns: [list]
- Recommendations: [list]
### Targets (30/60/90 day)
[Target table with progress bars]
Key Metrics
| Dimension | Metrics | Source |
|---|---|---|
| Traffic | Organic traffic, traffic value (USD) | site-explorer-metrics |
| Rankings | Visibility score, top10 keywords | site-explorer-metrics |
| Links | Domain rating, referring domains | domain-rating, metrics |
| Technical | Pages crawled, technical health | site-explorer-metrics |
| Content | Indexed pages, freshness score | site-explorer-metrics |
| Local | GBP visibility, review score | External data |
Limitations
- Local KPIs require external GBP data (not available via Ahrefs)
- Engagement KPIs (bounce rate, session duration) require Google Analytics
- Technical health is estimated heuristically from available data
- ROI is estimated from Ahrefs traffic cost, not actual revenue
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, Priority, Found Date, Audit ID
- Language: Korean with English technical terms
- Audit ID Format: KPI-YYYYMMDD-NNN