Netcraft API Client

Cliente de API de redes

Este script de Python proporciona una interfaz de línea de comandos para interactuar con la API de NetCraft. Permite a los usuarios realizar diversas acciones, como informar URL maliciosas, correos electrónicos maliciosos y URL bloqueadas incorrectamente, así como recuperar detalles sobre los informes enviados.

Características

• Informar una sola URL
• Informar múltiples URL de un archivo
• Informe un correo electrónico malicioso (con contraseña opcional para el descifrado)
• Informar una URL bloqueada incorrectamente
• Obtener detalles de un informe enviado
• Descargar archivos asociados con un informe enviado
• Obtenga URL asociadas con un informe enviado
• Informe un problema con un informe enviado (por ejemplo, clasificaciones erróneas de archivo o URL)
• Obtenga etiquetas disponibles para informes de archivos, correo o URL
• Cancelar la suscripción de los correos electrónicos de notificación

☕ Apoye mi trabajo en Ko-Fi

Requisitos previos

• Python 3.x
• Biblioteca requests (instalar Uso de pip install requests )

Únete a mi servidor de discordias

Uso

1. Clon o descargar el repositorio.
2. Navegue al directorio del proyecto.
3. Ejecute el script usando python main.py
4. Siga las indicaciones en la interfaz de línea de comandos para realizar las acciones deseadas.

Uso de ejemplo: luego, siga las opciones de menú y proporcione las entradas requeridas.

Documentación de funciones

report_single_url(email, message, url)

Reporta una sola URL a la API de Netcraft.

• email : la dirección de correo electrónico del remitente.
• message : un mensaje opcional para incluir con el informe.
• url : La URL se informará.

report_urls_from_file(email, message, file_path)

Informa múltiples URL de un archivo a la API de NetCraft.

• email : la dirección de correo electrónico del remitente.
• message : un mensaje opcional para incluir con el informe.
• file_path : la ruta al archivo que contiene las URL (una URL por línea).

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

Informa un correo electrónico malicioso a la API de Netcraft.

• email : la dirección de correo electrónico del remitente.
• message : un mensaje opcional para incluir con el informe.
• mail_content : el contenido del correo electrónico malicioso en formato MIME.
• password : una contraseña opcional para descifrar el correo electrónico (si corresponde).

report_incorrectly_blocked_url(email, url, reason)

Informa una URL bloqueada incorrectamente a la API de Netcraft.

• email : la dirección de correo electrónico del remitente.
• url : La URL que estaba bloqueada incorrectamente.
• reason : la razón para informar la URL bloqueada incorrectamente.

get_submission_details(uuid)

Recupera los detalles de un informe enviado y los guarda en un archivo JSON.

• uuid : El UUID del informe enviado.

get_submission_files(uuid)

Descarga los archivos asociados con un informe enviado.

• uuid : El UUID del informe enviado.

get_submission_urls(uuid)

Recupera las URL asociadas con un informe enviado y los guarda a un archivo JSON.

• uuid : El UUID del informe enviado.

report_submission_issue(uuid, file_misclassifications, url_misclassifications, additional_info)

Informa un problema con un informe enviado, como clasificaciones erróneas de archivo o URL.

• uuid : El UUID del informe enviado.
• file_misclassifications : una lista de nombres de archivos erróneos.
• url_misclassifications : una lista de URL mal clasificadas.
• additional_info : información adicional sobre el problema.

get_available_tags(tag_type)

Recupera las etiquetas disponibles para informes de archivos, correo o URL.

• tag_type : el tipo de etiquetas para recuperar ('archivo', 'mail' o 'url').

unsubscribe_from_notifications(email, csrf_token)

Den suscribir la dirección de correo electrónico proporcionada de los correos electrónicos de notificación.

• email : la dirección de correo electrónico para cancelar la suscripción.
• csrf_token : el token CSRF requerido para darse de baja.

Que contribuye

¡Las contribuciones son bienvenidas! Si encuentra algún problema o tiene sugerencias de mejoras, abra un problema o envíe una solicitud de extracción.

Licencia

Este proyecto tiene licencia bajo la licencia MIT.