LinkWarden Bot

Linkwarden - Discord Link Scanner Bot

Este bot de discordia, diseñado para uso personal y comunitario, mejora la seguridad del servidor al analizar los enlaces compartidos dentro de los canales de discordia. Aprovecha la API Virustotal, las búsquedas WHOIS y los escaneos de URLScan.io para proporcionar un análisis integral en tiempo real, ayudando a mantener un entorno en línea seguro para los miembros.

Características

• Análisis de enlaces en tiempo real : verifica automáticamente los enlaces compartidos en discordia contra la base de datos Virustotal, realiza las búsquedas WHOIS y envía URL a URLScan.io para escanear.
• Informes de seguridad completos : genera informes detallados que incluyen el análisis de Virustotal, los detalles de registro de dominio de WHOIS y las instantáneas de la página web y las ideas de seguridad de URLScan.io.
• Modos de verificación flexibles : ofrece una descripción general concisa (modo simple) y informes detallados (modo detallado) para adaptarse a diferentes preferencias del usuario.
• Facilidad de uso : el BOT incrustará una captura de pantalla del enlace enviado para verificar directamente en el chat en ambos modos de escaneo, simple o detallado.
• Escaneos automáticos de enlace : el bot buscará enlaces enviados en todo el servidor y los escaneará automáticamente si no son de un dominio de confianza.
• Lista de dominio de confianza personalizable : con la adición de trusted_domains.json , puede personalizar qué dominios deben escanear.
• Comando específico de rol : el bot no ejecutará comandos de los usuarios que no tengan el rol específico enumerado en el archivo config.py .
• Fuente del enlace : el bot incrustará el enlace del mensaje donde se encontró el enlace escaneado para facilitar la moderación.
• Historial de enlaces : los registros de BOT todos los enlaces que se envían para ser escaneados y los mantienen para referencia futura
• Estado personalizable : mensajes de estado personalizados incorporados.
• Consola limpia : mensajes de impresión personalizados para cada acción e interacción con el bot.

☕ Apoye mi trabajo en Ko-Fi

Empezando

Antes de que pueda usar el bot, deberá configurarlo con su servidor Discord y configurarlo con sus claves API.

Requisitos previos

• Una cuenta de Discord con privilegios administrativos en su servidor.
• Python 3.6 o superior.
• API Keys para Virustotal y URLScan.io (disponible en sus respectivos sitios web).

Únete a mi servidor de discordias

Instalación

1. Clone este repositorio a su máquina local.
2. Instale las dependencias requeridas ejecutando pip install -r requirements.txt .
3. Cree un archivo config.py en el mismo directorio que su script BOT (o use el archivo 'config.py' premado) y agregue su token de bot de discordia, la tecla API virustotal, la tecla API de URLScan.io, la ID (s) de Guild de Moderator y la ID del canal donde desea la salida de los escamones de enlace automático para ir al siguiente formato::

 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. Ejecute main.py

Dependencias

Este bot requiere los siguientes paquetes de Python:

• coro
• solicitudes
• Python-whois se pueden instalar con PIP:

 pip install py - cord requests python - whois

O puede instalarlos utilizando el archivo requisitos.txt.

 pip install - r requirements . txt 

Uso

El bot es sencillo de usar con una estructura de comando simple. Admite el siguiente comando:

Estructura de comandos

/checklink [LINK] [MODE]

• Modo simple : proporciona un resumen fácil de usar que incluye el estado de seguridad del enlace, el resumen de registro de dominio WHOIS y un enlace al informe URLScan.io.

/checklink https://example.com simple

• Modo detallado : ofrece un informe exhaustivo con calificaciones específicas del proveedor de la información de Whois de Virustotal, detallada y un informe de seguridad integral de URLScan.io.

/checklink https://example.com detailed

• Historial : genera una lista simple de enlaces pasados ​​que se usaron para escaneos y realiza un seguimiento de cuántas veces se vio cada enlace.

/checklhistory

Modos explicados

• Simple : muestra una inserción concisa con las 10 advertencias principales de Virustotal, un resumen de la información de Whois y un enlace al informe URLScan.io.
• Detallado : presenta un informe completo, que marca a cada proveedor con un punto codificado por colores según la leyenda a continuación, junto con la información detallada de Whois y un informe de seguridad de URLScan.io.

Leyenda de puntos de estado

• Inofensivo: ?
• Malicioso :?
• Sospechoso: ?
• Sin detectado: ⚪

Mejoras futuras

• Integración del tablero : desarrolle un tablero basado en la web que proporcione una visión general de los escaneos pasados, incluidos resultados detallados y estadísticas. Este tablero ofrecerá información sobre los tipos de enlaces compartidos dentro del servidor y la efectividad del Bot para identificar las amenazas, mejorar la transparencia y la confianza en las capacidades del BOT.
• Integraciones de escaneo adicionales : expanda las capacidades de escaneo del bot integrando herramientas y servicios de seguridad adicionales. Esta expansión proporcionará una cobertura y protección más integrales contra una gama más amplia de amenazas en línea.
• Sistema de comentarios de los usuarios : implementa un sistema para que los usuarios proporcionen comentarios sobre los resultados del escaneo, como informar falsos positivos o amenazas perdidas. Este ciclo de retroalimentación ayudará a mejorar la precisión y efectividad del bot con el tiempo.

Que contribuye

• ¡Tus contribuciones son bienvenidas! Ya sea agregando nuevas funciones, mejorar la documentación o informar errores, no dude en desembolsar este repositorio y enviar una solicitud de extracción.

Colaboradores

• Cazaira : ayudó a refinar y fortalecer el archivo trusted_domains.json más fuerte contra falsos positivos.
• Nitrrine : descubrió un error crítico que hizo que el BOT se bloqueara en ciertos enlaces.

Licencia

Este proyecto es de código abierto bajo la licencia MIT.