LinkWarden Bot

Linkwarden - Bot Pemindai Tautan Perselisihan

Bot perselisihan ini, yang dirancang untuk penggunaan pribadi dan komunitas, meningkatkan keamanan server dengan meneliti tautan yang dibagikan dalam saluran Discord. Ini memanfaatkan API Virustotal, Whois Lookups, dan Urlscan.io scan untuk memberikan analisis real-time yang komprehensif, membantu mempertahankan lingkungan online yang aman bagi anggota.

Fitur

• Analisis tautan real-time : Secara otomatis memeriksa tautan yang dibagikan pada perselisihan terhadap database Virustotal, melakukan pencarian whois, dan mengirimkan URL ke urlscan.io untuk pemindaian.
• Laporan Keamanan Komprehensif : Menghasilkan laporan terperinci termasuk analisis Virustotal, detail pendaftaran domain dari whois, dan snapshot halaman web dan wawasan keamanan dari urlscan.io.
• Mode Pemeriksaan Fleksibel : Menawarkan ikhtisar singkat (mode sederhana) dan laporan terperinci (mode terperinci) sesuai dengan preferensi pengguna yang berbeda.
• Kemudahan Penggunaan : Bot akan menanamkan tangkapan layar tautan yang dikirim untuk memeriksa tepat di obrolan di kedua mode pemindaian, sederhana atau terperinci.
• Pemindaian Tautan Otomatis : Bot akan mencari tautan yang dikirim ke seluruh server dan memindai mereka secara otomatis jika bukan dari domain tepercaya.
• Daftar Domain Tepercaya yang Dapat Disesuaikan - Dengan penambahan trusted_domains.json Anda dapat menyesuaikan domain apa yang harus dipindai.
• Perintah Spesifik Peran - Bot tidak akan menjalankan perintah formulir pengguna yang tidak memiliki peran spesifik yang tercantum dalam file config.py .
• Sumber Tautan - Bot akan menanamkan tautan pesan di mana tautan yang dipindai ditemukan dalam membuat moderasi lebih mudah.
• Sejarah Tautan - Bot mencatat semua tautan yang dikirim untuk dipindai dan menyimpannya untuk referensi di masa mendatang
• Status yang dapat disesuaikan - Pesan Status Kustom bawaan.
• Clean Console - Pesan Cetak Kustom untuk setiap tindakan dan interaksi dengan bot.

☕ Dukung pekerjaan saya di ko-fi

Memulai

Sebelum Anda dapat menggunakan bot, Anda harus mengaturnya dengan server Discord Anda dan mengonfigurasinya dengan kunci API Anda.

Prasyarat

• Akun Perselisihan dengan hak istimewa administratif di server Anda.
• Python 3.6 atau lebih tinggi.
• Kunci API untuk Virustotal dan Urlscan.io (tersedia dari situs web masing -masing).

Bergabunglah dengan Server Perselisihan saya

Instalasi

1. Kloning repositori ini ke mesin lokal Anda.
2. Pasang dependensi yang diperlukan dengan menjalankan pip install -r requirements.txt .
3. Create a config.py file in the same directory as your bot script ( or use the premade 'config.py' file ), and add your Discord Bot Token, VirusTotal API Key, URLScan.io API Key, guild ID(s), Moderator Role ID, and the ID of the channel where you want the output of auto link scans to go in the following format:

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

Dependensi

Bot ini membutuhkan paket Python berikut:

• Py-Cord
• permintaan
• Python-whois Ini dapat diinstal menggunakan pip:

 pip install py - cord requests python - whois

Atau Anda dapat menginstalnya menggunakan file persyaratan.txt.

 pip install - r requirements . txt 

Penggunaan

Bot mudah digunakan dengan struktur perintah sederhana. Itu mendukung perintah berikut:

Struktur perintah

/checklink [LINK] [MODE]

• Mode Sederhana : Memberikan ringkasan yang ramah pengguna termasuk status keselamatan tautan, ringkasan pendaftaran domain whois, dan tautan ke laporan urlscan.io.

/checklink https://example.com simple

• Mode terperinci : Menawarkan laporan lengkap dengan peringkat khusus vendor dari Virustotal, informasi whois terperinci, dan laporan keamanan komprehensif dari urlscan.io.

/checklink https://example.com detailed

• Sejarah : Output daftar tautan sebelumnya yang digunakan untuk pemindaian dan melacak berapa kali setiap tautan terlihat.

/checklhistory

Mode dijelaskan

• Sederhana : Menampilkan sematan ringkas dengan 10 peringatan teratas dari Virustotal, ringkasan informasi whois, dan tautan ke laporan Urlscan.io.
• Detail : Menyajikan laporan komprehensif, menandai setiap vendor dengan titik berkode warna sesuai legenda di bawah ini, bersama dengan informasi whois terperinci dan laporan keamanan urlscan.io.

Status Titik Legenda

• Tidak berbahaya:?
• Berbahaya:?
• Mencurigakan: ?
• Tidak terdeteksi: ⚪

Peningkatan di masa depan

• Integrasi Dasbor : Kembangkan dasbor berbasis web yang memberikan gambaran umum pemindaian masa lalu, termasuk hasil dan statistik yang terperinci. Dasbor ini akan menawarkan wawasan tentang jenis tautan yang dibagikan di dalam server dan efektivitas bot dalam mengidentifikasi ancaman, meningkatkan transparansi dan kepercayaan pada kemampuan bot.
• Integrasi Pemindaian Tambahan : Perluas kemampuan pemindaian bot dengan mengintegrasikan alat dan layanan keamanan tambahan. Perluasan ini akan memberikan cakupan dan perlindungan yang lebih komprehensif terhadap berbagai ancaman online yang lebih luas.
• Sistem Umpan Balik Pengguna : Menerapkan sistem bagi pengguna untuk memberikan umpan balik tentang hasil pemindaian, seperti melaporkan positif palsu atau ancaman yang terlewat. Loop umpan balik ini akan membantu meningkatkan akurasi dan efektivitas bot dari waktu ke waktu.

Berkontribusi

• Kontribusi Anda dipersilakan! Apakah itu menambahkan fitur baru, meningkatkan dokumentasi, atau melaporkan bug, jangan ragu untuk membayar repositori ini dan mengirimkan permintaan tarik.

Kontributor

• Cazaira - membantu memperbaiki dan membuat file trusted_domains.json lebih kuat terhadap positif palsu.
• Nitrrine - menemukan bug kritis yang menyebabkan bot menabrak tautan tertentu.

Lisensi

Proyek ini bersumber terbuka di bawah lisensi MIT.