---
name: seo-reporting-dashboard
description: |
  SEO reporting dashboard and executive report generation. Aggregates data from all SEO skills
  into stakeholder-ready reports and interactive HTML dashboards.
  Triggers: SEO report, SEO dashboard, executive summary, 보고서, 대시보드, performance report, 종합 보고서.
---

# SEO Reporting Dashboard

## Purpose

Aggregate outputs from all SEO skills (11-33) into stakeholder-ready executive reports with interactive HTML dashboards, trend analysis, and Korean-language summaries. This is the PRESENTATION LAYER that sits on top of skill 25 (KPI Framework) and all other skill outputs, providing a unified view of SEO performance across all audit dimensions.

## Core Capabilities

1. **Report Aggregation** - Collect and normalize outputs from all SEO skills (11-33) into a unified data structure with cross-skill health scoring and priority issue identification
2. **Interactive Dashboard** - Generate self-contained HTML dashboards with Chart.js visualizations including health gauge, traffic trends, keyword distribution, issue breakdown, and competitor radar
3. **Executive Reporting** - Korean-language executive summary generation with audience-specific detail levels (C-level, marketing team, technical team) and prioritized action items

## MCP Tool Usage

### SEO Data
```
our-seo-agent CLI: Primary data source (future); use --input for pre-fetched JSON
WebSearch / WebFetch: Supplementary live data
```

### Notion for Reading Past Audits and Writing Reports
```
mcp__notion__*: Query SEO Audit Log database for past audit entries
mcp__notion__*: Save dashboard reports and executive summaries to Notion
```

### Perplexity for Context
```
mcp__perplexity__*: Enrich reports with industry benchmarks and competitor context
```

## Workflow

### Dashboard Generation
1. Accept target domain and optional date range
2. Query Notion SEO Audit Log for all past audit entries for the domain
3. Optionally pull fresh metrics from our-seo-agent CLI or provide pre-fetched JSON via --input
4. Normalize all skill outputs into unified format
5. Compute cross-skill health score with weighted category dimensions
6. Identify top issues (sorted by severity) and top wins across all audits
7. Build audit history timeline
8. Generate HTML dashboard with Chart.js charts:
   - Health score gauge (doughnut)
   - Category scores horizontal bar chart
   - Health score timeline line chart
   - Issue distribution pie chart
   - Competitor radar chart (if competitor data available)
9. Save HTML file and optionally push summary to Notion

### Executive Reporting
1. Load aggregated report data (from dashboard generation or JSON file)
2. Select audience level: C-level, marketing, or technical
3. Generate Korean-language narrative with:
   - Health score overview and trend
   - Category highlights (strengths and weaknesses)
   - Skills coverage summary
   - Audience-specific business impact analysis
4. Format key wins and concerns with severity and category labels
5. Generate prioritized action items ranked by impact
6. Render as markdown document
7. Optionally push to Notion SEO Audit Log

## Output Format

### HTML Dashboard
```
Self-contained HTML file with:
- Responsive CSS grid layout
- Chart.js visualizations from CDN
- Health score gauge
- Category bar chart
- Timeline line chart
- Issues pie chart
- Competitor radar chart
- Issues and wins lists
- Audit history table
```

### Executive Report (Markdown)
```markdown
# SEO 성과 보고서 - [domain]

**대상**: 경영진 / 마케팅팀 / 기술팀
**도메인**: [domain]
**보고 일자**: [date]

## Health Score
| 지표 | 값 |
|------|-----|
| Overall Score | **[score]/100** |
| 등급 | [grade_kr] |
| 추세 | [trend_kr] |

## 종합 분석
[Korean narrative...]

## 주요 성과
- [wins...]

## 주요 이슈
- [concerns...]

## 권장 조치 사항
1. [recommendations...]
```

## Audience Configurations

| Audience | Detail | Issues | Recommendations | Technical Details |
|----------|--------|--------|------------------|-------------------|
| C-level (경영진) | Summary | Top 5 | Top 3 | No |
| Marketing (마케팅팀) | Moderate | Top 10 | Top 5 | No |
| Technical (기술팀) | Detailed | Top 20 | Top 10 | Yes |

## Limitations

- Aggregation depends on availability of JSON outputs from other skills
- Notion query for past audits requires MCP tools (placeholder in scripts)
- Competitor radar chart only renders if competitor intel (skill 31) data is present
- HTML dashboard requires internet access for Chart.js CDN

## Notion Output (Required)

All reports MUST be saved to OurDigital SEO Audit Log:
- **Database ID**: `2c8581e5-8a1e-8035-880b-e38cefc2f3ef`
- **Properties**: Issue (title), Site (url), Category ("SEO Dashboard"), Priority, Found Date, Audit ID
- **Language**: Korean with English technical terms
- **Audit ID Format**: DASH-YYYYMMDD-NNN
