social-youtube-report
GitHub自动化生成YouTube频道分析报告,支持日/周/月维度。通过API获取数据并对比历史趋势,最终输出包含KPI、热门视频及评论情感的HTML报告。
Trigger Scenarios
Install
npx skills add evolution-foundation/evo-nexus --skill social-youtube-report -g -y
SKILL.md
Frontmatter
{
"name": "social-youtube-report",
"description": "YouTube analytics report — queries channel stats, recent videos, engagement rates, top content. Generates HTML report. Use when user says 'youtube report', 'youtube metrics', 'youtube analytics', or any reference to YouTube performance analysis. Supports daily, weekly, and monthly periods."
}
YouTube Report — Channel Analytics
Routine that pulls data from YouTube via /int-youtube and generates an HTML channel performance report.
Always respond in English.
Workflow
Step 1 — Determine period
Based on the command:
make youtube→ período "daily" (snapshot do dia)make youtube-weekly→ período "weekly" (últimos 7 dias)make youtube-monthly→ período "monthly" (últimos 30 dias)
If called directly, ask or use "daily" as default.
Step 2 — Collect data
For each configured YouTube account:
# Stats do canal
python3 {project-root}/.claude/skills/int-youtube/scripts/youtube_client.py channel_stats
# Últimos vídeos com métricas
python3 {project-root}/.claude/skills/int-youtube/scripts/youtube_client.py recent_videos 1 20
# Resumo de todas as contas
python3 {project-root}/.claude/skills/int-youtube/scripts/youtube_client.py summary
Step 3 — Compare with previous period
Read previous report from workspace/social/reports/youtube/ if it exists. Calculate deltas:
- Inscritos: delta absoluto e %
- Views total: delta
- Engagement rate médio: delta
- Vídeos publicados no período
Step 4 — Analyze
- Channel KPIs: subscribers, total views, average engagement rate
- Period videos: published, views, likes, comments
- Top video: best performance by engagement rate
- Trend: growing, stable, decelerating
- Recent comments: overall sentiment (if daily, pull comments from the most recent video)
Step 5 — Generate HTML
Use template .claude/templates/html/custom/social-analytics-report.html with {{REPORT_TYPE}} = "YouTube Daily/Weekly/Monthly".
If it is the only configured platform, adapt the template to focus on YouTube (do not show an empty cross-platform comparison table).
Step 6 — Save
workspace/social/reports/youtube/[C] YYYY-MM-DD-youtube-{period}.html
Criar diretório if it does not exist.
Version History
- 7f5dd76 Current 2026-07-25 04:59


