FAQ

Réponses courtes aux questions que les utilisateurs tapent le plus souvent dans la recherche de la documentation. Chaque section renvoie vers la page correspondante pour plus de détails.

Puis-je faire une recherche par adresse e-mail ?

Non. Maigret n’accepte en entrée qu’un nom d’utilisateur (ou l’un des types d’identifiants pris en charge) : la recherche par adresse e-mail sort de son périmètre. Retrouver une adresse e-mail demande d’autres techniques (sonder les procédures de réinitialisation de mot de passe, les points d’entrée d’inscription) et relève d’une autre catégorie d’outils.

Outils open source recommandés pour la recherche par e-mail :

• mailcat

• holehe

• user-scanner

Services en ligne :

• Noimosiny

• OSINT Industries

• Epieos

À noter : si Maigret a déjà trouvé un compte pour un nom d’utilisateur, il extrait souvent automatiquement l’e-mail associé depuis la page de profil, voir Extraction d’informations depuis les pages de comptes.

Puis-je configurer un proxy / SOCKS / Tor / I2P ?

Oui. Trois options couvrent trois objectifs distincts :

• --proxy URL — faire passer toutes les vérifications par le proxy HTTP ou SOCKS indiqué (c’est aussi la bonne option pour faire passer toute la recherche par Tor avec socks5://127.0.0.1:9050, par un proxy résidentiel ou par une passerelle d’entreprise).

• --tor-proxy URL — utilisé uniquement pour les sites .onion de la base. Les sites du web classique continuent de passer par votre connexion directe (ou par --proxy s’il est défini).

• --i2p-proxy URL — même principe, uniquement pour les hôtes .i2p.

La confusion la plus fréquente oppose --proxy à --tor-proxy : --proxy veut dire « tout passe par cette passerelle », --tor-proxy veut dire « seuls les sites onion passent par Tor ».

Explication complète (ports de Tor Browser et du tor système, Tails OS, réglage des délais et des nouvelles tentatives) : Tor, I2P et proxys.

Si votre objectif est en réalité de « contourner les blocages des WAF / corriger les erreurs 403 », voir la section Des sites échouent, expirent ou renvoient 403 ci-dessous : pour cela, un proxy résidentiel fait presque toujours mieux que Tor ou un VPN.

Puis-je utiliser un VPN avec Maigret ?

Oui, mais --proxy est généralement un meilleur choix. Un VPN agit de façon transparente au niveau du système : Maigret n’a besoin d’aucune configuration particulière pour en profiter. Cependant :

• --proxy s’applique au seul processus : il n’affecte pas les autres applications et ne fuit pas lorsqu’on l’active ou le désactive.

• --proxy rend l’IP de sortie visible dans les journaux, ce qui aide à comprendre pourquoi un lot de sites a renvoyé UNKNOWN.

• --proxy accepte une valeur différente à chaque exécution : vous pouvez donc alterner entre sorties résidentielles et sorties de datacenter sans toucher à la configuration réseau du système.

Si beaucoup de sites renvoient 403, la cause est presque certainement que l’IP de sortie du VPN figure sur une liste de blocage de WAF (Cloudflare, DDoS-Guard et Akamai bloquent en bloc les plages VPN courantes). Un proxy résidentiel via --proxy est le remède habituel, voir la section « Lots of sites fail / timeout / return 403 » de TROUBLESHOOTING.md.

Maigret vérifie-t-il les domaines via DNS ?

Oui, à titre expérimental. Avec --with-domains, Maigret résout par DNS (enregistrements A) un petit ensemble de motifs {username}.<tld>, en parallèle des vérifications HTTP habituelles. L’ensemble actuel est .ddns.net, .com, .pro, .me, .biz, .email, .guru, soit 7 entrées de la base avec protocol: dns.

maigret <username> --with-domains

L’option est marquée expérimentale : une vérification purement DNS peut signaler des domaines parqués ou des jokers attrape-tout comme si le nom d’utilisateur était enregistré. Traitez donc un résultat comme une piste, pas comme une confirmation.

Si votre tâche relève d’une reconnaissance DNS plus large (énumération de sous-domaines, historique WHOIS, typosquattage), Maigret n’est pas le bon outil. Les alternatives établies :

• dnstwist — typosquattage et domaines ressemblants.

• amass / subfinder — énumération de sous-domaines.

• theHarvester — collecte d’e-mails, d’hôtes et de sous-domaines à partir d’un domaine.

Existe-t-il un bot Telegram pour Maigret ?

Oui. Un bot maintenu par la communauté permet d’utiliser Maigret sans rien installer en local :

• Instance en service : maigret.app/docs-en (redirection, car le bot hébergé peut changer d’hébergeur).

• Code source : github.com/soxoj/maigret-tg-bot.

Quant à la recherche dans Telegram lui-même : Maigret vérifie l’existence d’une page t.me/<user> dans le cadre d’une recherche normale, mais il n’analyse ni les canaux, ni les publications, ni les membres, ni le contenu des messages. Pour de l’OSINT sur les contenus Telegram, il vous faut un outil dédié.

Où est l’interface web ?

maigret --web 5000

Ouvrez ensuite http://127.0.0.1:5000. Des captures d’écran et une présentation complète se trouvent dans Interface web.

Des sites échouent, expirent ou renvoient 403 : les échecs de connexion

C’est le problème le plus souvent signalé, et il vient presque toujours d’une protection anti-bot (Cloudflare, DDoS-Guard, Akamai) ou d’une liaison lente, pas d’un bug de Maigret. Les réglages rapides, dans l’ordre :

1. --timeout 60 — les 30 s par défaut sont justes pour les réseaux lents et pour Tor.

2. --retries 2 — couvre les échecs passagers.

3. -n 20 — une concurrence plus basse réduit la limitation de débit par les WAF.

4. --proxy http://user:pass@residential-proxy:port — les IP de datacenter (AWS, GCP, DigitalOcean) et la plupart des plages VPN sont bloquées en bloc ; des sorties résidentielles ou mobiles règlent en général l’essentiel des 403.

La matrice de dépannage complète (recettes par type d’erreur pour les 403, les dépassements de délai, le SSL, les captchas et les vagues de UNKNOWN) se trouve dans TROUBLESHOOTING.md.

Comment générer un rapport PDF ?

Le support du PDF est une extension facultative, car il entraîne de lourdes dépendances graphiques :

pip install 'maigret[pdf]'
maigret <username> --pdf

Sous Linux et macOS, il vous faut également des bibliothèques système (Pango, Cairo, GDK-PixBuf). Les étapes d’installation par système d’exploitation figurent dans la section Optional: PDF reports de Installation.

Pour les autres formats de rapport (--html, --md, --json, --csv, --txt, --xmind), voir Options de ligne de commande.

maigret: command not found

L’installation a réussi, mais votre shell ne trouve pas le lanceur maigret (vous verrez peut-être -bash: maigret: command not found, ou un message not recognized sous Windows). Le paquet est bien installé : c’est seulement le script de point d’entrée qui n’est pas dans votre PATH. Les solutions, de la plus paresseuse à la moins paresseuse :

• Lancez-le comme un module : cela fonctionne toujours si le paquet a pu être importé.

  python3 -m maigret <username>
  

• pip install --user place le script dans un répertoire bin / Scripts propre à l’utilisateur, souvent absent du PATH. La solution la plus propre est d’installer dans un environnement isolé qui gère le PATH pour vous :

  pipx install maigret
  

• Sous Windows, rouvrez le terminal après l’installation (le PATH n’est lu qu’au démarrage), ou utilisez l’exécutable autonome maigret_standalone.exe, voir Installation.

error: metadata-generation-failed

Cette erreur vient de pip, pas de Maigret : pip n’a pas réussi à construire l’une des dépendances. Presque toujours, la chaîne de compilation est trop ancienne, ou une dépendance native n’a pas ses bibliothèques système. Essayez, dans l’ordre :

• Mettez à jour la chaîne d’outils et réessayez :

  python -m pip install --upgrade pip setuptools wheel
  

• Utilisez un interpréteur pris en charge (Python 3.10 à 3.12). Les versions toutes fraîches ou en fin de vie n’ont souvent pas de wheels précompilées, ce qui force une compilation depuis les sources, laquelle échoue ensuite.

• Si le paquet en échec est un paquet natif (lxml, reportlab, _renderPM, ou une erreur mentionnant ft2build.h / cairo), il vous faut les dépendances de compilation système : voir la section Troubleshooting de Installation, ou évitez complètement les compilateurs en passant par Docker.

Too many errors of type "..."

C’est le résumé de fin d’exécution de Maigret, pas un plantage : la recherche est allée à son terme. Cela signifie qu’une grande partie des sites a échoué de la même façon ; le remède dépend donc de la catégorie affichée entre guillemets :

• Connecting failure — vérifiez votre connexion internet ; si seule une partie des sites échoue, baissez le parallélisme avec -n 10.

• Connecting failure (DNS) — la résolution DNS a échoué pour la plupart des sites. Essayez --dns-resolver threaded (cela règle souvent le problème sous Windows, en VPN ou en réseau d’entreprise) ; sinon, vérifiez votre VPN et votre pare-feu, et envisagez un résolveur public (1.1.1.1 ou 8.8.8.8).

• Request timeout — augmentez --timeout, ou changez de fournisseur d’accès ou de réseau.

• Captcha — changez d’adresse IP, ou fournissez les cookies du service.

• Bot protection / Access denied — changez d’IP ; un --proxy résidentiel ou --cloudflare-bypass est le remède habituel.

• Webgate unavailable — --cloudflare-bypass est actif, mais aucun solveur n’est joignable ; démarrez FlareSolverr, ou retirez l’option pour ignorer les sites protégés.

Si l’essentiel de votre recherche tombe dans l’une des trois dernières catégories, voir la section Des sites échouent, expirent ou renvoient 403 ci-dessus, ainsi que le TROUBLESHOOTING.md complet.