Analytics
Статистика Telegram-канала и YouTube. Просмотры, подписчики, ERR, топ постов/видео.From its SKILL.md
npx -y skills add AlekseiUL/sprut-agent-kit --skill analyticsAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
2 things to look at
- reads credentialsReads from 3 credential sources: `~/.openclaw/tg-stats-session` and 2 more.
- runs commandsInstructs the agent to run 8 commands, including `python3 skills/analytics/scripts/tg-stats.py --period=7d` and 7 more.
SKILL.md
3.6 KB, 914 tokens by cl100k_base, as published. Nobody here has run it
Analytics - Статистика каналов
Возможности
Telegram (YOUR_CHANNEL)
- Подписчики (точное число)
- Просмотры, репосты, реакции каждого поста
- ERR (Engagement Rate by Reactions)
- Топ постов за период
- Фильтр по периоду: 24h, 7d, 30d
YouTube (YOUR_YOUTUBE_HANDLE)
- Просмотры, лайки по каждому видео (RSS, бесплатно)
- С API-ключом: подписчики, комментарии, полная стата
Скрипты
Telegram
# Полная статистика за 7 дней
python3 skills/analytics/scripts/tg-stats.py --period=7d
# За сутки
python3 skills/analytics/scripts/tg-stats.py --period=24h
# За месяц, топ-10
python3 skills/analytics/scripts/tg-stats.py --period=30d --top=10
# JSON формат (для парсинга)
python3 skills/analytics/scripts/tg-stats.py --period=7d --json
YouTube (RSS - быстрый)
python3 skills/analytics/scripts/yt-stats.py
python3 skills/analytics/scripts/yt-stats.py --json
YouTube (Analytics API - полная стата)
# За 30 дней (по умолчанию)
python3 skills/analytics/scripts/yt-deep-stats.py
# За 7 дней
python3 skills/analytics/scripts/yt-deep-stats.py --days=7
# JSON
python3 skills/analytics/scripts/yt-deep-stats.py --days=30 --json
Глубокая аналитика: подписчики gained/lost, watch time, avg view duration, источники трафика, топ видео с удержанием.
Настройка
Telegram (готово ✅)
- Авторизация: Telethon session в
~/.openclaw/tg-stats-session - Скрипт авторизации:
scripts/tg-stats-auth.py - API ID: задайте через TG_API_ID env
- Канал: YOUR_CHANNEL (ID: -1002484275132)
YouTube (готово ✅)
- OAuth2 токен:
~/.openclaw/yt-analytics-token.pickle - Скрипт авторизации:
scripts/yt-analytics-auth.py - Channel ID: YOUR_CHANNEL_ID
- Google OAuth client: тот же что для gog (calendar)
Безопасность
- Все данные read-only
- Telethon session локально на local server
- Никакие данные не отправляются наружу
- Бот в канале с минимальными правами (только can_post_messages)
🔗 Связанные скиллы
| Скилл | Связь |
|---|---|
creator-marketing | Маркетолог использует данные analytics для рекомендаций по контенту |
copywriter | Смотрит какие посты лучше заходят перед написанием новых |
youtube-seo | Оптимизирует SEO на основе реальных данных (источники трафика, топ видео) |
Примеры использования
- "покажи статистику Telegram за неделю"
- "топ постов за месяц"
- "статистика YouTube"
- "сравни просмотры за эту и прошлую неделю"
- "какой пост лучше всего зашёл?"
What ships with it: 7 files
22.3 KB alongside SKILL.md, 7 of them executable
scripts/
- daily-report.shruns262 B
- tg-channel-stats.pyruns3.4 KB
- tg-stats-auth.pyruns593 B
- tg-stats.pyruns4.1 KB
- yt-analytics-auth.pyruns1.2 KB
- yt-deep-stats.pyruns6.5 KB
- yt-stats.pyruns6.3 KB