137 lines
4.8 KiB
Markdown
137 lines
4.8 KiB
Markdown
---
|
|
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
|