socialscan

socialscan bietet präzise und schnelle Prüfungen für E-Mail-Adressen und Benutzernamen auf Online-Plattformen.

Mit einer E-Mail-Adresse oder einem Benutzernamen gibt socialscan zurück, ob dieser auf Online-Plattformen verfügbar, belegt oder ungültig ist.

Merkmale, die socialscan von ähnlichen Tools (z. B. knowem.com, Namechk und Sherlock) unterscheiden:

1. 100% Genauigkeit: Die Abfragemethode von socialscan eliminiert die Fehlalarme und Falschmeldungen, die bei ähnlichen Tools häufig auftreten, und stellt sicher, dass die Ergebnisse immer korrekt sind.

2. Geschwindigkeit: socialscan verwendet asyncio zusammen mit aiohttp, um alle Abfragen gleichzeitig durchzuführen, was schnelle Suchen auch bei Massenabfragen mit Hunderten von Benutzernamen und E-Mail-Adressen ermöglicht. Auf einem Testcomputer mit durchschnittlicher Ausstattung und Internetgeschwindigkeit wurden 100 Abfragen in etwa 4 Sekunden ausgeführt.

3. Bibliothek / CLI: socialscan kann über eine CLI ausgeführt oder als Python-Bibliothek importiert werden, um mit vorhandenem Code verwendet zu werden.

4. E-Mail-Unterstützung: socialscan unterstützt Abfragen sowohl für E-Mail-Adressen als auch für Benutzernamen.

Die folgenden Plattformen werden derzeit unterstützt:

Hintergrund

Andere ähnliche Tools prüfen die Verfügbarkeit von Benutzernamen, indem sie die Profilseite des betreffenden Benutzernamens anfordern und anhand von Informationen wie dem HTTP-Statuscode oder dem Fehlertext auf der angeforderten Seite feststellen, ob ein Benutzername bereits vergeben ist. Dies ist ein naiver Ansatz, der in folgenden Fällen versagt:

• Reservierte Schlüsselwörter: Die meisten Plattformen haben eine Reihe von Schlüsselwörtern, die sie in Benutzernamen nicht zulassen
  (Ein einfacher Test: Versuchen Sie, reservierte Wörter wie 'admin' oder 'home' oder 'root' zu prüfen, und sehen Sie, ob andere Dienste sie als verfügbar markieren)

• Gelöschte/gesperrte Konten: Benutzernamen von gelöschten/gesperrten Konten sind in der Regel nicht verfügbar, auch wenn die Profilseiten möglicherweise nicht existieren

Daher neigen diese Tools zu Fehlalarmen und Falschmeldungen. Diese Prüfmethode ist auch davon abhängig, dass die Plattformen webbasierte Profilseiten haben, und kann nicht auf E-Mail-Adressen ausgeweitet werden.

socialscan zielt darauf ab, diese Lücken zu schließen, indem es stattdessen direkt die Registrierungsserver der Plattformen abfragt und die entsprechenden CSRF-Tokens, Header und Cookies abruft.

Installation

pip

> pip install socialscan

Install from source

> git clone https://github.com/iojw/socialscan.git  
> cd socialscan  
> pip install .

Usage

usage: socialscan [list of usernames/email addresses to check]

optional arguments:
  -h, --help            show this help message and exit
  --platforms [platform [platform ...]], -p [platform [platform ...]]
                        list of platforms to query (default: all platforms)
  --view-by {platform,query}
                        view results sorted by platform or by query (default:
                        query)
  --available-only, -a  only print usernames/email addresses that are
                        available and not in use
  --cache-tokens, -c    cache tokens for platforms requiring more than one
                        HTTP request (Snapchat, GitHub, Instagram. Lastfm &
                        Tumblr), reducing total number of requests sent
  --input input.txt, -i input.txt
                        file containg list of queries to execute
  --proxy-list proxy_list.txt
                        file containing list of HTTP proxy servers to execute
                        queries with
  --verbose, -v         show query responses as they are received
  --show-urls           display profile URLs for usernames on supported platforms
                        (profiles may not exist if usernames are reserved or belong to deleted/banned accounts)
  --json json.txt       output results in JSON format to the specified file
  --version             show program's version number and exit

Als Bibliothek

socialscan kann auch in vorhandenen Code importiert und als Bibliothek verwendet werden.

v1.0.0 führt die asynchrone Methode execute_queries und den entsprechenden synchronen Wrapper sync_execute_queries ein, der eine Liste von Abfragen und eine optionale Liste von Plattformen und Proxys entgegennimmt und alle Abfragen gleichzeitig ausführt. Die Methode gibt dann eine Liste von Ergebnissen in derselben Reihenfolge zurück.

from socialscan.util import Platforms, sync_execute_queries

queries = ["username1", "[email protected]", "[email protected]"]
platforms = [Platforms.GITHUB, Platforms.LASTFM]
results = sync_execute_queries(queries, platforms)
for result in results:
    print(f"{result.query} on {result.platform}: {result.message} (Success: {result.success}, Valid: {result.valid}, Available: {result.available})")

Output:

username1 auf GitHub: Benutzername ist bereits vergeben (Success: True, Valid: True, Available: False)
username1 auf Lastfm: Entschuldigung, dieser Benutzername ist nicht verfügbar. (Success: True, Valid: True, Available: False)
[email protected] auf GitHub: Verfügbar (Success: True, Valid: True, Available: True)
[email protected] auf Lastfm: Entschuldigung, diese E-Mail-Adresse ist bereits mit einem anderen Konto registriert. (Success: True, Valid: True, Available: False)
[email protected] auf GitHub: Verfügbar (Success: True, Valid: True, Available: True)
[email protected] auf Lastfm: Sieht gut aus! (Success: True, Valid: True, Available: True)

Textdatei-Eingabe

Für Massenabfragen mit der Option --input platzieren Sie einen Benutzernamen/eine E-Mail pro Zeile in der .txt-Datei:

username1
[email protected]
username3

Spenden

Wenn Sie dieses Tool nützlich finden und seine Weiterentwicklung unterstützen möchten, können Sie hier spenden. Vielen Dank für Ihre Unterstützung.

BTC: bc1qwrnukyc6xh9aygu5ps2geh8stmvagsj5u4v7j6
ETH: 0x45a0F91666391078eA521A6123559E49DAb1275f

Mitwirken

Fehler, Vorschläge oder möchten Sie eine Seite hinzugefügt haben? Reichen Sie ein Issue ein.

PRs sind immer willkommen 🙂

Bitte stellen Sie sicher, dass der Code vor dem Einreichen eines PR mit black unter Verwendung der Konfiguration in pyproject.toml formatiert ist.

Lizenz

MPL 2.0