Update README mit agy und Signal-cli Details

This commit is contained in:
2026-07-07 13:15:22 +02:00
parent afa0fa0a02
commit 5f352634f0

View File

@@ -16,8 +16,8 @@ Ein automatisiertes Überwachungswerkzeug für Webseiten und Nachrichtenportale,
## 🛠 Technische Details
- **Sprache:** Python 3
- **Bibliotheken:** `cloudscraper`, `BeautifulSoup4`, `requests`
- **KI-Integration:** Gemini Pro via CLI
- **Bibliotheken:** `cloudscraper`, `BeautifulSoup4`, `requests`, `python-dotenv`
- **KI-Integration:** Google Antigravity CLI (`agy`) mit Modell `gemini-3.5-flash`
- **Datenhaltung:** SQLite (`polit_scraper.db`)
- **Konfiguration:** `urls.txt` (Ziel-URLs), `gemini_instructions.md` (KI-Regelwerk) und `.env` (Zugangsdaten & Einstellungen)
@@ -25,18 +25,27 @@ Ein automatisiertes Überwachungswerkzeug für Webseiten und Nachrichtenportale,
1. **Abhängigkeiten installieren:**
```bash
pip install cloudscraper beautifulsoup4 requests --break-system-packages
pip install cloudscraper beautifulsoup4 requests python-dotenv --break-system-packages
```
2. **Konfiguration (`.env`):**
Erstelle eine `.env`-Datei basierend auf `.env.example` und setze deine Zugangsdaten sowie `MAX_ANALYZER_WORKERS`.
3. **Ziele definieren:**
2. **Antigravity CLI (agy) & Pfad-Verlinkung:**
Installiere das `agy` CLI. Da die Worker-Hintergrundprozesse in einer eingeschränkten PATH-Umgebung laufen, muss zwingend ein globaler symbolischer Link angelegt werden:
```bash
ln -s /root/.local/bin/agy /usr/bin/agy
```
3. **Signal-Bot (Standalone-Client):**
Der Notifier sendet Benachrichtigungen über `signal-cli` (registriert z. B. als Standalone-Festnetznummer).
- Um Blockaden durch geänderte Sicherheitsnummern zu verhindern, ist in `notifier.py` das Flag `--trust-new-identities always` hinterlegt.
- Da `agy` OAuth-Tokens verschlüsselt speichern möchte, muss auf Headless-Servern ein D-Bus- und GNOME-Keyring-Dienst im Hintergrund laufen. Stelle sicher, dass die entsprechenden D-Bus-Umgebungsvariablen (wie `DBUS_SESSION_BUS_ADDRESS`) in der `.env` eingetragen sind.
4. **Konfiguration (`.env`):**
Erstelle eine `.env`-Datei basierend auf `.env.example` und setze deine Zugangsdaten (ntfy, Signal-Empfänger, D-Bus) sowie `MAX_ANALYZER_WORKERS`.
5. **Ziele definieren:**
URLs in die `urls.txt` eintragen (eine pro Zeile).
4. **Starten:**
6. **Starten:**
Der `crawler.py` steuert automatisch die Analyzer-Worker und den Notifier:
```bash
python3 crawler.py
```
5. **Überwachung:**
7. **Überwachung:**
Nutze den Live-Monitor für den Status der Abarbeitung:
```bash
python3 monitor.py