42 lines
1.2 KiB
Markdown
42 lines
1.2 KiB
Markdown
# 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
|