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