soxoj/maigret🕵️♂️ Rassemblez un dossier sur une personne à partir de son nom d'utilisateur sur 6K sites web
# 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** constitue un dossier sur une personne **à partir de son seul nom d'utilisateur**, en vérifiant la présence de comptes sur un très grand nombre de sites et en rassemblant toutes les informations disponibles sur les pages web. Aucune clé API n'est requise. **[Profilage par IA (démo)](#ai-analysis)**.
## Sponsors
<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> est une plateforme OSINT complète destinée aux enquêteurs et analystes professionnels. Recherche inversée par e-mail, numéro de téléphone et nom d'utilisateur sur plus de 250 modules. Automatisez votre collecte de renseignements grâce à nos outils puissants.
</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> fournit des proxys résidentiels hautes performances pour le scraping de Twitter, l'automatisation Selenium et l'extraction de données web. Plus de 90 M d'IP • Rotation intelligente • Anti-blocage • Trafic sans expiration. <br>
<b>Offre spéciale</b> : Essayez gratuitement — Forfaits à partir de 0,65 $/Go. Utilisez le code <b>RAPID10</b> pour 10 % de réduction.
</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> est un service de proxys résidentiels, ISP, mobiles et datacenter conçu pour les tâches professionnelles où la stabilité, la vitesse et l'anonymat sont essentiels. <br>
<b>Code promo</b> : SOXOJ - 8 % de réduction sur les proxys ISP statiques
</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> fournit des proxys résidentiels fiables pour la recherche OSINT, la recherche de noms d'utilisateur et les flux de collecte de données publiques.
Accédez à <b>plus de 100 M d'IP résidentielles réelles</b> dans <b>plus de 195 pays</b> <b>connexions simultanées illimitées</b> avec un taux de disponibilité de 99,99 % et des connexions stables, sessions rotatives + persistantes, et des taux de réussite élevés.
<br>
<b>Offre spéciale :</b> Essai gratuit de 3 jours + <b>10 % DE RÉDUCTION</b> avec le code <b>SOXOJ10</b>.
</p>
## Sommaire
- [En une minute](#in-one-minute)
- [Fonctionnalités principales](#main-features)
- [Démo](#demo)
- [Installation](#installation)
- [Utilisation](#usage)
- [Contribution](#contributing)
- [Utilisation commerciale](#commercial-use)
- [À propos](#about)
<a id="one-minute"></a>
## En une minute
Assurez-vous de disposer de Python 3.10 ou supérieur.
```bash
pip install maigret
maigret YOUR_USERNAME
```
Pas d'installation ? Essayez le [bot Telegram communautaire](https://maigret.app/readme-en) ou un [Cloud Shell](#cloud-shells).
Vous voulez une interface web ? Voir [comment la lancer](#web-interface).
Voir aussi : [Démarrage rapide](https://maigret.readthedocs.io/en/latest/quick-start.html).
## Fonctionnalités principales
- Prend en charge 5 900 sites ([voir la liste complète](https://github.com/soxoj/maigret/blob/main/sites.md)). Une exécution par défaut vérifie les 500 sites les mieux classés par trafic ; passez `-a` pour tout analyser, ou `--tags` pour restreindre par catégorie/pays.
- Intégrable dans des projets Python — importez `maigret` et lancez des recherches par programmation (voir [utilisation de la bibliothèque](https://maigret.readthedocs.io/en/latest/library-usage.html)).
- [Extrait](https://github.com/soxoj/socid_extractor) toutes les informations disponibles sur le propriétaire du compte à partir des pages de profil et des API des sites, y compris les liens vers d'autres comptes.
- Effectue une recherche récursive à l'aide des noms d'utilisateur et autres identifiants découverts.
- Permet le filtrage par tags (catégories de sites, pays).
- Détecte et contourne partiellement les blocages, la censure et les CAPTCHA.
- Récupère une [base de données de sites mise à jour automatiquement](https://maigret.readthedocs.io/en/latest/settings.html#database-auto-update) depuis GitHub à chaque exécution (une fois toutes les 24 heures), et se rabat sur la base de données intégrée en cas d'absence de connexion.
- Fonctionne avec les sites Tor et I2P ; capable de vérifier des domaines.
- Livré avec une [interface web](#web-interface) permettant de parcourir les résultats sous forme de graphe et de télécharger des rapports dans tous les formats depuis une seule page.
- [Mode d'analyse par IA](#ai-analysis) optionnel (`--ai`) qui transforme les résultats bruts en un court résumé d'enquête à l'aide d'une API compatible OpenAI.
Pour la liste complète des fonctionnalités, voir la [documentation des fonctionnalités](https://maigret.readthedocs.io/en/latest/features.html).
### Utilisé par
Outils professionnels d'OSINT et d'analyse de réseaux sociaux construits sur Maigret :
<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>
## Démo
### Vidéo
<a href="https://asciinema.org/a/Ao0y7N0TTxpS0pisoprQJdylZ">
<img src="https://asciinema.org/a/Ao0y7N0TTxpS0pisoprQJdylZ.svg" alt="asciicast" width="600">
</a>
### Rapports
[Rapport PDF](https://raw.githubusercontent.com/soxoj/maigret/main/static/report_alexaimephotographycars.pdf), [rapport HTML](https://htmlpreview.github.io/?https://raw.githubusercontent.com/soxoj/maigret/main/static/report_alexaimephotographycars.html)
[Sortie console complète](https://raw.githubusercontent.com/soxoj/maigret/main/static/recursive_search.md)
## Installation
Vous avez déjà suivi les étapes de la section [En une minute](#one-minute) ? C'est bon. Voici ci-dessous des méthodes alternatives.
Vous ne voulez rien installer ? Utilisez le [bot Telegram communautaire](https://maigret.app/readme-en).
### Windows
Téléchargez `maigret_standalone.exe` depuis les [Releases](https://github.com/soxoj/maigret/releases). Vous pouvez le lancer de deux façons :
- **Double-cliquez dessus** — Maigret demandera un nom d'utilisateur, lancera une recherche par défaut et attendra à la fin pour que les liens des rapports restent visibles.
- **Lancez-le depuis un terminal** — ouvrez l'invite de commandes (appuyez sur `Win+R`, tapez `cmd`, appuyez sur Entrée) ou PowerShell pour passer des options supplémentaires :
```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
```
Guide vidéo : https://youtu.be/qIgwTZOmMmM.
<a id="cloud-shells"></a>
### Cloud Shells
Exécutez Maigret dans le navigateur via des cloud shells ou des notebooks Jupyter :
<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
```
Disponible pour amd64 et arm64, sans Python requis. Le snap est strictement confiné et peut écrire dans votre répertoire personnel, exécutez-le donc depuis celui-ci. Pour les clés USB, connectez l'interface une fois avec `sudo snap connect maigret:removable-media`.
### Installation locale (pip)
```bash
# install from pypi
pip3 install maigret
# usage
maigret username
```
### Depuis les sources
```bash
# or clone and install manually
git clone https://github.com/soxoj/maigret && cd maigret
# build and install
pip3 install .
# usage
maigret username
```
### Docker
Deux variantes d'image sont publiées :
- `soxoj/maigret:latest` — mode CLI (par défaut)
- `soxoj/maigret:web` — lance automatiquement l'[interface web](#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
```
### Dépannage
Des erreurs de compilation ? Voir le [guide de dépannage](https://maigret.readthedocs.io/en/latest/installation.html#troubleshooting).
Les rapports PDF (`--pdf`) sont un extra optionnel — installez avec `pip install 'maigret[pdf]'`. Ils nécessitent des bibliothèques graphiques au niveau du système sous Linux/macOS ; voir la [section sur les rapports PDF](https://maigret.readthedocs.io/en/latest/installation.html#optional-pdf-reports-maigret-pdf) pour les étapes d'installation par système d'exploitation.
## Utilisation
### Exemples
```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` écrit un script `*_neo4j.cypher` du graphe de résultats ; importez-le avec `cypher-shell -u neo4j -p <password> < report_user_neo4j.cypher` ou collez-le dans le Neo4j Browser. Les réimportations sont idempotentes. Voir la [documentation sur l'export Neo4j](https://maigret.readthedocs.io/en/latest/command-line-options.html#neo4j-export).
Exécutez `maigret --help` pour toutes les options. Docs : [options CLI](https://maigret.readthedocs.io/en/latest/command-line-options.html), [plus d'exemples](https://maigret.readthedocs.io/en/latest/usage-examples.html). Vous rencontrez des erreurs 403 ou des timeouts ? Voir [TROUBLESHOOTING.md](https://github.com/soxoj/maigret/blob/main/TROUBLESHOOTING.md).
<a id="web-interface"></a>
### Interface web
Maigret dispose d'une interface web intégrée avec un graphe de résultats et des rapports téléchargeables.
Vous ne voulez pas la lancer vous-même ? Déployez l'image Docker `soxoj/maigret:web` publiée en tant qu'application hébergée en un clic :
<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>
Fonctionne sur le niveau gratuit de Render (s'arrête après 15 min d'inactivité, redémarre à la requête suivante). Aucune authentification n'est configurée sur l'instance, donc toute personne disposant de l'URL peut l'utiliser.
<details>
<summary>Captures d'écran de l'interface web</summary>
</details>
```console
maigret --web 5000
```
Ouvrez http://127.0.0.1:5000, saisissez un nom d'utilisateur et consultez les résultats.
### Bibliothèque Python
**Maigret peut être intégré dans vos propres projets Python.** La CLI est une fine surcouche autour d'une fonction asynchrone que vous pouvez appeler directement — construisez des pipelines personnalisés, alimentez vos propres outils avec les résultats, ou exécutez-le dans un workflow OSINT plus large.
Consultez le [guide complet d'utilisation de la bibliothèque](https://maigret.readthedocs.io/en/latest/library-usage.html) pour un exemple fonctionnel, les patterns asynchrones et la façon de filtrer les sites par tag.
### Options CLI utiles
- `--parse URL` — analyse une page de profil, extrait les identifiants/noms d'utilisateur et les utilise pour lancer une recherche récursive.
- `--permute` — génère des variantes probables de nom d'utilisateur à partir de deux entrées ou plus (par ex. `john doe` → `johndoe`, `j.doe`, …) et recherche toutes ces variantes.
- `--self-check [--auto-disable]` — vérifie les paires `usernameClaimed` / `usernameUnclaimed` sur des sites en ligne pour les mainteneurs qui auditent la base de données.
- `--ai` / `--ai-model` — exécute l'[analyse par IA](#ai-analysis) sur les résultats de recherche et diffuse un court résumé d'enquête dans le terminal.
<a id="ai-analysis"></a>
### Analyse par IA
[](https://asciinema.org/a/979404)
`--ai` collecte les résultats de recherche, construit un rapport Markdown interne et l'envoie à un point de terminaison de complétion de chat compatible OpenAI pour produire un court résumé d'enquête neutre (nom réel probable, localisation, profession, centres d'intérêt, langues, niveau de confiance, pistes à suivre). La progression par site est masquée et la sortie du modèle est diffusée sur stdout.
```bash
export OPENAI_API_KEY=sk-...
maigret user --ai
# pick a different model
maigret user --ai --ai-model gpt-4o-mini
```
La clé peut également être définie comme `openai_api_key` dans `settings.json`. Le point de terminaison est par défaut `https://api.openai.com/v1`, mais `openai_api_base_url` dans `settings.json` peut pointer vers n'importe quelle API compatible OpenAI (Azure OpenAI, OpenRouter, un serveur local, …). Voir la [documentation des paramètres](https://maigret.readthedocs.io/en/latest/settings.html) pour la liste complète des options.
### Tor / I2P / proxys
Maigret peut acheminer les vérifications via un proxy, Tor ou I2P — utile pour les sites `.onion` / `.i2p` et pour contourner les WAF qui bloquent les IP de datacenter.
```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
```
Démarrez votre démon Tor / I2P avant de lancer la commande — Maigret ne gère pas ces passerelles.
### Contournement de Cloudflare
> **Expérimental.** Le webgate Cloudflare est en cours de développement actif ; le schéma de configuration, le comportement de la CLI et l'ensemble des sites routés peuvent changer sans garantie de rétrocompatibilité.
Un sous-ensemble de sites de la base de données nécessite un vrai navigateur pour résoudre un défi JavaScript. Maigret peut déléguer ces vérifications à une instance locale de [FlareSolverr](https://github.com/FlareSolverr/FlareSolverr) :
```bash
docker run -d -p 8191:8191 --name flaresolverr ghcr.io/flaresolverr/flaresolverr:latest
maigret --cloudflare-bypass <username>
```
Le contournement est opt-in (`--cloudflare-bypass` ou `cloudflare_bypass.enabled` dans `settings.json`) et ne se déclenche que pour les sites dont le champ `protection` correspond. Voir la [documentation des fonctionnalités](https://maigret.readthedocs.io/en/latest/features.html#cloudflare-bypass) pour les options de backend et la configuration.
## Contribution
Ajoutez ou corrigez de nouveaux sites de manière chirurgicale dans `data.json` (pas de `json.load`/`json.dump`), puis exécutez `./utils/update_site_data.py` pour régénérer `sites.md` et les métadonnées de la base de données, et ouvrez une pull request. Pour plus de détails, voir le [guide CONTRIBUTING](https://github.com/soxoj/maigret/blob/main/CONTRIBUTING.md) et la [documentation de développement](https://maigret.readthedocs.io/en/latest/development.html). Historique des versions : [CHANGELOG.md](https://github.com/soxoj/maigret/blob/main/CHANGELOG.md).
## Utilisation commerciale
Maigret open source est sous licence MIT et libre d'utilisation commerciale sans restriction — mais les vérifications de sites se cassent avec le temps et nécessitent une maintenance active.
Pour un usage commercial sérieux — avec une **base de données de sites mise à jour quotidiennement** ou une **API de vérification de noms d'utilisateur** — contactez-nous : 📧 [[email protected]](mailto:[email protected])
- Base de données privée de sites — plus de 5 000 sites, mise à jour quotidiennement (distincte de la base de données open source publique)
- API de vérification de noms d'utilisateur — intégrez Maigret dans votre produit
## À propos
### Avertissement
**À des fins éducatives et légales uniquement.** Vous êtes responsable du respect de toutes les lois applicables (RGPD, CCPA, etc.) dans votre juridiction. Les auteurs n'assument aucune responsabilité en cas de mauvaise utilisation.
### Retours
[Ouvrir un ticket](https://github.com/soxoj/maigret/issues) · [GitHub Discussions](https://github.com/soxoj/maigret/discussions) · [Telegram](https://t.me/soxoj)
### Classification SOWEL
Techniques OSINT utilisées :
- [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)
### Licence
MIT © [Maigret](https://github.com/soxoj/maigret)