diff --git a/README.md b/README.md index 83db6a8..31ea6a4 100644 --- a/README.md +++ b/README.md @@ -2,9 +2,15 @@ Automatický denní digest systém pro Mastodon boty používající Claude AI. +## 📖 O projektu + +Automatizační nástavba pro [Zprávobot.news](https://github.com/DanielSnor/Zpravobot.news) od Daniela Snora. +Přidává AI-powered digest systém s Claude analýzou a automatickou kategorizací zpráv. + ## 🎯 Co to dělá Systém 3× denně: + 1. Načte včerejší posty z CSV exportu 2. Automaticky je kategorizuje podle témat (🌍 Politika, 🏒 Sport, 🎬 Kultura...) 3. Analyzuje pomocí Claude AI @@ -31,6 +37,7 @@ Systém 3× denně: ### 1. Připrav prostředí V Mastodon terminalu (Cloudron): + ```bash cd /app/data git clone https://gitea.vhsky.cz/user/zpravobot-digest.git @@ -38,6 +45,7 @@ cd zpravobot-digest ``` ### 2. Nainstaluj Ruby gem + ```bash export GEM_HOME=$HOME/.gem export PATH=$GEM_HOME/bin:$PATH @@ -45,17 +53,20 @@ gem install mastodon-api --user-install ``` Ověř instalaci: + ```bash ruby -e "require 'mastodon'; puts 'OK'" ``` ### 3. Konfigurace + ```bash cp config.env.example config.env nano config.env ``` Vyplň tokeny: + ```bash export ANTHROPIC_API_KEY="sk-ant-api03-..." export ZPRAVOBOT_TOKEN="token-zde" @@ -64,12 +75,14 @@ export SARKASTICKY_TOKEN="token-zde" ``` **Jak vytvořit Mastodon tokeny:** + 1. Přihlásit se jako bot účet 2. Settings → Development → New application 3. Scopes: `read:statuses` + `write:statuses` 4. Zkopírovat "Your access token" ### 4. Spustitelné práva + ```bash chmod +x export-daily.sh publish_digest.rb run-digest.sh chmod 600 config.env @@ -78,6 +91,7 @@ chmod 600 config.env ## 🧪 Testování ### Dry-run (bez publikace) + ```bash source config.env ./run-digest.sh zpravobot --dry-run @@ -86,6 +100,7 @@ source config.env ``` ### Live test (skutečná publikace) + ```bash ./run-digest.sh zpravobot ``` @@ -95,6 +110,7 @@ Zkontroluj na Mastodonu že se thread publikoval. ## ⏰ Automatizace (Cron) V Cloudron UI → Mastodon app → Cron tab: + ``` 0 6 * * * /app/data/zpravobot-digest/export-daily.sh 30 7 * * * /app/data/zpravobot-digest/run-digest.sh zpravobot @@ -103,12 +119,14 @@ V Cloudron UI → Mastodon app → Cron tab: ``` **Rozvrh:** + - 6:00 - Export postů z databáze - 7:30 - Neutrální digest (@zpravobot) - 12:00 - Pozitivní zprávy (@pozitivni) - 19:00 - Sarkastický komentář (@sarkasticky) ## 📁 Struktura souborů + ``` /app/data/ ├── zpravobot-digest/ @@ -127,6 +145,7 @@ V Cloudron UI → Mastodon app → Cron tab: ## 🔧 Ruční použití ### Publikovat digest + ```bash source config.env ./run-digest.sh zpravobot # Neutrální @@ -135,11 +154,13 @@ source config.env ``` ### Použít specifické datum + ```bash ./run-digest.sh zpravobot --date=2026-01-05 --dry-run ``` ### Export CSV + ```bash ./export-daily.sh ``` @@ -157,6 +178,7 @@ source config.env ## 📊 Monitoring ### Zkontrolovat dnešní běhy + ```bash # V logu exportu tail -50 /app/data/logs/export.log @@ -169,13 +191,15 @@ wc -l /app/data/posts-latest.csv ### Zkontrolovat publikace Navštiv: -- https://zpravobot.news/@zpravobot -- https://zpravobot.news/@pozitivni -- https://zpravobot.news/@sarkasticky + +- +- +- ## 🐛 Troubleshooting ### "CSV file not found" + ```bash # Ověř že export běžel ls -la /app/data/posts-latest.csv @@ -185,6 +209,7 @@ ls -la /app/data/posts-latest.csv ``` ### "Missing token" + ```bash # Ověř environment source config.env @@ -196,6 +221,7 @@ echo $ZPRAVOBOT_TOKEN Token vypršel nebo je neplatný. Vygeneruj nový v Mastodon → Settings → Development. ### Ruby gem chyba + ```bash # Reinstaluj gem export GEM_HOME=$HOME/.gem @@ -221,8 +247,9 @@ Open source - vytvořeno pro Zprávobot.news komunitu. ## 🙏 Credits -- **Zprávobot.news** - České/Slovenské Mastodon zpravodajství -- **Anthropic Claude** - AI analýza +- **Daniel Snor** - [Zprávobot.news](https://github.com/DanielSnor/Zpravobot.news) - Původní Mastodon instance a koncept +- **Zprávobot.news komunita** - České/Slovenské Mastodon zpravodajství +- **Anthropic Claude** - AI analýza a kategorizace - **Mastodon** - Decentralizovaná sociální síť ---