soxoj/maigret🕵️♂️ Erstelle ein Dossier über eine Person anhand des Benutzernamens aus 6K Websites
# Maigret
<div align="center">
<div>
<a href="https://pypi.org/project/maigret/">
<img alt="PyPI version badge for Maigret" src="https://img.shields.io/pypi/v/maigret?style=flat-square" />
</a>
<a href="https://pepy.tech/project/maigret">
<img alt="Total downloads" src="https://static.pepy.tech/badge/maigret" />
<img alt="Downloads/month" src="https://static.pepy.tech/badge/maigret/month" />
</a>
</div>
<div>
<a href="https://github.com/soxoj/maigret">
<img alt="View count for Maigret project" src="https://komarev.com/ghpvc/?username=maigret&color=brightgreen&label=views&style=flat-square" />
</a>
<a href="https://github.com/soxoj/maigret">
<img alt="Minimum Python version required: 3.10+" src="https://img.shields.io/badge/Python-3.10+-brightgreen?style=flat-square" />
</a>
<a href="https://github.com/soxoj/maigret/blob/main/LICENSE">
<img alt="License badge for Maigret" src="https://img.shields.io/github/license/soxoj/maigret?style=flat-square" />
</a>
<a href="https://maigret.readthedocs.io/">
<img alt="Maigret documentation" src="https://img.shields.io/readthedocs/maigret?style=flat-square&label=docs" />
</a>
</div>
<br>
<div>
<img src="https://assets.kitploit.com/production/public/readmes/216/f4ea992b7e00fe5e906d35323dd806650b89309c635ef77372bc1f8e497950f7.png" height="300" alt="Maigret logo"/>
</div>
<br>
<div>
<a href="https://codewiki.google/github.com/soxoj/maigret">
<img alt="Ask Code Wiki about Maigret" src="https://img.shields.io/badge/Code_Wiki-ask_about_repo-yellow?logo=googlegemini" />
</a>
<a href="https://deepwiki.com/soxoj/maigret">
<img alt="Ask DeepWiki about Maigret" src="https://img.shields.io/badge/DeepWiki-ask_about_repo-yellow" />
</a>
</div>
<br>
<div>
<b>English</b> · <a href="https://github.com/soxoj/maigret/blob/main/README.zh-CN.md">简体中文</a> · <a href="https://github.com/soxoj/maigret/blob/main/README.fr.md">Français</a>
</div>
<br>
<div>
📖 <a href="https://maigret.readthedocs.io/"><b>Documentation</b></a>
</div>
<br>
</div>
**Maigret** erstellt ein Dossier über eine Person **allein anhand des Benutzernamens**, indem es Konten auf einer Vielzahl von Websites prüft und alle verfügbaren Informationen von Webseiten sammelt. Es sind keine API-Schlüssel erforderlich. **[KI-Profiling (Demo)](#ai-analysis)**.
## Sponsoren
<p align="center">
<a href="https://noimosiny.com/?utm_campaign=maigret&utm_source=github">
<img width="600" alt="Noimosiny" src="https://github.com/user-attachments/assets/cef16613-4337-47a3-9105-2621197b17d1" />
</a>
</p>
<p>
<a href="https://noimosiny.com/?utm_campaign=maigret&utm_source=github"><b>Noimosiny</b></a> ist eine umfassende OSINT-Plattform für professionelle Ermittler und Analysten. Reverse-E-Mail-, Telefonnummern- und Benutzernamenssuche über 250+ Module. Automatisieren Sie Ihre Informationsbeschaffung mit unseren leistungsstarken Tools.
</p>
<br>
<p align="center">
<a href="https://www.rapidproxy.io/?ref=soxoj">
<img src="https://assets.kitploit.com/production/public/readmes/216/d0d5d0f98e98ee2bae78bf2fc510e47089760ef9ce72121edc7ce6de19295d9f.jpg" width="500" alt="RapidProxy">
</a>
</p>
<p>
<a href="https://www.rapidproxy.io/?ref=soxoj"><b>RapidProxy</b></a> bietet leistungsstarke Residential-Proxys für Twitter-Scraping, Selenium-Automatisierung und Web-Datenextraktion. 90M+ IPs • Intelligente Rotation • Anti-Block • Nicht ablaufender Traffic. <br>
<b>Sonderangebot</b>: Kostenlos testen — Tarife ab $0,65/GB. Verwenden Sie den Code <b>RAPID10</b> für 10% Rabatt.
</p>
<p align="center">
<a href="https://mangoproxy.com/?utm_source=soxoj&utm_medium=partner&utm_campaign=soxoj_github">
<img src="https://github.com/user-attachments/assets/146b6b95-06ae-4fda-bff2-d94946cf7c2e" width="300" alt="MangoProxy">
</a>
</p>
<p>
<a href="https://mangoproxy.com/?utm_source=soxoj&utm_medium=partner&utm_campaign=soxoj_github"><b>MangoProxy</b></a> ist ein Residential-, ISP-, Mobile- und Datacenter-Proxy-Dienst, der für professionelle Aufgaben entwickelt wurde, bei denen Stabilität, Geschwindigkeit und Anonymität wichtig sind. <br>
<b>Promo-Code</b>: SOXOJ - 8% Rabatt auf Static-ISP-Proxys
</p>
<p align="center">
<a href="https://www.thordata.com/?ls=dmt&lk=dmt">
<img src="https://github.com/user-attachments/assets/6d92bda0-c953-49b5-ab7e-73b0e67f17e2" width="350" alt="Thordata">
</a>
</p>
<p>
<a href="https://www.thordata.com/?ls=dmt&lk=dmt"><b>Thordata</b></a>
</a> bietet zuverlässige Residential-Proxys für OSINT-Recherche, Benutzernamenssuche und Workflows zur Sammlung öffentlicher Daten.
Zugriff auf <b>100M+ echte Residential-IPs</b> in <b>195+ Ländern</b> <b>unbegrenzte gleichzeitige Verbindungen</b> mit 99,99% Uptime und stabilen Verbindungen, Rotating + Sticky Sessions und hohen Erfolgsraten.
<br>
<b>Sonderangebot:</b> Kostenlose 3-Tage-Testversion + <b>10% RABATT</b> mit dem Code <b>SOXOJ10</b>.
</p>
## Inhalt
- [In einer Minute](#in-one-minute)
- [Hauptfunktionen](#main-features)
- [Demo](#demo)
- [Installation](#installation)
- [Verwendung](#usage)
- [Mitwirken](#contributing)
- [Kommerzielle Nutzung](#commercial-use)
- [Über](#about)
<a id="one-minute"></a>
## In einer Minute
Stellen Sie sicher, dass Sie Python 3.10 oder höher haben.
```bash
pip install maigret
maigret YOUR_USERNAME
```
Keine Installation? Probieren Sie den [Community-Telegram-Bot](https://maigret.app/readme-en) oder eine [Cloud Shell](#cloud-shells) aus.
Möchten Sie eine Web-UI? Siehe [wie man sie startet](#web-interface).
Siehe auch: [Schnellstart](https://maigret.readthedocs.io/en/latest/quick-start.html).
## Hauptfunktionen
- Unterstützt 5.900 Websites ([vollständige Liste anzeigen](https://github.com/soxoj/maigret/blob/main/sites.md)). Ein Standardlauf prüft die 500 am höchsten bewerteten Websites nach Traffic; übergeben Sie `-a`, um alles zu scannen, oder `--tags`, um nach Kategorie/Land einzugrenzen.
- Einbettbar in Python-Projekte — importieren Sie `maigret` und führen Sie Suchen programmatisch aus (siehe [Bibliotheksnutzung](https://maigret.readthedocs.io/en/latest/library-usage.html)).
- [Extrahiert](https://github.com/soxoj/socid_extractor) alle verfügbaren Informationen über den Kontoinhaber aus Profilseiten und Website-APIs, einschließlich Links zu anderen Konten.
- Führt rekursive Suchen mit entdeckten Benutzernamen und anderen IDs durch.
- Ermöglicht Filterung nach Tags (Website-Kategorien, Länder).
- Erkennt und umgeht teilweise Blockierungen, Zensur und CAPTCHAs.
- Ruft bei jedem Lauf eine [automatisch aktualisierte Website-Datenbank](https://maigret.readthedocs.io/en/latest/settings.html#database-auto-update) von GitHub ab (einmal pro 24 Stunden) und greift offline auf die integrierte Datenbank zurück.
- Funktioniert mit Tor- und I2P-Websites; kann Domains prüfen.
- Wird mit einer [Web-Oberfläche](#web-interface) geliefert, um Ergebnisse als Graph zu durchsuchen und Berichte in jedem Format von einer einzigen Seite herunterzuladen.
- Optionaler [KI-Analysemodus](#ai-analysis) (`--ai`), der Rohdaten in eine kurze Untersuchungszusammenfassung mittels einer OpenAI-kompatiblen API umwandelt.
Die vollständige Funktionsliste finden Sie in der [Funktionsdokumentation](https://maigret.readthedocs.io/en/latest/features.html).
### Verwendet von
Professionelle OSINT- und Social-Media-Analyse-Tools, die auf Maigret aufbauen:
<a href="https://github.com/SocialLinks-IO/sociallinks-api"><img height="60" alt="Social Links API" src="https://assets.kitploit.com/production/public/readmes/216/e4e6afb8670aa5d3b703f1073907398ff6cc84031b15f4108bf1da37e01ab023.png"></a>
<a href="https://sociallinks.io/products/sl-crimewall"><img height="60" alt="Social Links Crimewall" src="https://assets.kitploit.com/production/public/readmes/216/fc0028a249da7498721b8783b585545203c93a3e51de565f4d27aa9a71882743.png"></a>
<a href="https://usersearch.ai/"><img height="60" alt="UserSearch" src="https://assets.kitploit.com/production/public/readmes/216/e0b60e01a3af3ac089eebc120d9627aeb0cbf3d9ee68c4f62e8d1e46fa5df5ad.png"></a>
## Demo
### Video
<a href="https://asciinema.org/a/Ao0y7N0TTxpS0pisoprQJdylZ">
<img src="https://asciinema.org/a/Ao0y7N0TTxpS0pisoprQJdylZ.svg" alt="asciicast" width="600">
</a>
### Berichte
[PDF-Bericht](https://raw.githubusercontent.com/soxoj/maigret/main/static/report_alexaimephotographycars.pdf), [HTML-Bericht](https://htmlpreview.github.io/?https://raw.githubusercontent.com/soxoj/maigret/main/static/report_alexaimephotographycars.html)
[Vollständige Konsolenausgabe](https://raw.githubusercontent.com/soxoj/maigret/main/static/recursive_search.md)
## Installation
Haben Sie bereits die Schritte aus [In einer Minute](#one-minute) ausgeführt? Dann sind Sie fertig. Im Folgenden finden Sie alternative Methoden.
Möchten Sie nichts installieren? Verwenden Sie den [Community-Telegram-Bot](https://maigret.app/readme-en).
### Windows
Laden Sie `maigret_standalone.exe` von [Releases](https://github.com/soxoj/maigret/releases) herunter. Sie können es auf zwei Arten starten:
- **Doppelklicken Sie darauf** — Maigret fragt nach einem Benutzernamen, führt eine Standardsuche aus und wartet am Ende, damit die Berichtslinks sichtbar bleiben.
- **Führen Sie es von einem Terminal aus** — öffnen Sie die Eingabeaufforderung (drücken Sie `Win+R`, geben Sie `cmd` ein, drücken Sie Enter) oder PowerShell, um zusätzliche Optionen zu übergeben:
```cmd
cd %USERPROFILE%\Downloads
maigret_standalone.exe USERNAME
maigret_standalone.exe USERNAME --html :: also save an HTML report
maigret_standalone.exe --help :: list all options
```
Videoanleitung: https://youtu.be/qIgwTZOmMmM.
<a id="cloud-shells"></a>
### Cloud Shells
Führen Sie Maigret im Browser über Cloud Shells oder Jupyter Notebooks aus:
<a href="https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/soxoj/maigret&tutorial=cloudshell-tutorial.md"><img src="https://assets.kitploit.com/production/public/readmes/216/7dc64fe3ed672759aab735389c56e594e597a6700b277aaa44a54b833448ea7a.png" alt="Open in Cloud Shell" height="50"></a>
<a href="https://repl.it/github/soxoj/maigret"><img src="https://replit.com/badge/github/soxoj/maigret" alt="Run on Replit" height="50"></a>
<a href="https://colab.research.google.com/gist/soxoj/879b51bc3b2f8b695abb054090645000/maigret-collab.ipynb"><img src="https://colab.research.google.com/assets/colab-badge.svg" alt="Open In Colab" height="45"></a>
<a href="https://mybinder.org/v2/gist/soxoj/9d65c2f4d3bec5dd25949197ea73cf3a/HEAD"><img src="https://mybinder.org/badge_logo.svg" alt="Open In Binder" height="45"></a>
### Snap (Linux)
<a href="https://snapcraft.io/maigret"><img src="https://snapcraft.io/static/images/badges/en/snap-store-black.svg" alt="Get it from the Snap Store" height="50"></a>
```bash
sudo snap install maigret
# usage
maigret username
```
Verfügbar für amd64 und arm64, kein Python erforderlich. Der Snap ist strikt eingeschränkt und kann in Ihr Home-Verzeichnis schreiben, führen Sie ihn daher von dort aus. Für USB-Laufwerke verbinden Sie die Schnittstelle einmal mit `sudo snap connect maigret:removable-media`.
### Lokale Installation (pip)
```bash
# install from pypi
pip3 install maigret
# usage
maigret username
```
### Aus dem Quellcode
```bash
# or clone and install manually
git clone https://github.com/soxoj/maigret && cd maigret
# build and install
pip3 install .
# usage
maigret username
```
### Docker
Es werden zwei Image-Varianten veröffentlicht:
- `soxoj/maigret:latest` — CLI-Modus (Standard)
- `soxoj/maigret:web` — startet automatisch die [Web-Oberfläche](#web-interface)
```bash
# official image (CLI)
docker pull soxoj/maigret
# CLI usage
docker run -v /mydir:/app/reports soxoj/maigret:latest username --html
# Web UI (open http://localhost:5000)
docker run -p 5000:5000 soxoj/maigret:web
# Web UI on a custom port
docker run -e PORT=8080 -p 8080:8080 soxoj/maigret:web
# manual build
docker build -t maigret . # CLI image (default target)
docker build --target web -t maigret-web . # Web UI image
```
### Fehlerbehebung
Build-Fehler? Siehe die [Fehlerbehebungsanleitung](https://maigret.readthedocs.io/en/latest/installation.html#troubleshooting).
PDF-Berichte (`--pdf`) sind ein optionales Extra — installieren Sie mit `pip install 'maigret[pdf]'`. Sie benötigen systemweite Grafikbibliotheken unter Linux/macOS; siehe den [Abschnitt zu PDF-Berichten](https://maigret.readthedocs.io/en/latest/installation.html#optional-pdf-reports-maigret-pdf) für betriebssystemspezifische Installationsschritte.
## Verwendung
### Beispiele
```bash
# make HTML, PDF, and XMind reports
maigret user --html
maigret user --pdf
maigret user --xmind # legacy XML with a manifest for XMind 2022+ readers
# machine-readable exports
maigret user --json ndjson # newline-delimited JSON (also: --json simple)
maigret user --csv
maigret user --txt
maigret user --graph # interactive D3 graph (HTML)
maigret user --neo4j # Neo4j Cypher script (graph database)
# search on sites marked with tags photo & dating
maigret user --tags photo,dating
# search on sites marked with tag us
maigret user --tags us
# highlight sites whose page also mentions specific keywords
maigret user --keywords python rust
# keyword-matched sites are shown with "[++]" in bright green
# search for three usernames on all available sites
maigret user1 user2 user3 -a
# AI-assisted investigation summary (needs OPENAI_API_KEY)
maigret user --ai
```
`--neo4j` schreibt ein `*_neo4j.cypher`-Skript des Ergebnisgraphen; importieren Sie es mit `cypher-shell -u neo4j -p <password> < report_user_neo4j.cypher` oder fügen Sie es in den Neo4j Browser ein. Re-Importe sind idempotent. Siehe die [Neo4j-Export-Dokumentation](https://maigret.readthedocs.io/en/latest/command-line-options.html#neo4j-export).
Führen Sie `maigret --help` aus, um alle Optionen zu sehen. Dokumentation: [CLI-Optionen](https://maigret.readthedocs.io/en/latest/command-line-options.html), [weitere Beispiele](https://maigret.readthedocs.io/en/latest/usage-examples.html). Stoßen Sie auf 403er oder Timeouts? Siehe [TROUBLESHOOTING.md](https://github.com/soxoj/maigret/blob/main/TROUBLESHOOTING.md).
<a id="web-interface"></a>
### Web-Oberfläche
Maigret hat eine integrierte Web-UI mit einem Ergebnisgraphen und herunterladbaren Berichten.
Möchten Sie sie nicht selbst betreiben? Stellen Sie das veröffentlichte Docker-Image `soxoj/maigret:web` mit einem Klick als gehostete App bereit:
<a href="https://render.com/deploy?repo=https://github.com/soxoj/maigret&path=utils/render.yaml"><img src="https://render.com/images/deploy-to-render-button.svg" alt="Deploy to Render" height="40"></a>
Läuft im kostenlosen Tarif von Render (fährt nach 15 Minuten Inaktivität herunter, startet bei der nächsten Anfrage wieder). Auf der Instanz ist kein Login eingerichtet, sodass jeder mit der URL sie nutzen kann.
<details>
<summary>Web Interface Screenshots</summary>
</details>
```console
maigret --web 5000
```
Öffnen Sie http://127.0.0.1:5000, geben Sie einen Benutzernamen ein und sehen Sie sich die Ergebnisse an.
### Python-Bibliothek
**Maigret kann in Ihre eigenen Python-Projekte eingebettet werden.** Die CLI ist ein dünner Wrapper um eine asynchrone Funktion, die Sie direkt aufrufen können — erstellen Sie benutzerdefinierte Pipelines, speisen Sie Ergebnisse in Ihre eigenen Tools ein oder führen Sie es innerhalb eines größeren OSINT-Workflows aus.
Siehe die vollständige [Anleitung zur Bibliotheksnutzung](https://maigret.readthedocs.io/en/latest/library-usage.html) für ein funktionierendes Beispiel, asynchrone Muster und wie man Websites nach Tag filtert.
### Nützliche CLI-Flags
- `--parse URL` — analysiert eine Profilseite, extrahiert IDs/Benutzernamen und verwendet sie, um eine rekursive Suche zu starten.
- `--permute` — generiert wahrscheinliche Benutzernamensvarianten aus zwei oder mehr Eingaben (z. B. `john doe` → `johndoe`, `j.doe`, …) und sucht nach allen.
- `--self-check [--auto-disable]` — überprüft `usernameClaimed` / `usernameUnclaimed`-Paare gegen Live-Websites für Maintainer, die die Datenbank prüfen.
- `--ai` / `--ai-model` — führt die [KI-Analyse](#ai-analysis) über die Suchergebnisse aus und streamt eine kurze Untersuchungszusammenfassung an das Terminal.
<a id="ai-analysis"></a>
### KI-Analyse
[](https://asciinema.org/a/979404)
`--ai` sammelt die Suchergebnisse, erstellt einen internen Markdown-Bericht und sendet ihn an einen OpenAI-kompatiblen Chat-Completion-Endpunkt, um eine kurze, neutrale Untersuchungszusammenfassung zu erstellen (wahrscheinlicher echter Name, Standort, Beruf, Interessen, Sprachen, Konfidenz, weiterführende Hinweise). Der Fortschritt pro Website wird unterdrückt und die Ausgabe des Modells wird an stdout gestreamt.
```bash
export OPENAI_API_KEY=sk-...
maigret user --ai
# pick a different model
maigret user --ai --ai-model gpt-4o-mini
```
Der Schlüssel kann auch als `openai_api_key` in `settings.json` festgelegt werden. Der Endpunkt ist standardmäßig `https://api.openai.com/v1`, aber `openai_api_base_url` in `settings.json` kann auf jede OpenAI-kompatible API verweisen (Azure OpenAI, OpenRouter, ein lokaler Server, …). Siehe die [Einstellungsdokumentation](https://maigret.readthedocs.io/en/latest/settings.html) für die vollständige Liste der Optionen.
### Tor / I2P / Proxys
Maigret kann Prüfungen über einen Proxy, Tor oder I2P leiten — nützlich für `.onion` / `.i2p`-Websites und zur Umgehung von WAFs, die Datacenter-IPs blockieren.
```bash
# any HTTP/SOCKS proxy
maigret user --proxy socks5://127.0.0.1:1080
# Tor (default gateway socks5://127.0.0.1:9050)
maigret user --tor-proxy socks5://127.0.0.1:9050
# I2P (default gateway http://127.0.0.1:4444)
maigret user --i2p-proxy http://127.0.0.1:4444
```
Starten Sie Ihren Tor-/I2P-Daemon, bevor Sie den Befehl ausführen — Maigret verwaltet diese Gateways nicht.
### Cloudflare-Umgehung
> **Experimentell.** Das Cloudflare-Webgate befindet sich in aktiver Entwicklung; das Konfigurationsschema, das CLI-Verhalten und die Menge der gerouteten Websites können sich ohne Abwärtskompatibilitätsgarantien ändern.
Eine Teilmenge der Websites in der Datenbank erfordert einen echten Browser, um eine JavaScript-Herausforderung zu lösen. Maigret kann diese Prüfungen an eine lokale [FlareSolverr](https://github.com/FlareSolverr/FlareSolverr)-Instanz auslagern:
```bash
docker run -d -p 8191:8191 --name flaresolverr ghcr.io/flaresolverr/flaresolverr:latest
maigret --cloudflare-bypass <username>
```
Die Umgehung ist optional (`--cloudflare-bypass` oder `cloudflare_bypass.enabled` in `settings.json`) und wird nur für Websites ausgelöst, deren `protection`-Feld übereinstimmt. Siehe die [Funktionsdokumentation](https://maigret.readthedocs.io/en/latest/features.html#cloudflare-bypass) für Backend-Optionen und Konfiguration.
## Mitwirken
Fügen Sie neue Websites gezielt in `data.json` hinzu oder korrigieren Sie sie (kein `json.load`/`json.dump`), führen Sie dann `./utils/update_site_data.py` aus, um `sites.md` und die Datenbank-Metadaten neu zu generieren, und öffnen Sie einen Pull Request. Weitere Details finden Sie im [CONTRIBUTING-Leitfaden](https://github.com/soxoj/maigret/blob/main/CONTRIBUTING.md) und in der [Entwicklungsdokumentation](https://maigret.readthedocs.io/en/latest/development.html). Versionshistorie: [CHANGELOG.md](https://github.com/soxoj/maigret/blob/main/CHANGELOG.md).
## Kommerzielle Nutzung
Das Open-Source-Maigret ist MIT-lizenziert und ohne Einschränkung kostenlos für die kommerzielle Nutzung — aber Website-Prüfungen brechen mit der Zeit und erfordern aktive Wartung.
Für ernsthafte kommerzielle Nutzung — mit einer **täglich aktualisierten Website-Datenbank** oder einer **Benutzernamensprüfungs-API** — kontaktieren Sie uns: 📧 [[email protected]](mailto:[email protected])
- Private Website-Datenbank — 5 000+ Websites, täglich aktualisiert (getrennt von der öffentlichen Open-Source-Datenbank)
- Benutzernamensprüfungs-API — integrieren Sie Maigret in Ihr Produkt
## Über
### Haftungsausschluss
**Nur für Bildungs- und rechtmäßige Zwecke.** Sie sind dafür verantwortlich, alle geltenden Gesetze (DSGVO, CCPA usw.) in Ihrer Gerichtsbarkeit einzuhalten. Die Autoren übernehmen keine Verantwortung für Missbrauch.
### Feedback
[Ein Issue öffnen](https://github.com/soxoj/maigret/issues) · [GitHub Discussions](https://github.com/soxoj/maigret/discussions) · [Telegram](https://t.me/soxoj)
### SOWEL-Klassifizierung
Verwendete OSINT-Techniken:
- [SOTL-2.2. Search For Accounts On Other Platforms](https://sowel.soxoj.com/other-platform-accounts)
- [SOTL-6.1. Check Logins Reuse To Find Another Account](https://sowel.soxoj.com/logins-reuse)
- [SOTL-6.2. Check Nicknames Reuse To Find Another Account](https://sowel.soxoj.com/nicknames-reuse)
### Lizenz
MIT © [Maigret](https://github.com/soxoj/maigret)