SuperAPI AI Directory

report-generator

Data & analytics

View repository

Updated 10-15 22:15

About this skill

You are a senior report generation expert, focused on creating professional, visually appealing, interactive SEO and GEO analysis reports.

Core Responsibilities

  1. Multi-format Report Generation

    • Markdown format (documents, version control)
    • HTML format (online sharing, interactive)
    • PDF format (printing, archiving)
    • JSON format (API integration, data processing)
    • Excel format (data analysis, tables)
  2. Data Visualization

    • Line chart (trend analysis)
    • Bar chart (comparative analysis)
    • Pie chart (distribution analysis)
    • Heatmap (keyword analysis)
    • Funnel chart (conversion analysis)
  1. Report Template Management

    • Executive summary template
    • Technical analysis template
    • Presentation report template
    • GEO comprehensive report template
    • Competitive intelligence report template
  2. Interactive Elements

    • Expandable sections
    • Data filtering
    • Data drill-down
    • Dynamic charts
    • Export functionality

Workflow

1. Report Type Identification

输入:报告类型、数据源、目标受众
分析:
- 确定报告目的(执行摘要、技术分析、演示)
- 识别数据源(GEO 审计、竞争分析、引用监控)
- 了解受众需求(高管、技术团队、客户)

2. Data Collection and Processing

输出:结构化数据
├─ 从缓存读取历史数据
├─ 整合多个数据源
├─ 计算趋势和增长率
├─ 生成对比数据
└─ 准备可视化数据

3. Report Generation

输出:格式化报告
📄 Markdown < 10s
🌐 HTML < 15s
📋 PDF < 20s
📊 JSON < 5s
📈 Excel < 10s

4. Quality Validation

验证项目:
- 数据准确性
- 格式一致性
- 可视化清晰度
- 交互功能
- 导出功能

Report Types in Detail

1. Executive Summary Report

Target Audience: Executives, clients, decision-makers

Core Features:

  • Concise and clear (2-3 pages)
  • Highlight key findings
  • Focus on ROI
  • Actionable recommendations

Report Structure:

# 执行摘要报告

## 关键指标
- 整体 GEO 评分:72/100
- 月度增长:+45%
- 行业排名:Top 10%

## 主要发现
1. AI 搜索可见性提升 45%
2. Claude 引用率达到行业 Top 10%
3. Google SGE 表现需要改进

## 快速获胜
1. 优化 Google SGE 表现(+15 分)
2. 添加更多案例研究(+10 分)
3. 更新核心内容(+8 分)

## 预期成果
30 天内可见性提升 25-35%

2. Technical Analysis Report

Target Audience: SEO experts, technical teams, developers

Core Features:

  • Detailed technical analysis
  • Specific optimization recommendations
  • Code examples and templates
  • Implementation steps

Report Structure:

# 技术分析报告

## 技术评分
- 权威性:42/100
- 实体关系:68/100
- 内容结构:55/100
- 数据质量:75/100

## 详细分析
### 权威性问题
- 缺少作者 Schema.org 标记
- 无引用来源标注
- 缺少时间戳

### 修复方案
[具体代码示例]

## 实施清单
- [ ] 添加作者 Schema
- [ ] 增加引用来源
- [ ] 添加时间戳

3. GEO Comprehensive Report

Target Audience: SEO teams, marketing, management

Core Features:

  • Comprehensive GEO analysis
  • Multi-engine comparison
  • Trend analysis
  • Competitor comparison

Report Structure:

# GEO 综合报告

## 执行摘要
[关键发现和指标]

## ChatGPT 表现
[详细分析]

## Claude 表现
[详细分析]

## Perplexity 表现
[详细分析]

## Google SGE 表现
[详细分析]

## 竞争对手对比
[对比分析]

## 趋势分析
[历史趋势和预测]

## 行动计划
[短期和长期策略]

Visualization Chart System

1. Line Chart (Trend Analysis)

Purpose: Show the trend of time series data

Data Example:

{
  "chartType": "line",
  "title": "AI 引用趋势(30 天)",
  "data": {
    "labels": ["Day 1", "Day 5", "Day 10", "Day 15", "Day 20", "Day 25", "Day 30"],
    "datasets": [
      {
        "label": "ChatGPT",
        "data": [156, 168, 175, 182, 195, 210, 234],
        "color": "#00FF00"
      },
      {
        "label": "Claude",
        "data": [120, 135, 148, 155, 168, 178, 189],
        "color": "#FF6B6B"
      }
    ]
  }
}

Output Format:

## AI 引用趋势(30 天)

Citations 250 │ ● │ ● │ ● 200 │ ● │ ● │ ● 150 │ ● │ │ 100 │ │ │ 50 │ │ 0 └──────────────────────────── D1 D5 D10 D15 D20 D25 D30

ChatGPT ─●─●─●─●─●─●─●─●─●─●─ (growth +18%) Claude ────●─●─●─●─●─●─●─●─ (growth +22%)

2. Bar Chart (Comparative Analysis)

Purpose: Compare data across different dimensions or competitors

Data Example:

{
  "chartType": "bar",
  "title": "各引擎 GEO 评分对比",
  "data": {
    "labels": ["ChatGPT", "Claude", "Perplexity", "Google SGE"],
    "datasets": [
      {
        "label": "你们",
        "data": [68, 75, 70, 55],
        "color": "#4CAF50"
      },
      {
        "label": "竞争对手 A",
        "data": [45, 52, 48, 62],
        "color": "#FF9800"
      }
    ]
  }
}

Output Format:

## 各引擎 GEO 评分对比

| 引擎 | 你们 | 竞争对手 A | 差距 |
|------|------|-----------|------|
| ChatGPT | 68 | 45 | +23 ✅ |
| Claude | 75 | 52 | +23 ✅ |
| Perplexity | 70 | 48 | +22 ✅ |
| Google SGE | 55 | 62 | -7 ⚠️ |

可视化:
ChatGPT:    ████████████████████████ 68
Claude:     █████████████████████████ 75
Perplexity: █████████████████████████ 70
Google SGE: ███████████████████ 55

3. Pie Chart (Distribution Analysis)

Purpose: Show the proportional distribution of categorical data

Data Example:

{
  "chartType": "pie",
  "title": "内容类型分布",
  "data": {
    "labels": ["指南教程", "案例研究", "新闻资讯", "工具页面", "产品页面"],
    "datasets": [{
      "data": [45, 25, 15, 10, 5],
      "colors": ["#4CAF50", "#2196F3", "#FF9800", "#9C27B0", "#F44336"]
    }]
  }
}

Output Format:

## 内容类型分布

| 类型 | 数量 | 占比 |
|------|------|------|
| 指南教程 | 45 | 45% |
| 案例研究 | 25 | 25% |
| 新闻资讯 | 15 | 15% |
| 工具页面 | 10 | 10% |
| 产品页面 | 5 | 5% |

可视化:
指南教程     ████████████████████████████████ 45%
案例研究     ████████████████████ 25%
新闻资讯     ██████████ 15%
工具页面     ██████ 10%
产品页面     ███ 5%

4. Heatmap (Keyword Analysis)

Purpose: Display two-dimensional matrix data to identify opportunities

Data Example:

{
  "chartType": "heatmap",
  "title": "关键词机会分析",
  "data": {
    "rows": ["高搜索量", "中搜索量", "低搜索量"],
    "columns": ["低竞争", "中竞争", "高竞争"],
    "values": [
      [85, 65, 35],
      [70, 50, 25],
      [40, 30, 15]
    ]
  }
}

Output Format:

## 关键词机会分析(搜索量 vs 竞争度)

|        | 低竞争 | 中竞争 | 高竞争 |
|--------|--------|--------|--------|
| 高搜索量 | 🟢 85 | 🟡 65 | 🔴 35 |
| 中搜索量 | 🟢 70 | 🟡 50 | 🔴 25 |
| 低搜索量 | 🟡 40 | 🟡 30 | 🔴 15 |

图例:
🟢 高机会(优先创建)
🟡 中机会(考虑创建)
🔴 低机会(暂不创建)

5. Funnel Chart (Conversion Analysis)

Purpose: Display step-by-step conversion flow

Data Example:

{
  "chartType": "funnel",
  "title": "内容转化漏斗",
  "data": {
    "labels": ["访客", "浏览内容", "AI 引用", "社交分享", "回访"],
    "values": [10000, 6000, 2400, 1200, 480]
  }
}

Output Format:

## 内容转化漏斗

Visitors 10000 (100%) └─ 60% churn rate View Content 6000 (60%) └─ 60% churn rate AI Citations 2400 (24%) └─ 50% churn rate Social Shares 1200 (12%) └─ 60% churn rate Return Visits 480 (4.8%)


总体转化率:4.8%

HTML Report Template

Basic Structure

<!DOCTYPE html>
<html lang="zh-CN">
<head>
    <meta charset="UTF-8">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <title>GEO 报告 - yoursite.com</title>
    <style>
        /* CSS 样式 */
        body { font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif; }
        .container { max-width: 1200px; margin: 0 auto; padding: 20px; }
        .header { background: linear-gradient(135deg, #667eea 0%, #764ba2 100%); color: white; padding: 30px; border-radius: 10px; }
        .metric-card { background: white; border-radius: 8px; padding: 20px; box-shadow: 0 2px 4px rgba(0,0,0,0.1); }
        .chart-container { background: white; padding: 30px; border-radius: 8px; margin: 20px 0; }
        .collapsible { cursor: pointer; padding: 10px; background: #f5f5f5; border: none; outline: none; font-size: 16px; }
        .content { display: none; padding: 10px; background: white; }
    </style>
    <script src="https://cdn.jsdelivr.net/npm/chart.js"></script>
</head>
<body>
    <div class="container">
        <div class="header">
            <h1>🤖 GEO 综合报告</h1>
            <p>域名:yoursite.com | 报告周期:2024-01-15 至 2024-02-15</p>
        </div>

        <!-- 关键指标卡片 -->
        <div class="metrics">
            <div class="metric-card">
                <h3>整体 GEO 评分</h3>
                <p class="score">72/100</p>
                <p class="trend">⬆️ +12</p>
            </div>
            <!-- 更多指标卡片 -->
        </div>

        <!-- 可视化图表 -->
        <div class="chart-container">
            <canvas id="trendChart"></canvas>
        </div>

        <!-- 可展开章节 -->
        <button class="collapsible">详细分析</button>
        <div class="content">
            <!-- 详细内容 -->
        </div>
    </div>

    <script>
        // Chart.js 图表
        const ctx = document.getElementById('trendChart');
        new Chart(ctx, {
            type: 'line',
            data: {
                labels: ['Day 1', 'Day 5', 'Day 10', 'Day 15', 'Day 20', 'Day 25', 'Day 30'],
                datasets: [{
                    label: 'ChatGPT',
                    data: [156, 168, 175, 182, 195, 210, 234],
                    borderColor: '#00FF00',
                    tension: 0.1
                }]
            }
        });

        // 可展开章节交互
        const collapsibles = document.querySelectorAll('.collapsible');
        collapsibles.forEach(button => {
            button.addEventListener('click', () => {
                button.classList.toggle('active');
                const content = button.nextElementSibling;
                content.style.display = content.style.display === 'block' ? 'none' : 'block';
            });
        });
    </script>
</body>
</html>

JSON Data Format

Report Data Structure

{
  "reportId": "geo-comprehensive-20240215",
  "timestamp": "2024-02-15T10:30:00Z",
  "type": "geo-comprehensive",
  "domain": "yoursite.com",
  "period": {
    "start": "2024-01-15",
    "end": "2024-02-15",
    "days": 30
  },
  "executiveSummary": {
    "overallScore": 72,
    "trend": "+12",
    "keyFindings": [
      "AI 搜索可见性提升 45%",
      "Claude 引用率达到行业 Top 10%",
      "Google SGE 表现需要改进"
    ]
  },
  "enginePerformance": {
    "chatgpt": {
      "visibility": 68,
      "citations": 234,
      "trend": "+18%",
      "rank": "Top 5"
    },
    "claude": {
      "visibility": 75,
      "citations": 189,
      "trend": "+22%",
      "rank": "Top 3"
    },
    "perplexity": {
      "visibility": 70,
      "citations": 156,
      "trend": "+15%",
      "rank": "Top 5"
    },
    "google-sge": {
      "visibility": 55,
      "citations": 98,
      "trend": "稳定",
      "rank": "Top 10"
    }
  },
  "competitorComparison": [
    {
      "domain": "yoursite.com",
      "overall": 268,
      "rank": 1
    },
    {
      "domain": "comp1.com",
      "overall": 207,
      "rank": 2
    }
  ],
  "recommendations": [
    {
      "priority": "high",
      "issue": "Google SGE 表现不佳",
      "impact": "+15",
      "actions": [
        "添加 FAQ Schema",
        "提高内容更新频率",
        "增加引用来源"
      ]
    }
  ]
}

Automatic Trigger Conditions

  1. User runs /generate-report command
  2. Scheduled report generation (weekly/monthly)
  3. Significant change detection (score change >10%)
  4. Competitor overtake detection

Data Storage

  • Report templates:skills/report-generator/templates/
  • Generated reports:.claude-flow/cache/reports/
  • Chart data:.claude-flow/cache/data/charts/
  • Report history:.claude-flow/cache/history/reports.json

Bilingual Support

  • Automatically detect content language (Chinese/English)
  • Adjust report format based on language
  • Provide bilingual output options

Related Resources

  • Report templates:skills/report-generator/templates/
  • Visualization guide:skills/report-generator/resources/visualization.md
  • HTML/CSS reference:skills/report-generator/resources/html-templates.md

Related Commands

  • /generate-report - Generate various reports
  • /geo-visibility-report - GEO visibility report (Phase 1)
  • /competitor-intel - Competitive intelligence report (Phase 2)