Linkwarden - Discord Link Scanner Bot
Esse bot da Discord, projetado para uso pessoal e comunitário, aprimora a segurança do servidor, examinando os links compartilhados nos canais Discord. Ele aproveita a API Virustotal, as pesquisas de Whois e o UrlScan.io para fornecer análises abrangentes em tempo real, ajudando a manter um ambiente on-line seguro para os membros.
Características
- Análise de link em tempo real : verifica automaticamente os links compartilhados em discórdia contra o banco de dados Virustotal, executa pesquisas do WHOIS e envia URLs para urlscan.io para digitalização.
- Relatórios de segurança abrangentes : gera relatórios detalhados, incluindo a análise do Virustotal, detalhes de registro de domínio do WHOIS e instantâneos de página da web e insights de segurança do urlscan.io.
- Modos de verificação flexíveis : oferece uma visão geral concisa (modo simples) e relatórios detalhados (modo detalhado) para se adequar a diferentes preferências do usuário.
- Facilidade de uso : o bot incorporará uma captura de tela do link enviada para verificar o bate -papo nos dois modos de digitalização, simples ou detalhado.
- Digitalizações automáticas de link : o bot procurará links enviados pelo servidor e os digitalizam automaticamente se não forem a partir de um domínio confiável.
- Lista de domínio confiável personalizável - com a adição de
trusted_domains.json , você pode personalizar quais domínios devem ser digitalizados. - Comando específico da função - o bot não executará os comandos formam usuários que não possuem a função específica listada no arquivo
config.py . - Link Source - O bot incorporará o link da mensagem em que o link digitalizado foi encontrado para facilitar a moderação.
- Histórico de links - o bot registra todos os links que são enviados para serem digitalizados e os mantém para referência futura
- Status personalizável - mensagens de status personalizadas integradas.
- Console limpo - mensagens de impressão personalizadas para todas as ações e interação com o bot.
☕ Apoie meu trabalho em Ko-Fi
Começando
Antes de poder usar o bot, você precisará configurá -lo com seu servidor Discord e configurá -lo com suas teclas de API.
Pré -requisitos
- Uma conta Discord com privilégios administrativos em seu servidor.
- Python 3.6 ou superior.
- API Keys for Virustotal e UrlScan.io (disponível em seus respectivos sites).
Junte -se ao meu servidor Discord
Instalação
- Clone este repositório para sua máquina local.
- Instale as dependências necessárias executando
pip install -r requirements.txt . - Crie um arquivo
config.py no mesmo diretório que o seu script bot (ou use o arquivo premiado 'config.py') e adicione o seu token de bot discord, key da API Virustotal, UrlScan.io API Key, Guild ID (s), ID do moderador e o ID do canal onde você deseja que a saída da saída de auto
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 ]
- Execute
main.py
Dependências
Este bot requer os seguintes pacotes Python:
- py-cord
- solicitações
- python-whois estes podem ser instalados usando PIP:
pip install py - cord requests python - whois
Ou você pode instalá -los usando o arquivo requisitos.txt.
pip install - r requirements . txt
Uso
O bot é simples de usar com uma estrutura de comando simples. Ele suporta o seguinte comando:
Estrutura de comando
/checklink [LINK] [MODE]
- Modo Simples : fornece um resumo amigável, incluindo o status de segurança do link, resumo do registro do domínio WHOIS e um link para o relatório URLScan.io.
/checklink https://example.com simple
- Modo detalhado : oferece um relatório exaustivo com classificações específicas do fornecedor do Virustottal, informações detalhadas do WHOIS e um relatório de segurança abrangente do urlscan.io.
/checklink https://example.com detailed
- Histórico : produz uma lista simples de links anteriores que foram usados para varreduras e acompanha quantas vezes cada link foi visto.
/checklhistory
Modos explicados
- Simples : exibe uma incorporação concisa com os 10 principais avisos do Virustottal, um resumo das informações da WHOIS e um link para o relatório URLScan.io.
- Detalhado : apresenta um relatório abrangente, marcando cada fornecedor com um ponto codificado por cores, de acordo com a lenda abaixo, juntamente com informações detalhadas do WHOIS e um relatório de segurança URLScan.io.
Legenda dos pontos de status
- Inofensivo: ?
- Malicioso :?
- Suspeito :?
- Não detectado: ⚪
Aprimoramentos futuros
- Integração do painel : desenvolva um painel baseado na Web que fornece uma visão geral das varreduras anteriores, incluindo resultados e estatísticas detalhados. Este painel oferecerá informações sobre os tipos de links compartilhados no servidor e a eficácia do bot na identificação de ameaças, aumentando a transparência e a confiança nos recursos do bot.
- Integrações adicionais de varredura : expandam os recursos de digitalização do bot, integrando ferramentas e serviços de segurança adicionais. Essa expansão fornecerá uma cobertura e proteção mais abrangentes contra uma ampla gama de ameaças on -line.
- Sistema de feedback do usuário : implemente um sistema para os usuários fornecer feedback sobre os resultados da verificação, como relatar falsos positivos ou ameaças perdidas. Esse loop de feedback ajudará a melhorar a precisão e a eficácia do bot ao longo do tempo.
Contribuindo
- Suas contribuições são bem -vindas! Seja adicionando novos recursos, melhorando a documentação ou os relatórios de bugs, sinta -se à vontade para gastar este repositório e enviar uma solicitação de tração.
Colaboradores
- CAZAIRA - Ajudou a refinar e tornar o arquivo
trusted_domains.json mais forte contra falsos positivos. - Nitrina - descobriu um bug crítico que fez com que o bot trapacessem em determinados links.
Licença
Este projeto é de código aberto sob a licença do MIT.
