Netcraft API Client

NETCRAFT -API -Client

Dieses Python-Skript bietet eine Befehlszeilenschnittstelle für die Interaktion mit der NetCraft-API. Es ermöglicht Benutzern, verschiedene Aktionen wie die Berichterstattung über böswillige URLs, böswillige E -Mails und fälschlicherweise blockierte URLs auszuführen sowie Details zu eingereichten Berichten abzurufen.

Merkmale

• Melden Sie eine einzige URL
• Melden Sie mehrere URLs aus einer Datei
• Melden Sie eine böswillige E -Mail (mit optionalem Passwort für die Entschlüsselung)
• Melden Sie eine falsch blockierte URL
• Holen Sie sich Einzelheiten zu einem eingereichten Bericht
• Laden Sie Dateien herunter, die mit einem eingereichten Bericht zugeordnet sind
• Lassen Sie URLs mit einem eingereichten Bericht zugeordnet
• Melden Sie ein Problem mit einem eingereichten Bericht (z. B. Fehlklassifizierungen für Dateien oder URL).
• Erhalten Sie verfügbare Tags für Datei-, Mail- oder URL -Berichte
• Abbestellen von Benachrichtigungs -E -Mails abmelden

☕ Unterstützen Sie meine Arbeit an Ko-Fi

Voraussetzungen

• Python 3.x
• requests (installieren Sie mit pip install requests )

Trete meinem Discord -Server bei

Verwendung

1. Klonen oder Laden Sie das Repository herunter.
2. Navigieren Sie zum Projektverzeichnis.
3. Führen Sie das Skript mit python main.py aus.
4. Befolgen Sie die Eingabeaufforderungen in der Befehlszeilenschnittstelle, um die gewünschten Aktionen auszuführen.

Beispiel Verwendung: Befolgen Sie dann die Menüoptionen und geben Sie die erforderlichen Eingänge an.

Funktionsdokumentation

report_single_url(email, message, url)

Meldet eine einzige URL für die Netcraft -API.

• email : Die E -Mail -Adresse des Subschritts.
• message : Eine optionale Nachricht, die in den Bericht einbezogen werden soll.
• url : Die zu gemeldete URL.

report_urls_from_file(email, message, file_path)

Meldet mehrere URLs von einer Datei zur NetCraft -API.

• email : Die E -Mail -Adresse des Subschritts.
• message : Eine optionale Nachricht, die in den Bericht einbezogen werden soll.
• file_path : Der Pfad zur Datei mit den URLs (eine URL pro Zeile).

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

Meldet eine böswillige E -Mail an die Netcraft -API.

• email : Die E -Mail -Adresse des Subschritts.
• message : Eine optionale Nachricht, die in den Bericht einbezogen werden soll.
• mail_content : Der Inhalt der böswilligen E -Mail im MIME -Format.
• password : Ein optionales Passwort zum Entschlüsseln der E -Mail (falls zutreffend).

report_incorrectly_blocked_url(email, url, reason)

Meldet eine fälschlicherweise blockierte URL an der Netcraft -API.

• email : Die E -Mail -Adresse des Subschritts.
• url : Die URL, die falsch blockiert wurde.
• reason : Der Grund für die Meldung der falsch blockierten URL.

get_submission_details(uuid)

Ruft die Details eines eingereichten Berichts ab und speichert sie einer JSON -Datei.

• uuid : Die UUID des eingereichten Berichts.

get_submission_files(uuid)

Laden Sie die mit einem eingereichten Bericht zugeordneten Dateien herunter.

• uuid : Die UUID des eingereichten Berichts.

get_submission_urls(uuid)

Ruft die URLs ab, die mit einem eingereichten Bericht zugeordnet sind, und speichert sie einer JSON -Datei.

• uuid : Die UUID des eingereichten Berichts.

report_submission_issue(uuid, file_misclassifications, url_misclassifications, additional_info)

Meldet ein Problem mit einem eingereichten Bericht, z. B. Datei- oder URL -Fehlklassifizierungen.

• uuid : Die UUID des eingereichten Berichts.
• file_misclassifications : Eine Liste von falsch klassifizierten Dateinamen.
• url_misclassifications : Eine Liste falsch klassifizierter URLs.
• additional_info : Zusätzliche Informationen zum Problem.

get_available_tags(tag_type)

Ruft die verfügbaren Tags für Datei-, E -Mail- oder URL -Berichte ab.

• tag_type : Die Art der Tags zum Abrufen ('Datei', 'Mail' oder 'URL').

unsubscribe_from_notifications(email, csrf_token)

Schreibt die bereitgestellte E -Mail -Adresse aus Benachrichtigungs -E -Mails ab.

• email : Die E -Mail -Adresse zum Abbestellen.
• csrf_token : Das CSRF -Token, das für die Abmeldung erforderlich ist.

Beitragen

Beiträge sind willkommen! Wenn Sie Probleme finden oder Vorschläge für Verbesserungen haben, öffnen Sie bitte ein Problem oder senden Sie eine Pull -Anfrage.

Lizenz

Dieses Projekt ist unter der MIT -Lizenz lizenziert.