LinkWarden Bot

Linkwards - Discord Link Scanner Bot

Dieser Discord Bot, der für den persönlichen und Community -Gebrauch entwickelt wurde, verbessert die Serversicherheit, indem Links in Discord -Kanälen getestet werden. Es nutzt die virustotale API, die WHOIS-Lookups und die URLSCAN.IO-Scans, um eine umfassende Echtzeitanalyse bereitzustellen und eine sichere Online-Umgebung für Mitglieder zu erhalten.

Merkmale

• Echtzeit-Linkanalyse : Überprüft automatisch in Discord gegen die Virustotal-Datenbank, die WHOIS-Suchbetreuung in Discord geteilt und URLs an urlscan.io zum Scannen eingereicht werden.
• Umfassende Sicherheitsberichte : Erzeugt detaillierte Berichte, einschließlich Virustotal -Analyse, Domänenregistrierungsdetails von WHOIS und Webseiten -Schnappschüsse und Sicherheitseinsichten von urlscan.io.
• Flexible Überprüfungsmodi : bietet sowohl einen präzisen Überblick (einfacher Modus) als auch detaillierte Berichte (detaillierter Modus), um unterschiedliche Benutzereinstellungen zu entsprechen.
• Benutzerfreundlichkeit : Der Bot bettet einen Screenshot des Links ein, der zum Überprüfen des Chats in den einfachen oder detaillierten Scanmodi gesendet wird.
• Automatische Link -Scans : Der Bot sucht nach Links, die über den Server gesendet wurden, und scannen sie automatisch, wenn er nicht von einer vertrauenswürdigen Domäne stammt.
• Anpassbare Trusted Domain List - Mit der Hinzufügung von trusted_domains.json können Sie anpassen, welche Domänen gescannt werden sollen.
• Rollenspezifischer Befehl - Der BOT wird keine Befehlsformularbenutzer ausführen, die nicht die spezifische Rolle in der Datei config.py aufgeführt haben.
• Link Source - Der Bot bettet den Nachrichtenverbindungslink ein, bei dem der gescannte Link bei der Mäßigung erleichtert wurde.
• Link History - Der Bot log
• Anpassbarer Status - Benutzerdefinierte Statusnachrichten integriert.
• Clean Console - Benutzerdefinierte Drucknachrichten für jede Aktion und Interaktion mit dem Bot.

☕ Unterstützen Sie meine Arbeit an Ko-Fi

Erste Schritte

Bevor Sie den Bot verwenden können, müssen Sie ihn mit Ihrem Discord -Server einrichten und mit Ihren API -Tasten konfigurieren.

Voraussetzungen

• Ein Discord -Konto mit administrativen Berechtigungen auf Ihrem Server.
• Python 3.6 oder höher.
• API -Schlüssel für virustotal und urlscan.io (verfügbar auf ihren jeweiligen Websites).

Trete meinem Discord -Server bei

Installation

1. Klonen Sie dieses Repository in Ihre lokale Maschine.
2. Installieren Sie die erforderlichen Abhängigkeiten, indem Sie pip install -r requirements.txt ausführen.
3. Erstellen Sie eine config.py -Datei im selben Verzeichnis wie Ihr Bot -Skript (oder verwenden Sie die vorgefertigte Datei 'config.py') und fügen Sie Ihr Discord Bot -Token, den virustotalen API -Schlüssel, den URLSCAN.IO -API -Schlüssel, die Guild -ID (en), die Moderator -Rollen -ID und die ID des Kanals hinzu, in der die Ausgabe von Autodry -Link -Scans im folgenden Format eingeht.

 TOKEN = 'your_discord_bot_token_here'
VIRUSTOTAL_API_KEY = 'your_virustotal_api_key_here'
URLSCAN_API_KEY = 'your_urlscan_io_api_key_here'
guild_ids = [ your_guild_id_here ]
SCAN_CHANNEL_ID = CHANNEL_WHERE_SCANS_SHOULD_GO
ALLOWED_ROLE_IDS = [ MOD_ROLE_ID_GOES_HERE ]

4. Run main.py

Abhängigkeiten

Dieser Bot erfordert die folgenden Python -Pakete:

• Py-Cord
• Anfragen
• Python-whois können mit PIP installiert werden:

 pip install py - cord requests python - whois

Oder Sie können sie mit der Datei "Anforderungen.txt" installieren.

 pip install - r requirements . txt 

Verwendung

Der Bot ist mit einer einfachen Befehlsstruktur unkompliziert. Es unterstützt den folgenden Befehl:

Befehlsstruktur

/checklink [LINK] [MODE]

• Einfacher Modus : Bietet eine benutzerfreundliche Zusammenfassung, einschließlich des Sicherheitsstatus des Links, der Zusammenfassung der WHOIS-Domänen und eines Links zum urlscan.io-Bericht.

/checklink https://example.com simple

• Detaillierter Modus : Bietet einen umfassenden Bericht mit ansprechenden Bewertungen von virustotalen, detaillierten WHOIS-Informationen und einen umfassenden Sicherheitsbericht von urlscan.io.

/checklink https://example.com detailed

• History : gibt eine einfache Liste vergangener Links aus, die für Scans verwendet wurden, und verfolgen, wie oft jeder Link gesehen wurde.

/checklhistory

Modi erklärt

• Einfach : Zeigt eine präzise in die Top 10 Warnungen von Virustotal, eine Zusammenfassung der WHOIS -Informationen und einen Link zum urlscan.iobericht an.
• Detailliert : Enthält einen umfassenden Bericht, der jeden Anbieter mit einem farbcodierten Punkt gemäß der folgenden Legende sowie detaillierte WHOIS-Informationen und einen Sicherheitsbericht von URLSCAN.IO markiert.

Statuspunkte Legende

• Harmlos:?
• Bösartig:?
• Verdächtig: ?
• Unentdeckt: ⚪

Zukünftige Verbesserungen

• Dashboard-Integration : Entwickeln Sie ein webbasiertes Dashboard, das einen Überblick über frühere Scans bietet, einschließlich detaillierter Ergebnisse und Statistiken. Dieses Dashboard bietet Einblicke in die Arten von Links, die innerhalb des Servers geteilt werden, und in die Effektivität des Bots bei der Identifizierung von Bedrohungen, zur Verbesserung der Transparenz und des Vertrauens in die Funktionen des BOT.
• Zusätzliche Scan -Integrationen : Erweitern Sie die Scanfunktionen des BOT, indem Sie zusätzliche Sicherheitstools und -dienste integrieren. Diese Erweiterung bietet umfassendere Deckung und Schutz gegen eine breitere Palette von Online -Bedrohungen.
• Benutzer -Feedback -System : Implementieren Sie ein System für Benutzer, um Feedback zu Scan -Ergebnissen zu geben, z. Diese Rückkopplungsschleife wird dazu beitragen, die Genauigkeit und Effektivität des Bots im Laufe der Zeit zu verbessern.

Beitragen

• Ihre Beiträge sind willkommen! Unabhängig davon, ob neue Funktionen hinzugefügt, die Dokumentation oder die Berichterstattung von Fehler hinzugefügt werden, können Sie dieses Repository aufgeben und eine Pull -Anfrage abgeben.

Mitwirkende

• CAZAIRA - half bei der Verfeinerung und Machen Sie die Datei trusted_domains.json gegen falsch positive Ergebnisse.
• Nitrrine - entdeckte einen kritischen Fehler, der den Bot auf bestimmten Links zum Absturz brachte.

Lizenz

Dieses Projekt ist im Rahmen der MIT-Lizenz offen.