SK DC-Tools — Anleitung

1. Erste Schritte

SK-DC-Tools.exe starten. Beim ersten Start erscheint der Seriennummer-Bildschirm: trage deine scalper-king Seriennummer ein und klicke Aktivieren. Danach öffnet sich das Hauptfenster mit dem Log über die ganze Seite.

Über das ⚙️ Zahnrad (oben rechts) öffnest du die Einstellungen. Trage dort mindestens ein:

• Discord-Token — dein User-Token (siehe Abschnitt 2 „Discord-Token erhalten")
• Kanal-IDs oder Kategorie-IDs — was überwacht werden soll
• Mindestens einen Benachrichtigungsweg: Pushover und/oder CallMeBot

Mit dem grünen Start-Button startest du den Bot. Der Statuspunkt wird grün und zeigt „Läuft". Eingehende Nachrichten erscheinen live im Log.

2. Discord-Token erhalten

SK DC-Tools benötigt deinen persönlichen Discord-User-Token. Am einfachsten liest du ihn mit der mitgelieferten Chrome-Erweiterung aus dem Ordner RECEIVE-DC-TOKEN-EXTENSION (liegt neben der Anleitung) aus:

1. In Chrome oder Edge die Seite chrome://extensions öffnen.
2. Oben rechts den Entwicklermodus einschalten.
3. Auf „Entpackte Erweiterung laden" klicken und den Ordner RECEIVE-DC-TOKEN-EXTENSION auswählen.
4. Im selben Browser bei discord.com einloggen und einen beliebigen Kanal öffnen.
5. Oben rechts auf das 🔑-Symbol der Erweiterung klicken — dein Token wird angezeigt.
6. Mit „Kopieren" übernehmen und in SK DC-Tools (⚙️ → Feld Discord-Token) einfügen, dann speichern.

3. Kanäle & Kategorien

Du kannst einzelne Kanal-IDs angeben oder ganze Kategorie-IDs. Bei einer Kategorie werden automatisch alle Kanäle darin überwacht (praktisch, wenn oft neue Kanäle dazukommen).

IDs bekommst du in Discord mit aktiviertem Entwicklermodus per Rechtsklick → „ID kopieren". Mehrere IDs: eine pro Zeile.

4. Pushover & CallMeBot

Beide Kanäle sind unabhängig zuschaltbar — du kannst nur einen, beide oder gemischt nutzen.

Pushover

Im Einstellungen-Bereich Pushover: User Key und API Token eintragen, Schalter „Pushover senden" an. Mit Test-Benachrichtigung senden prüfst du die Zugangsdaten. Pushover kann auch das Produktbild als Anhang mitschicken und einen tippbaren Link zum Angebot.

CallMeBot (WhatsApp)

Im Bereich CallMeBot: Telefonnummer (mit Ländervorwahl, z.B. 491701234567) und API-Key eintragen, Schalter „CallMeBot senden" an. Den API-Key forderst du einmalig per WhatsApp bei CallMeBot an (siehe callmebot.com/whatsapp). CallMeBot verschickt nur Text (keine Bilder).

5. Keyword-Filter

Der einfache Filter (Schalter „Filter aktiv") lässt nur passende Nachrichten durch:

Keyword-Filter und Smart-Filter wirken zusammen (UND): eine Nachricht wird nur gemeldet, wenn sie beide aktiven Filter besteht.

6. Smart-Filter wichtig

Der Smart-Filter ist das mächtigste Werkzeug: Regeln in der Datei smart_filter.json (neben der .exe). Im Programm aktivierst du ihn mit dem Schalter „Smart-Filter aktivieren" und öffnest die Datei mit smart_filter.json bearbeiten im Texteditor. Änderungen werden im laufenden Betrieb automatisch übernommen — kein Neustart nötig.

So wirkt er

• "enabled": false → Smart-Filter aus, es kommt alles durch.
• "enabled": true → es wird nur gemeldet, was zu einer Forward-Regel passt.
• Eine passende Block-Regel unterdrückt die Meldung (hat Vorrang).
• Passt keine Regel → keine Meldung.

Aufbau der Datei

Kopieren{
  "enabled": true,
  "rules": [
    {
      "name": "Anzeigename der Regel",
      "enabled": true,
      "conditions": [ ... ],
      "action": "forward",        // "forward" (Standard) oder "block"
      "add_emoji": "🔥",          // optional: vorne an die Nachricht
      "add_text": "DEAL:"         // optional: Text vorne anstellen
    }
  ]
}

Bedingungen (conditions)

Jede Regel hat eine Liste von Bedingungen. Eine Bedingung kann ein reiner Text-Treffer sein oder eine Zahl aus dem Text ziehen und prüfen. Der Platzhalter XX steht für die Zahl.

Mehrere Bedingungen lassen sich mit "AND" / "OR" verknüpfen (als Eintrag zwischen den Bedingungen).

7. Smart-Filter — Beispiele

Beispiel 1 — Nur ein bestimmtes Produkt (Text)

Nur benachrichtigen, wenn „LEGO" vorkommt. Emoji 🧱 wird vorangestellt.

Kopieren{
  "name": "Nur LEGO",
  "enabled": true,
  "conditions": [
    { "text_contains": ["LEGO", "Lego"] }
  ],
  "add_emoji": "🧱"
}

Beispiel 2 — Marge über 30 % (Zahl prüfen)

Zieht die Prozentzahl aus Texten wie „Marge: 35%" und meldet nur, wenn sie größer als 30 ist.

Kopieren{
  "name": "Hohe Marge (>30%)",
  "enabled": true,
  "conditions": [
    {
      "text_contains": ["Marge: XX%", "XX% Marge", "XX%"],
      "extract": "XX",
      "check": "XX > 30",
      "multi_match": "any"
    }
  ]
}

Beispiel 3 — Preis unter 40 €

Meldet nur, wenn ein Preis unter 40 € gefunden wird (z.B. „Preis: 31,54€").

Kopieren{
  "name": "Guenstig (unter 40 EUR)",
  "enabled": true,
  "conditions": [
    {
      "text_contains": ["Preis: XX€", "XX€", "€XX"],
      "extract": "XX",
      "check": "XX < 40",
      "multi_match": "min"
    }
  ]
}

Beispiel 4 — Kombination (Keyword UND Preis)

Nur „Nike"-Deals, und nur wenn der Preis unter 120 € liegt. Zwei Bedingungen mit AND.

Kopieren{
  "name": "Nike unter 120 EUR",
  "enabled": true,
  "conditions": [
    { "text_contains": ["Nike"] },
    "AND",
    {
      "text_contains": ["XX€", "€XX"],
      "extract": "XX",
      "check": "XX < 120",
      "multi_match": "min"
    }
  ]
}

Beispiel 5 — Etwas ausblenden (Block)

Alle „sold out"-Meldungen unterdrücken. Block-Regeln haben Vorrang vor Forward-Regeln.

Kopieren{
  "name": "Kein Sold Out",
  "enabled": true,
  "action": "block",
  "conditions": [
    { "text_contains": ["sold out", "ausverkauft"] }
  ]
}

Beispiel 6 — Marge ODER Profit

Meldet, wenn die Marge über 30 % oder der Profit über 50 € liegt.

Kopieren{
  "name": "Marge>30 ODER Profit>50",
  "enabled": true,
  "conditions": [
    { "text_contains": ["XX% Marge", "XX%"], "extract": "XX", "check": "XX > 30", "multi_match": "any" },
    "OR",
    { "text_contains": ["Profit: XX€", "XX€"], "extract": "XX", "check": "XX > 50", "multi_match": "any" }
  ]
}

Komplette Datei mit mehreren Regeln

Kopieren{
  "enabled": true,
  "rules": [
    {
      "name": "Hohe Marge (>30%)",
      "enabled": true,
      "conditions": [
        { "text_contains": ["Marge: XX%", "XX%"], "extract": "XX", "check": "XX > 30", "multi_match": "any" }
      ]
    },
    {
      "name": "Kein Sold Out",
      "enabled": true,
      "action": "block",
      "conditions": [ { "text_contains": ["sold out", "ausverkauft"] } ]
    }
  ]
}

8. Autostart, Tray & Fenster

• Autostart mit Windows — startet das Programm beim Anmelden.
• Beim Start Bot automatisch starten — legt nach dem Öffnen direkt los.
• Schließen minimiert in den Tray — der Schließen-Button (✕ im Header) legt das Fenster ins Tray-Icon statt zu beenden. Über das Tray-Icon: Öffnen, Bot starten/stoppen, Beenden.
• Das Fenster hat eine eigene Titelleiste: am Header ziehen zum Verschieben, – minimiert, ✕ schließt/legt in den Tray.

9. Wichtige Hinweise

Lädt der Bot nicht: prüfe Seriennummer (Lizenz), Discord-Token und ob mindestens ein Kanal/eine Kategorie eingetragen ist. Das Log im Hauptfenster zeigt die Ursache. Bei Bedarf steht die ausführliche Fehlerausgabe zusätzlich in log.txt neben der .exe.