docs: aktualizace README – nové funkce reportu

This commit is contained in:
2026-06-20 07:14:36 +02:00
parent ab3833f5a2
commit 30b0bfbf37
+29 -14
View File
@@ -1,26 +1,41 @@
# mamutovo-stats-bot # mamutovo-stats-bot
Týdenní statistiky Mamutovo.cz bot tootuje každé pondělí přehled aktivity instance z účtu [@novinky@mamutovo.cz](https://mamutovo.cz/@novinky). Statistický bot pro Mamutovo.cz. Tootuje týdenní a měsíční přehledy aktivity instance z účtu @novinky@mamutovo.cz.
## Co tootuje ## Co tootuje
- Počet nových a aktivních uživatelů
- Počet nových uživatelů za týden - Počet interakcí a tootů za období
- Počet aktivních uživatelů - Sdílená média (fotky, videa)
- Počet tootů za týden - Nejaktivnější hodina dne
- Top hashtagy - 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) - Tip týdne (rotující seznam)
## Jak funguje ## 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
Python skript spouštěný cronem každé pondělí v 9:00. Používá Mastodon admin API. ## 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 ## Požadavky
- Python 3.9+ (kvůli zoneinfo)
- Python 3 - .env s proměnnými: NOVINKY_TOKEN, STATS_TOKEN, INSTANCE_URL
- Admin token pro mamutovo.cz
- Proměnná prostředí `NOVINKY_TOKEN` v souboru `.env`
## Nasazení ## Nasazení
Server: archos@VPS
Cesta: /opt/mamutovo-stats-bot/
Server: `archos@VPS server` ## Licence
Cesta: `/opt/mamutovo-stats-bot/` MIT