docs: aktualizace README – nové funkce reportu
This commit is contained in:
@@ -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
|
||||||
|
|||||||
Reference in New Issue
Block a user