Skool Scout
Open Source · Self-hosted

Community Intelligence für Skool

Skool Scout durchsucht automatisch deine Skool Communities, filtert die spannendsten Diskussionen und schickt dir einen kuratierten Report per Telegram. Optional mit fertigem LinkedIn-Entwurf.

Hier ZIP herunterladen Anleitung lesen →

Was es kann

Auto-Scraping

Liest deine Skool Communities einmal täglich automatisch aus. Keine manuelle Arbeit.

Telegram-Report

Neue Posts, Keyword-Treffer und Top-Themen kommen direkt ins Handy.

LinkedIn-Entwürfe

Mit OpenClaw bekommst du fertige Posts aus den Top-Themen — direkt einsetzbar.

Lokal & privat

Läuft auf deinem Rechner oder VPS. Keine Cloud, keine Tracker, keine Drittanbieter.

Voraussetzungen

Installation in 5 Schritten

Die Schritte gehen davon aus, dass du ein Terminal (macOS: Terminal.app, Windows: PowerShell oder WSL) offen hast.

1

Telegram Bot anlegen

~3 Minuten
  1. Telegram öffnen und nach @BotFather suchen (offizieller Bot, blaues Häkchen).
  2. Im Chat /newbot schicken.
  3. Einen Namen wählen — z.B. Mein Skool Scout.
  4. Einen Username wählen — muss auf _bot enden, z.B. mein_skool_scout_bot.
  5. BotFather schickt dir einen Token. Sieht so aus: 7123456789:AAFxyz… — diesen kopieren und sicher aufbewahren.
  6. Wichtig: Deinen neuen Bot in Telegram suchen, öffnen und /start schicken — sonst kann er dir später keine Nachrichten senden.
Tipp: Schreibe dir den Token kurz in eine Notiz. Du brauchst ihn in Schritt 4.
2

Tool herunterladen und entpacken

~1 Minute

Lade das ZIP herunter und entpacke es an einem Ort, an dem das Tool dauerhaft liegen soll — z.B. in deinem Home-Verzeichnis als Ordner skool-scout.

skool-scout.zip

Im Terminal in den Ordner wechseln:

cd ~/skool-scout
3

Abhängigkeiten installieren

~2 Minuten

Python-Pakete und den benötigten Browser für das Scraping installieren:

pip3 install -r requirements.txt
python3 -m playwright install chromium
Linux/VPS: Falls beim ersten Start eine Fehlermeldung zu fehlenden System-Bibliotheken erscheint, zusätzlich ausführen:
python3 -m playwright install-deps chromium
4

Setup-Wizard ausführen

~5 Minuten

Der Wizard fragt dich Schritt für Schritt durch — Communities, Bot-Token, Keywords:

python3 skool_setup.py

Du wirst gefragt nach:

  • Skool Community URLs (z.B. https://www.skool.com/ki-lounge) — du kannst beliebig viele eintragen, leere Eingabe beendet die Liste.
  • Bot-Token aus Schritt 1.
  • Chat-ID — wird automatisch erkannt, sobald du dem Bot einmal /start geschickt hast.
  • Keywords — Standard-Set übernehmen oder eigene eingeben.
  • Filter-Werte — Defaults reichen meistens (Enter drücken).

Am Ende öffnet sich ein Browser-Fenster — dort einmal in Skool einloggen. Der Wizard speichert die Session automatisch und legt auf macOS einen Doppelklick-Shortcut auf den Desktop.

5

Scout starten

~2 Minuten

Vor dem ersten echten Run kurz die Telegram-Verbindung testen:

python3 skool_scout.py --test-telegram --config skool_config.json

Wenn die Test-Nachricht ankommt, kann der Scout starten:

python3 skool_scout.py --config skool_config.json

Das dauert je nach Anzahl der Communities 60–120 Sekunden. Danach sollte der Report in Telegram erscheinen.

Geschafft. Den Befehl aus Schritt 5 jeden Morgen ausführen — oder weiter zu Schritt 6 für Automatik.

Optional: Täglich automatisch ausführen

Damit der Scout jeden Morgen automatisch läuft, kannst du einen Cron-Job einrichten.

crontab -e

Folgende Zeile am Ende der Datei einfügen (Pfade an dein System anpassen):

# Skool Scout — täglich 07:30 Uhr
30 7 * * * /usr/bin/python3 /Users/DEIN-NAME/skool-scout/skool_scout.py --config /Users/DEIN-NAME/skool-scout/skool_config.json >> /Users/DEIN-NAME/skool-scout/skool_scout.log 2>&1
Hinweis: Der Mac muss zur eingestellten Zeit eingeschaltet sein. Für eine wirklich zuverlässige Automatik: den Scout auf einem VPS einrichten — das Tool läuft dort genauso (Linux-kompatibel).

Mit OpenClaw nutzen

Wenn du OpenClaw als persönlichen KI-Assistenten nutzt, kannst du den Scout direkt aus dem Chat heraus starten — inklusive automatischer Top-3-Auswahl und LinkedIn-Entwurf.

  1. Die Datei skool-scout.md aus dem ZIP in deinen OpenClaw Skills-Ordner kopieren (üblicherweise ~/.openclaw/skills/).
  2. In skool-scout.md oben die drei Pfade an dein System anpassen (SCOUT_PYTHON, SCOUT_PATH, SCOUT_CONFIG).
  3. OpenClaw neu starten.

Trigger im Chat:

Häufige Fragen

Mein Skool-Login läuft nach ein paar Tagen ab. Was tun?

Das ist normal — Skool-Sessions laufen alle 7–14 Tage ab. Einfach diesen Befehl ausführen:

python3 skool_scout.py --save-session --config skool_config.json

Auf macOS hat der Setup-Wizard einen Shortcut "Skool_Session_Erneuern.command" auf deinem Desktop angelegt — Doppelklick reicht.

Telegram-Nachricht kommt nicht an

Drei häufige Ursachen:

  • Du hast dem Bot noch nicht /start geschickt.
  • Falscher Token oder falsche Chat-ID in skool_config.json.
  • Bot wurde gesperrt oder gelöscht.

Test-Befehl, um das schnell zu prüfen:

python3 skool_scout.py --test-telegram --config skool_config.json
Scout findet keine Posts

Möglicherweise ist die Session abgelaufen (siehe oben). Falls das nicht hilft, prüfe ob du tatsächlich Mitglied der angegebenen Communities bist und die URLs in skool_config.json korrekt geschrieben sind (mit https://www.skool.com/ als Anfang, ohne abschließenden Slash).

Werden Posts oder Cookies an externe Server geschickt?

Nein. Das Tool läuft komplett auf deinem Rechner. Es gibt nur drei Verbindungen:

  • skool.com — zum Auslesen deiner Communities (mit deinem eingeloggten Browser-Cookie)
  • api.telegram.org — zum Senden des Reports an dich
  • Optional: deine OpenClaw-Instanz, wenn du sie für die LinkedIn-Erstellung nutzt

Keine Analytics, keine Telemetrie, kein Cloud-Sync.

Kann ich die Keywords nachträglich ändern?

Ja. Öffne skool_config.json in einem Texteditor und passe das Array keywords an. Beim nächsten Run gilt die neue Liste.

Funktioniert das auch unter Windows?

Ja — am stabilsten unter WSL (Windows Subsystem for Linux). Direkt unter Windows-PowerShell läuft Python und Playwright auch, aber der Desktop-Shortcut für die Session-Erneuerung wird nur unter macOS erzeugt.

Ist das mit Skools Nutzungsbedingungen vereinbar?

Das Tool nutzt deinen normalen Skool-Login und liest nur Daten, die du auch im Browser sehen würdest — es geht nicht über das hinaus, was deine Mitgliedschaft erlaubt. Für intensive automatisierte Nutzung empfiehlt es sich trotzdem, einen Blick in die aktuellen Skool Terms zu werfen.