Files
our-claude-skills/.claude/commands/seo-kpi-framework.md

64 lines
2.7 KiB
Markdown

---
description: SEO KPI framework - unified metrics, health scores, ROI estimation
---
# SEO KPI Framework
Unified KPI aggregation across all SEO dimensions with health scores, baselines, and ROI estimation.
## Triggers
- "SEO KPI", "SEO performance", "health score", "SEO ROI"
## Capabilities
1. **KPI Aggregation** - Unified metrics across 7 dimensions (traffic, rankings, engagement, technical, content, links, local)
2. **Health Score** - Weighted 0-100 score with trend indicators
3. **Baseline & Targets** - Establish baselines and set 30/60/90-day targets
4. **Performance Reporting** - Period-over-period comparison (MoM, QoQ, YoY)
5. **Executive Summary** - Top wins, concerns, and recommendations
6. **ROI Estimation** - Organic traffic cost valuation
## Scripts
```bash
# Aggregate KPIs
python /Users/ourdigital/Project/our-claude-skills/custom-skills/25-seo-kpi-framework/code/scripts/kpi_aggregator.py \
--url https://example.com --json
# Set baseline
python /Users/ourdigital/Project/our-claude-skills/custom-skills/25-seo-kpi-framework/code/scripts/kpi_aggregator.py \
--url https://example.com --set-baseline --json
# Compare against baseline
python /Users/ourdigital/Project/our-claude-skills/custom-skills/25-seo-kpi-framework/code/scripts/kpi_aggregator.py \
--url https://example.com --baseline baseline.json --json
# With ROI estimation
python /Users/ourdigital/Project/our-claude-skills/custom-skills/25-seo-kpi-framework/code/scripts/kpi_aggregator.py \
--url https://example.com --roi --json
# Monthly performance report
python /Users/ourdigital/Project/our-claude-skills/custom-skills/25-seo-kpi-framework/code/scripts/performance_reporter.py \
--url https://example.com --period monthly --json
# Quarterly report
python /Users/ourdigital/Project/our-claude-skills/custom-skills/25-seo-kpi-framework/code/scripts/performance_reporter.py \
--url https://example.com --period quarterly --json
# Custom date range
python /Users/ourdigital/Project/our-claude-skills/custom-skills/25-seo-kpi-framework/code/scripts/performance_reporter.py \
--url https://example.com --from 2025-01-01 --to 2025-03-31 --json
# Executive summary only
python /Users/ourdigital/Project/our-claude-skills/custom-skills/25-seo-kpi-framework/code/scripts/performance_reporter.py \
--url https://example.com --period monthly --executive --json
```
## Output
- Unified KPI dashboard with health score (0-100)
- 7-dimension breakdown (traffic, rankings, engagement, technical, content, links, local)
- Trend indicators (up/down/stable) per dimension
- 30/60/90-day targets with progress tracking
- Executive summary with top wins and concerns
- Reports saved to Notion SEO Audit Log (Category: SEO KPI & Performance)