Que fait ip-purity-check ?
Compétence Claude : cette IP / ASN / MAC / domaine est-elle propre, sûre et fiable ? Notation hors ligne + API optionnelle.
Présentation
Cette compétence permet à un agent IA d'évaluer la réputation d'une adresse IP, d'un ASN, d'une adresse MAC ou d'un nom de domaine. Elle combine une analyse hors ligne (basée sur des listes noires, plages réservées, réseaux malveillants, etc.) avec une vérification optionnelle via une API externe pour obtenir une note de confiance.
Utilisation
- L'agent reçoit une entité (IP, ASN, MAC, domaine) à vérifier.
- La compétence effectue une première notation hors ligne en consultant des sources locales.
- Si une API externe est configurée, elle envoie une requête pour obtenir des informations supplémentaires.
- Le résultat est un score de pureté (0-100) et une liste de raisons ou de sources.
Configuration
- Aucune dépendance externe obligatoire.
- Pour utiliser l'API optionnelle, définissez la variable d'environnement
IP_PURITY_API_KEY. - Les sources hors ligne sont mises à jour périodiquement (voir
data/dans le dépôt).
Exemple
# Vérification simple par l'agent
> Vérifie l'adresse IP 8.8.8.8
# Résultat : Score 95/100 (IP fiable, serveur DNS public connu)
> Vérifie le domaine example-malveillant.com
# Résultat : Score 10/100 (domaine signalé sur liste noire)
Formats supportés
- IPv4 : ex. 192.168.1.1
- IPv6 : ex. 2001:db8::1
- ASN : ex. AS15169
- MAC : ex. 00:11:22:33:44:55
- Domaine : ex. example.com