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许可证开源的。