# SEO Reporting Dashboard

SEO 종합 보고서 및 대시보드 생성 도구 - 모든 SEO 스킬 결과를 집계하여 이해관계자용 보고서와 인터랙티브 HTML 대시보드를 생성합니다.

## Overview

Aggregates outputs from all SEO skills (11-33) into executive reports with interactive HTML dashboards, trend analysis, and Korean-language executive summaries. This is the PRESENTATION LAYER that sits on top of skill 25 (KPI Framework) and all other skill outputs.

## Relationship to Skill 25 (KPI Framework)

Skill 25 establishes KPI baselines, targets, and health scores for a single domain. Skill 34 builds on top of skill 25 by:
- Aggregating outputs from ALL SEO skills (not just KPIs)
- Generating visual HTML dashboards with Chart.js
- Producing audience-specific Korean executive summaries
- Providing cross-skill priority analysis

## Dual-Platform Structure

```
34-seo-reporting-dashboard/
├── code/                              # Claude Code version
│   ├── CLAUDE.md                      # Action-oriented directive
│   ├── commands/
│   │   └── seo-reporting-dashboard.md # Slash command
│   └── scripts/
│       ├── base_client.py             # Shared async utilities
│       ├── report_aggregator.py       # Collect + normalize skill outputs
│       ├── dashboard_generator.py     # HTML dashboard with Chart.js
│       ├── executive_report.py        # Korean executive summary
│       └── requirements.txt
│
├── desktop/                           # Claude Desktop version
│   ├── SKILL.md                       # MCP-based workflow
│   ├── skill.yaml                     # Extended metadata
│   └── tools/
│       ├── ahrefs.md                  # Ahrefs tool docs
│       └── notion.md                  # Notion tool docs
│
└── README.md
```

## Quick Start

### Claude Code
```bash
pip install -r code/scripts/requirements.txt

# Aggregate all skill outputs
python code/scripts/report_aggregator.py --domain https://example.com --json

# Generate HTML dashboard
python code/scripts/dashboard_generator.py --report report.json --output dashboard.html

# Generate Korean executive report
python code/scripts/executive_report.py --report report.json --audience c-level --output report.md
```

## Features

- Cross-skill report aggregation (skills 11-33)
- Interactive HTML dashboard with Chart.js charts
- Korean-language executive summaries
- Audience-specific reporting (C-level, marketing, technical)
- Notion integration for reading past audits and writing reports
- Mobile-responsive dashboard layout

## Requirements

- Python 3.10+
- Dependencies: `pip install -r code/scripts/requirements.txt`
- Notion API token (for database access)
- Ahrefs API token (for fresh data pull)

## Triggers

- SEO report, SEO dashboard, executive summary
- 보고서, 대시보드, 종합 보고서, 성과 보고서
- performance report, reporting dashboard
