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

Fix SEO skill 34 bugs, Korean labels, and transition Ahrefs refs to our-seo-agent (#2)

Browse Source
This commit is contained in:
Andrew Yim
2026-02-14 01:09:35 +09:00
committed by GitHub
parent d2d0a2d460
commit a28bfbf847
34 changed files with 265 additions and 262 deletions
Download Patch File Download Diff File Expand all files Collapse all files

20
custom-skills/25-seo-kpi-framework/code/CLAUDE.md
View File

@@ -2,7 +2,7 @@
## Overview
SEO KPI and performance framework for unified metrics aggregation across all SEO dimensions. Establishes baselines, sets targets (30/60/90-day), generates executive summaries with health scores, provides tactical breakdowns, estimates ROI using Ahrefs traffic cost, and supports period-over-period comparison (MoM, QoQ).
SEO KPI and performance framework for unified metrics aggregation across all SEO dimensions. Establishes baselines, sets targets (30/60/90-day), generates executive summaries with health scores, provides tactical breakdowns, estimates ROI using our-seo-agent traffic cost data, and supports period-over-period comparison (MoM, QoQ).
## Quick Start
@@ -49,10 +49,10 @@ python scripts/kpi_aggregator.py --url https://example.com --roi --json
- Content KPIs (indexed pages, content freshness score, thin content ratio)
- Link KPIs (domain rating, referring domains, link velocity)
- Local KPIs (GBP visibility, review score, citation accuracy)
- Multi-source data aggregation from Ahrefs and other skill outputs
- Multi-source data aggregation from our-seo-agent CLI and other skill outputs
- Baseline establishment and target setting (30/60/90 day)
- Overall health score (0-100) with weighted dimensions
- ROI estimation using Ahrefs organic traffic cost
- ROI estimation using organic traffic cost data
## Performance Reporter
@@ -79,15 +79,13 @@ python scripts/performance_reporter.py --url https://example.com --period monthl
- Target vs actual comparison with progress %
- Traffic value change (ROI proxy)
## Ahrefs MCP Tools Used
## Data Sources
| Tool | Purpose |
|------|---------|
| `site-explorer-metrics` | Current organic metrics |
| `site-explorer-metrics-history` | Historical metrics trends |
| `site-explorer-metrics-by-country` | Country-level breakdown |
| `site-explorer-domain-rating-history` | DR trend over time |
| `site-explorer-total-search-volume-history` | Total keyword volume trend |
| Source | Purpose |
|--------|---------|
| `our-seo-agent` CLI | Primary data source (future); use `--input` for pre-fetched JSON |
| WebSearch / WebFetch | Supplementary live data |
| Notion MCP | Save audit report to database |
## Output Format

19
custom-skills/25-seo-kpi-framework/desktop/SKILL.md
View File

@@ -10,26 +10,23 @@ description: |
## 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).
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 our-seo-agent traffic cost data, and support period-over-period comparison (MoM, QoQ, YoY).
## Core Capabilities
1. **KPI Aggregation** - Unified metrics across 7 dimensions (traffic, rankings, links, technical, content, engagement, local)
2. **Health Scoring** - Weighted 0-100 score with trend direction
3. **Baseline & Targets** - Establish baselines and set 30/60/90 day growth targets
4. **ROI Estimation** - Traffic value from Ahrefs organic cost
4. **ROI Estimation** - Traffic value from organic cost data
5. **Performance Reporting** - Period-over-period comparison with executive summary
6. **Tactical Breakdown** - Actionable next steps per dimension
## MCP Tool Usage
### Ahrefs for SEO Metrics
### SEO Data
```
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
our-seo-agent CLI: Primary metrics source (future); use --input for pre-fetched JSON
WebSearch / WebFetch: Supplementary metrics data
```
### Notion for Report Storage
@@ -45,7 +42,7 @@ mcp__notion__*: Save reports to SEO Audit Log database
3. Calculate dimension scores with weights (traffic 25%, rankings 20%, technical 20%, content 15%, links 15%, local 5%)
4. Compute overall health score (0-100)
5. Set 30/60/90 day targets (5%/10%/20% improvement)
6. Estimate ROI from Ahrefs traffic cost (divide raw cost by 100 for USD)
6. Estimate ROI from traffic cost data (use our-seo-agent CLI or pre-fetched JSON)
### 2. Performance Reporting
1. Determine date range from period (monthly/quarterly/yearly/custom)
@@ -94,10 +91,10 @@ mcp__notion__*: Save reports to SEO Audit Log database
## Limitations
- Local KPIs require external GBP data (not available via Ahrefs)
- Local KPIs require external GBP data (not available via our-seo-agent)
- 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
- ROI is estimated from organic traffic cost data, not actual revenue
## Notion Output (Required)