Netcraft API Client

NetCraft API Client

Este script Python fornece uma interface de linha de comando para interagir com a API do NetCraft. Ele permite que os usuários executem várias ações, como relatar URLs maliciosos, e -mails maliciosos e URLs bloqueados incorretamente, além de recuperar detalhes sobre os relatórios enviados.

Características

• Relate um único URL
• Relatar vários URLs de um arquivo
• Relate um e -mail malicioso (com senha opcional para descriptografia)
• Relatar um URL bloqueado incorretamente
• Obtenha detalhes de um relatório enviado
• Baixar arquivos associados a um relatório enviado
• Obtenha URLs associados a um relatório enviado
• Relate um problema com um relatório enviado (por exemplo, arquivo ou URL de classificação incorreta)
• Obtenha tags disponíveis para relatórios de arquivo, correio ou URL
• Cancelar a inscrição de e -mails de notificação

☕ Apoie meu trabalho em Ko-Fi

Pré -requisitos

• Python 3.x
• Biblioteca requests (instale usando pip install requests )

Junte -se ao meu servidor Discord

Uso

1. Clone ou faça o download do repositório.
2. Navegue até o diretório do projeto.
3. Execute o script usando python main.py
4. Siga os prompts na interface da linha de comando para executar as ações desejadas.

Exemplo de uso: depois, siga as opções de menu e forneça as entradas necessárias.

Documentação da função

report_single_url(email, message, url)

Relata um único URL à API da Netcraft.

• email : o endereço de e -mail do envio.
• message : Uma mensagem opcional a ser incluída no relatório.
• url : O URL a ser relatado.

report_urls_from_file(email, message, file_path)

Relata vários URLs de um arquivo para a API Netcraft.

• email : o endereço de e -mail do envio.
• message : Uma mensagem opcional a ser incluída no relatório.
• file_path : o caminho para o arquivo que contém os URLs (um URL por linha).

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

Relata um email malicioso à API da Netcraft.

• email : o endereço de e -mail do envio.
• message : Uma mensagem opcional a ser incluída no relatório.
• mail_content : o conteúdo do e -mail malicioso em formato MIME.
• password : uma senha opcional para descriptografar o email (se aplicável).

report_incorrectly_blocked_url(email, url, reason)

Relata um URL bloqueado incorretamente à API da Netcraft.

• email : o endereço de e -mail do envio.
• url : O URL que foi bloqueado incorretamente.
• reason : o motivo para relatar o URL bloqueado incorretamente.

get_submission_details(uuid)

Recupera os detalhes de um relatório enviado e os salva em um arquivo JSON.

• uuid : O UUID do relatório enviado.

get_submission_files(uuid)

Downloads os arquivos associados a um relatório enviado.

• uuid : O UUID do relatório enviado.

get_submission_urls(uuid)

Recupera os URLs associados a um relatório enviado e os salva para um arquivo JSON.

• uuid : O UUID do relatório enviado.

report_submission_issue(uuid, file_misclassifications, url_misclassifications, additional_info)

Relata um problema com um relatório enviado, como classificações incorretas de arquivo ou URL.

• uuid : O UUID do relatório enviado.
• file_misclassifications : Uma lista de nomes de arquivos classificados incorretamente.
• url_misclassifications : Uma lista de URLs classificados incorretamente.
• additional_info : informações adicionais sobre o problema.

get_available_tags(tag_type)

Recupera as tags disponíveis para relatórios de arquivo, correio ou URL.

• tag_type : o tipo de tags a recuperar ('arquivo', 'email' ou 'url').

unsubscribe_from_notifications(email, csrf_token)

Desfrua inscrição no endereço de e -mail fornecido dos e -mails de notificação.

• email : o endereço de e -mail para cancelar a inscrição.
• csrf_token : o token CSRF necessário para cancelar a inscrição.

Contribuindo

As contribuições são bem -vindas! Se você encontrar algum problema ou ter sugestões de melhorias, abra um problema ou envie uma solicitação de tração.

Licença

Este projeto está licenciado sob a licença do MIT.