ScamGuard images

Plugin léger de détection d'images et de comportements de scam pour bots Discord.js.
Utilise le hash perceptuel (phash) pour comparer les images envoyées dans un serveur avec une bibliothèque d'images de scam connues, en tolérant les variantes (compression, redimensionnement), et combine ça avec de l'OCR, de la détection de mots-clés, de l'analyse d'URLs et des signaux comportementaux/compte pour calculer un score de risque global.

Fonctionnalités

• Comparaison par hash perceptuel (tolérant aux variantes d'image)
• Détection sur pièces jointes, embeds et URLs dans le contenu
• OCR (Tesseract.js) sur les images pour extraire le texte et le passer au filtre de mots-clés
• Détection de mots-clés pondérés (texte du message + texte OCR combinés)
• Vérification des URLs (whitelist, âge de domaine via whois)
• Vérification du compte Discord (âge du compte, âge d'arrivée sur le serveur, avatar manquant, pseudo suspect, absence de rôles)
• Signaux comportementaux (première interaction, message image seule, crosspost par texte, crosspost par nombre de pièces jointes identique sur plusieurs salons)
• Téléchargement parallèle des images (Promise.all)
• Cache en mémoire des hashes de référence
• Zéro dépendance Discord — fonctionne avec n'importe quel bot Discord.js existant
• Entièrement configurable (seuils, scores, dossiers, langues OCR, whitelist...)

Installation

npm install @azurhosts/scamguard-images

Démarrage rapide

import { analyzeMessageImages } from '@azurhosts/scamguard-images';

client.on('messageCreate', async (message) => {
  if (message.author.bot) return;

  const result = await analyzeMessageImages(message, {
    bannedImagesDir: './banned_images',   // ton dossier d'images de référence
    bannedImagesThreshold: 0.3125,        // tolérance de similarité normalisée (0-1)
    bannedImagesScore: 50,                // score ajouté si match image détecté
    ocrEnabled: true,                     // active l'OCR sur les images
    ocrLang: 'fra+eng',                   // langues tesseract.js
    checkDomainAge: true,                 // active la vérification whois des domaines
    keywords: [],                         // liste de mots-clés pondérés
    whitelist: [],                        // domaines de confiance pour les URLs
  });

  if (result.score >= 50) {
    console.log(`[ScamGuard] Scam détecté:`, result.factors);
    await message.delete();
    // ta logique de sanction ici
  }
});

Préparer le dossier banned_images

Crée un dossier banned_images/ à la racine de ton projet et ajoute-y des screenshots des scams connus à bloquer.

racine/
├── banned_images/
│   ├── nitro_fake.png
│   ├── steam_scam.jpg
│   └── ...
├── index.js
└── package.json

Le plugin tolère les légères modifications d'une image (recadrage, compression JPEG, changement de taille) grâce au hash perceptuel.

Options

Images bannies

| Option | Type | Défaut | Description | |--------|------|--------|-------------| | bannedImagesDir | string | ./banned_images | Chemin vers le dossier d'images de référence | | bannedImagesThreshold | number | 0.3125 | Distance max normalisée (0-1) pour un match (0 = identique, plus élevé = plus tolérant) | | bannedImagesScore | number | 50 | Score ajouté au résultat si une image bannie est détectée |

OCR

| Option | Type | Défaut | Description | |--------|------|--------|-------------| | ocrEnabled | boolean | true | Active l'OCR sur les images | | ocrLang | string | 'fra+eng' | Langues tesseract.js | | maxOcrLength | number | 2000 | Longueur max du texte OCR extrait | | noTextBonus | number | 10 | Bonus ajouté si des mots-clés sont trouvés uniquement via l'OCR (message sans texte) |

Mots-clés et URLs

| Option | Type | Défaut | Description | |--------|------|--------|-------------| | keywords | Array | [] | Liste de mots-clés pondérés | | whitelist | string[] | [] | Domaines de confiance pour les URLs | | checkDomainAge | boolean | true | Active la vérification whois de l'âge du domaine |

Vérification du compte Discord

| Option | Type | Défaut | Description | |--------|------|--------|-------------| | accountAgeDays | number | 30 | Seuil d'ancienneté du compte Discord (en jours) | | accountAgeScore | number | 15 | Score ajouté si le compte est plus récent que le seuil | | joinAgeDays | number | 7 | Seuil d'ancienneté d'arrivée sur le serveur (en jours) | | joinAgeScore | number | 15 | Score ajouté si le membre a rejoint le serveur récemment | | noAvatarScore | number | 5 | Score ajouté si le compte n'a pas d'avatar global | | suspiciousUsernameScore | number | 10 | Score ajouté si le pseudo correspond à un pattern suspect (mot+chiffres, chaîne aléatoire) | | noRolesScore | number | 5 | Score ajouté si le membre n'a aucun rôle attribué | | noServerAvatarScore | number | 3 | Score ajouté si le membre n'a pas d'avatar spécifique au serveur |

Signaux comportementaux

| Option | Type | Défaut | Description | |--------|------|--------|-------------| | firstInteractionScore | number | 10 | Score ajouté à la première interaction connue de l'utilisateur | | imageOnlyScore | number | 10 | Score ajouté si le message contient une image sans texte | | crosspostScore | number | 20 | Score ajouté si le même texte est posté dans plusieurs salons | | crosspostWindow | number | 300000 | Fenêtre de temps (ms) pour la détection de crosspost par texte | | crosspostMinChannels | number | 2 | Nombre minimum de salons pour déclencher le crosspost par texte | | attachmentCrosspostScore | number | 40 | Score ajouté si le même nombre de pièces jointes est posté sur plusieurs salons en peu de temps | | attachmentCrosspostWindow | number | 60000 | Fenêtre de temps (ms) pour la détection de crosspost par pièces jointes | | attachmentCrosspostMinChannels | number | 2 | Nombre minimum de salons pour déclencher le crosspost par pièces jointes |

Résultat retourné

{
  score: 65,
  imageFlag: {
    banned: {
      matched: "nitro_fake.png",  // nom du fichier de référence
      distance: 8,                // distance de Hamming
      similarity: 95.2            // similarité en %
    }
  },
  factors: [
    "banned_image (nitro_fake.png, 95.2%)",
    "account_age_3d (+15)",
    "attachment_crosspost_1f_3ch (+40)"
  ],
  ocrText: "Réclame ton Nitro gratuit ici..."
}

Dépendances

| Package | Utilisation | |---------|-------------| | jimp | Lecture et décodage des images | | blockhash | Calcul du hash perceptuel | | axios | Téléchargement des images | | tesseract.js | OCR sur les images |

Prérequis

• Node.js >= 18.0.0
• Discord.js v14+