---
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/Projects/our-claude-skills/custom-skills/25-seo-kpi-framework/code/scripts/kpi_aggregator.py \
  --url https://example.com --json

# Set baseline
python /Users/ourdigital/Projects/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/Projects/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/Projects/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/Projects/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/Projects/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/Projects/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/Projects/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)