# 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