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

description

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

# 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)