Add scamimages cog - detect scam images and auto-ban posters

README.md

@@ -49,6 +49,7 @@ Cogs for the [Red-DiscordBot](https://github.com/Cog-Creators/Red-DiscordBot/)-b
       - [Welcome Logic](#welcome-logic)
       - [Commands](#commands)
     - [Roleinfo](#roleinfo)
+    - [ScamImages](#scamimages)
     - [Sentry](#sentry)
     - [Tags](#tags)
     - [Timeout](#timeout)
@@ -96,6 +97,7 @@ A massive thank you to [all who've helped with this project](https://github.com/
 - **[Report](#report):** Allows users to report issues.
 - **[role\_welcome](#role_welcome):** Sends a welcome message when a user is added to a role.
 - **[Roleinfo](#roleinfo):** Displays info on a role
+- **[ScamImages](#scamimages):** Detects known scam images and automatically bans users who post them.
 - **[Sentry](#sentry):** Send unhandled errors to sentry.
 - **[Tags](#tags):** Allow user-generated stored messages.
 - **[Timeout](#timeout):** Manage users' timeout status.
@@ -441,6 +443,19 @@ Allows you to view info on a role
 
 - `[p]roleinfo <role>`
 
+### ScamImages
+
+This cog automatically detects known scam images (e.g. MrBeast giveaway scams) using perceptual hashing and bans users who post them. Admins can manage the image hash database.
+
+All commands are admin-only.
+
+- `[p]scamimages add [url]` - Add an image to the database (by URL, attachment, or reply).
+- `[p]scamimages remove <index>` - Remove a hash by its index (see `list`).
+- `[p]scamimages list` - List all hashes in the database.
+- `[p]scamimages scan` - Manually scan an attached or replied-to image.
+- `[p]scamimages logchannel <channel>` - Set the channel for ban alert logging.
+- `[p]scamimages clear` - Clear the entire database (requires confirmation).
+
 ### Sentry
 
 Send unhandled errors and performance metrics to sentry.

scamimages/__init__.py

@@ -0,0 +1,7 @@
+from redbot.core.bot import Red
+
+from .scamimages import ScamImagesCog
+
+
+async def setup(bot: Red):
+    await bot.add_cog(ScamImagesCog(bot))

scamimages/info.json

@@ -0,0 +1,22 @@
+{
+    "author": [
+        "word"
+    ],
+    "short": "Detect known scam images and auto-ban posters",
+    "description": "Detects known scam images (e.g. MrBeast giveaways) using perceptual hashing and automatically bans users who post them. Admins can manage the image hash database.",
+    "disabled": false,
+    "name": "scamimages",
+    "requirements": [
+        "imagehash~=4.3.1",
+        "Pillow~=11.2.0"
+    ],
+    "tags": [
+        "anti-scam",
+        "images",
+        "moderation",
+        "prevention",
+        "scam"
+    ],
+    "install_msg": "Usage: `[p]scamimages`",
+    "min_bot_version": "3.5.1"
+}