Netcraft API Client

Client de l'API Netcraft

Ce script Python fournit une interface de ligne de commande pour interagir avec l'API NetCraft. Il permet aux utilisateurs d'effectuer diverses actions telles que la signalement des URL malveillantes, des e-mails malveillants et des URL incorrectement bloqués, ainsi que la récupération de détails sur les rapports soumis.

Caractéristiques

• Signaler une seule URL
• Signaler plusieurs URL à partir d'un fichier
• Signaler un e-mail malveillant (avec un mot de passe facultatif pour le décryptage)
• Signaler une URL incorrectement bloquée
• Obtenez les détails d'un rapport soumis
• Télécharger des fichiers associés à un rapport soumis
• Obtenez des URL associées à un rapport soumis
• Signalez un problème avec un rapport soumis (par exemple, les classifications de fichiers ou d'URL)
• Obtenez des balises disponibles pour les rapports de fichiers, de courrier ou d'URL
• Se désinscrire des e-mails de notification

☕ Soutenir mon travail sur le ko-fi

Condition préalable

• Python 3.x
• Bibliothèque requests (installer à l'aide pip install requests )

Rejoignez mon serveur Discord

Usage

1. Clone ou télécharger le référentiel.
2. Accédez au répertoire du projet.
3. Exécutez le script à l'aide de python main.py
4. Suivez les invites dans l'interface de ligne de commande pour effectuer les actions souhaitées.

Exemple d'utilisation: Ensuite, suivez les options de menu et fournissez les entrées requises.

Documentation de fonction

report_single_url(email, message, url)

Rapporte une URL unique à l'API NetCraft.

• email : l'adresse e-mail du candidat.
• message : un message facultatif à inclure avec le rapport.
• url : L'URL à signaler.

report_urls_from_file(email, message, file_path)

Rapporte plusieurs URL d'un fichier à l'API NetCraft.

• email : l'adresse e-mail du candidat.
• message : un message facultatif à inclure avec le rapport.
• file_path : le chemin du fichier contenant les URL (une URL par ligne).

report_malicious_mail(email, message, mail_content, password=None)

Signale un e-mail malveillant à l'API Netcraft.

• email : l'adresse e-mail du candidat.
• message : un message facultatif à inclure avec le rapport.
• mail_content : le contenu de l'e-mail malveillant au format MIME.
• password : un mot de passe facultatif pour décrypter l'e-mail (le cas échéant).

report_incorrectly_blocked_url(email, url, reason)

Signale une URL incorrectement bloquée à l'API NetCraft.

• email : l'adresse e-mail du candidat.
• url : L'URL qui a été incorrectement bloquée.
• reason : la raison de la signalement de l'URL incorrectement bloquée.

get_submission_details(uuid)

Récupère les détails d'un rapport soumis et les enregistre dans un fichier JSON.

• uuid : L'UUID du rapport soumis.

get_submission_files(uuid)

Télécharge les fichiers associés à un rapport soumis.

• uuid : L'UUID du rapport soumis.

get_submission_urls(uuid)

Récupère les URL associées à un rapport soumis et les enregistre à un fichier JSON.

• uuid : L'UUID du rapport soumis.

report_submission_issue(uuid, file_misclassifications, url_misclassifications, additional_info)

Signale un problème avec un rapport soumis, tel que les classifications de fichiers ou d'URL.

• uuid : L'UUID du rapport soumis.
• file_misclassifications : une liste des noms de fichiers mal classés.
• url_misclassifications : une liste des URL mal classées.
• additional_info : Informations supplémentaires sur le problème.

get_available_tags(tag_type)

Récupère les balises disponibles pour les rapports de fichiers, de courrier ou d'URL.

• tag_type : le type de balises à récupérer («fichier», «mail» ou «url»).

unsubscribe_from_notifications(email, csrf_token)

Débranche l'adresse e-mail fournie à partir des e-mails de notification.

• email : l'adresse e-mail pour se désabonner.
• csrf_token : Le jeton CSRF requis pour se désabonner.

Contributif

Les contributions sont les bienvenues! Si vous trouvez des problèmes ou avez des suggestions d'amélioration, veuillez ouvrir un problème ou soumettre une demande de traction.

Licence

Ce projet est autorisé sous la licence du MIT.