Měsíční statistiky Mamutovo.cz – bot který tootuje přehled aktivity instance.
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
2026-07-13 21:52:59 +02:00
.gitignore chore: ignore __pycache__ 2026-06-15 19:11:52 +02:00
CHANGELOG.md docs: CHANGELOG v1.0.0 2026-06-15 19:23:36 +02:00
daily_top.py feat: nejdiskutovanější toot podle počtu odpovědí 2026-06-20 07:03:49 +02:00
README.md docs: aktualizace README – nové funkce reportu 2026-06-20 07:14:36 +02:00
weekly_report.py fix: aktualizace počtů interakcí před sestavením reportu 2026-07-13 21:52:59 +02:00

mamutovo-stats-bot

Statistický bot pro Mamutovo.cz. Tootuje týdenní a měsíční přehledy aktivity instance z účtu @novinky@mamutovo.cz.

Co tootuje

  • Počet nových a aktivních uživatelů
  • Počet interakcí a tootů za období
  • Sdílená média (fotky, videa)
  • Nejaktivnější hodina dne
  • Populární hashtagy
  • Top tooty období (podle boostů + oblíbených)
  • Top odkazy období
  • Nejdiskutovanější toot
  • Top přispěvatel
  • Nový účet
  • Porovnání s předchozím obdobím
  • Tip týdne (rotující seznam)

Soubory

  • daily_top.py – denní sběr dat z timeline (cron denně)
  • weekly_report.py – generuje a posílá report (cron týdně/měsíčně)
  • data/*.json – denní data, mazána po 60 dnech

Jak funguje

Python 3, pouze standardní knihovny. daily_top.py běží denně a ukládá data do data/. weekly_report.py sestaví report z nasbíraných dat a pošle ho na @novinky.

Režimy weekly_report.py

  • výchozí – týdenní přehled
  • --monthly – měsíční přehled
  • --dry-run – jen vypíše, neodešle

Požadavky

  • Python 3.9+ (kvůli zoneinfo)
  • .env s proměnnými: NOVINKY_TOKEN, STATS_TOKEN, INSTANCE_URL

Nasazení

Server: archos@VPS Cesta: /opt/mamutovo-stats-bot/

Licence

MIT