LinkWarden Bot

linkwarden-不和諧鏈接掃描儀機器人

該Discord Bot專為個人和社區使用而設計，可通過審查在Discord渠道中共享的鏈接來增強服務器的安全性。它利用Virustal API，WHOIS查找和urlscan.io掃描來提供全面的實時分析，從而幫助維護會員安全的在線環境。

特徵

• 實時鏈接分析：自動檢查與Virustotal數據庫中的不和諧共享的鏈接，執行WHOIS查找，並將URL提交到Urlscan.io進行掃描。
• 綜合安全報告：生成詳細報告，包括Virustotal的分析，WHOIS的域註冊詳細信息以及網頁快照和urlscan.io的安全見解。
• 靈活的檢查模式：提供簡潔的概述（簡單模式）和詳細的報告（詳細模式），以適合不同的用戶偏好。
• 易用性：該機器人將嵌入發送的鏈接的屏幕截圖，以在兩個掃描模式下在聊天中進行檢查，以簡單或詳細的方式進行檢查。
• 自動鏈接掃描：機器人將查找在服務器上發送的鏈接，並自動掃描它們，如果它們不是來自受信任的域。
• 可自定義的可信域列表- 添加trusted_domains.json ，您可以自定義應掃描哪些域。
• 角色特定命令- 機器人不會執行命令表格用戶，這些用戶沒有config.py文件中列出的特定角色。
• 鏈接源- 機器人將嵌入消息鏈接，在該鏈接中發現掃描的鏈接在使節制更容易時發現。
• 鏈接歷史記錄- 機器人記錄所有被掃描的鏈接並保留它們以備將來參考
• 可自定義狀態- 內置自定義狀態消息。
• 清潔控制台- 針對每一個動作的自定義打印消息以及與機器人的交互。

☕支持我在KO-FI上的工作

入門

在使用機器人之前，您需要使用Discord Server進行設置並使用API​​鍵進行配置。

先決條件

• 一個不在服務器上具有管理特權的Discord帳戶。
• Python 3.6或更高。
• Virustotal和urlscan.io的API鍵（可從其各自的網站獲得）。

加入我的Discord服務器

安裝

1. 將此存儲庫克隆到您的本地計算機。
2. 通過運行pip install -r requirements.txt安裝所需的依賴項。
3. 在與Bot腳本相同的目錄中創建一個config.py文件（或使用預製'config.py'文件），並添加您的Discord Bot令牌，virustotal api鍵，urlscan.io api鍵，guild id（s），調速器角色ID和ID，以及想要在以下形式的頻道輸出的位置：

 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. 運行main.py

依賴性

該機器人需要以下python軟件包：

• py-cord
• 請求
• python-誰可以使用pip安裝：

 pip install py - cord requests python - whois

或者，您可以使用sumplast.txt文件安裝它們。

 pip install - r requirements . txt 

用法

該機器人很容易與簡單的命令結構一起使用。它支持以下命令：

命令結構

/checklink [LINK] [MODE]

• 簡單模式：提供一個用戶友好的摘要，包括鏈接的安全狀態，WHOIS域註冊摘要以及指向ur​​lscan.io報告的鏈接。

/checklink https://example.com simple

• 詳細模式：提供一份詳盡的報告，其中包括供應商特定的評級，詳細的WHOIS信息以及urlscan.io的全面安全報告。

/checklink https://example.com detailed

• 歷史記錄：輸出一個簡單的過去鏈接列表，這些鏈接用於掃描，並跟踪看到每個鏈接的次數。

/checklhistory

模式解釋了

• 簡單：顯示一個簡潔的嵌入，其中嵌入了Virustotal的前10個警告，WHOIS信息的摘要以及與urlscan.io報告的鏈接。
• 詳細信息：介紹了一份綜合報告，根據下面的傳說標記每個供應商的顏色編碼點，以及詳細的WHOIS信息和urlscan.io安全報告。

狀態點傳奇

• 無害：？
• 惡意：？
• 可疑的： ？
• 未被發現：⚪

未來的增強

• 儀表板集成：開發基於Web的儀表板，概述了過去的掃描，包括詳細的結果和統計信息。該儀表板將提供有關服務器中共享的鏈接類型的見解，以及機器人在識別威脅，增強透明度和對機器人功能的信任方面的有效性。
• 其他掃描集成：通過集成其他安全工具和服務來擴展機器人的掃描功能。這種擴展將為更全面的覆蓋範圍和保護，以防止更廣泛的在線威脅。
• 用戶反饋系統：實施一個系統，供用戶提供有關掃描結果的反饋，例如報告誤報或錯過威脅。此反饋循環將有助於提高機器人的準確性和隨著時間的影響。

貢獻

• 歡迎您的貢獻！無論是添加新功能，改進文檔還是報告錯誤，請隨時向該存儲庫分叉並提交拉動請求。

貢獻者

• Cazaira-幫助完善並使trusted_domains.json更強地針對誤報。
• 硝酸鹽- 發現了一個關鍵的錯誤，導致該機器人在某些鏈接上崩潰。

執照

該項目是根據MIT許可證開源的。