soxoj/maigret🕵️♂️ Raccogli un dossier su una persona tramite username da 6K siti 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>Documentazione</b></a>
</div>
<br>
</div>
**Maigret** raccoglie un dossier su una persona **solo tramite username**, verificando la presenza di account su un numero enorme di siti e raccogliendo tutte le informazioni disponibili dalle pagine web. Non sono richieste chiavi API. **[Profilazione AI (demo)](#ai-analysis)**.
## Sponsor
<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> è una piattaforma OSINT completa per investigatori e analisti professionisti. Ricerca inversa di email, numeri di telefono e username su oltre 250 moduli. Automatizza la tua raccolta di informazioni con i nostri potenti strumenti.
</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> fornisce proxy residenziali ad alte prestazioni per lo scraping di Twitter, l'automazione con Selenium e l'estrazione di dati web. Oltre 90 milioni di IP • Rotazione intelligente • Anti-blocco • Traffico senza scadenza. <br>
<b>Offerta speciale</b>: Provalo gratuitamente — Piani a partire da $0,65/GB. Usa il codice <b>RAPID10</b> per uno sconto del 10%.
</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> è un servizio di proxy Residenziali, ISP, Mobili e Datacenter progettato per attività professionali in cui stabilità, velocità e anonimato sono importanti. <br>
<b>Codice promozionale</b>: SOXOJ - 8% di sconto sui proxy ISP statici
</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> fornisce proxy residenziali affidabili per la ricerca OSINT, la ricerca di username e i flussi di lavoro di raccolta di dati pubblici.
Accedi a <b>oltre 100 milioni di IP residenziali reali</b> in <b>oltre 195 paesi</b> con <b>connessioni simultanee illimitate</b>, uptime del 99,99% e connessioni stabili, sessioni rotanti e sticky, e alti tassi di successo.
<br>
<b>Offerta speciale:</b> Prova gratuita di 3 giorni + <b>10% DI SCONTO</b> con il codice <b>SOXOJ10</b>.
</p>
## Indice
- [In un minuto](#in-one-minute)
- [Funzionalità principali](#main-features)
- [Demo](#demo)
- [Installazione](#installation)
- [Utilizzo](#usage)
- [Contribuire](#contributing)
- [Uso commerciale](#commercial-use)
- [Informazioni](#about)
<a id="one-minute"></a>
## In un minuto
Assicurati di avere Python 3.10 o superiore.
```bash
pip install maigret
maigret YOUR_USERNAME
```
Non vuoi installare? Prova il [bot Telegram della community](https://maigret.app/readme-en) o una [Cloud Shell](#cloud-shells).
Vuoi una web UI? Vedi [come avviarla](#web-interface).
Vedi anche: [Guida rapida](https://maigret.readthedocs.io/en/latest/quick-start.html).
## Funzionalità principali
- Supporta 5.900 siti ([vedi l'elenco completo](https://github.com/soxoj/maigret/blob/main/sites.md)). Un'esecuzione predefinita controlla i 500 siti con il traffico più alto; passa `-a` per scansionare tutto, oppure `--tags` per restringere per categoria/paese.
- Integrabile nei progetti Python — importa `maigret` ed esegui le ricerche a livello di codice (vedi [utilizzo come libreria](https://maigret.readthedocs.io/en/latest/library-usage.html)).
- [Estrae](https://github.com/soxoj/socid_extractor) tutte le informazioni disponibili sul proprietario dell'account dalle pagine di profilo e dalle API dei siti, inclusi i link ad altri account.
- Esegue una ricerca ricorsiva utilizzando gli username e gli altri ID scoperti.
- Consente di filtrare per tag (categorie di siti, paesi).
- Rileva e aggira parzialmente blocchi, censura e CAPTCHA.
- Scarica un [database dei siti aggiornato automaticamente](https://maigret.readthedocs.io/en/latest/settings.html#database-auto-update) da GitHub a ogni esecuzione (una volta ogni 24 ore) e, se offline, utilizza il database integrato.
- Funziona con siti Tor e I2P; è in grado di controllare i domini.
- Include una [web interface](#web-interface) per consultare i risultati come grafo e scaricare report in ogni formato da un'unica pagina.
- Modalità opzionale di [analisi AI](#ai-analysis) (`--ai`) che trasforma i risultati grezzi in un breve riepilogo investigativo utilizzando un'API compatibile con OpenAI.
Per l'elenco completo delle funzionalità, vedi la [documentazione delle funzionalità](https://maigret.readthedocs.io/en/latest/features.html).
### Utilizzato da
Strumenti professionali di OSINT e analisi dei social media basati su 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>
## Demo
### Video
<a href="https://asciinema.org/a/Ao0y7N0TTxpS0pisoprQJdylZ">
<img src="https://asciinema.org/a/Ao0y7N0TTxpS0pisoprQJdylZ.svg" alt="asciicast" width="600">
</a>
### Report
[Report PDF](https://raw.githubusercontent.com/soxoj/maigret/main/static/report_alexaimephotographycars.pdf), [report HTML](https://htmlpreview.github.io/?https://raw.githubusercontent.com/soxoj/maigret/main/static/report_alexaimephotographycars.html)
[Output completo della console](https://raw.githubusercontent.com/soxoj/maigret/main/static/recursive_search.md)
## Installazione
Hai già eseguito i passaggi della sezione [In un minuto](#one-minute)? Sei a posto. Di seguito sono riportati metodi alternativi.
Non vuoi installare nulla? Usa il [bot Telegram della community](https://maigret.app/readme-en).
### Windows
Scarica `maigret_standalone.exe` dalla pagina [Releases](https://github.com/soxoj/maigret/releases). Puoi avviarlo in due modi:
- **Fai doppio clic su di esso** — Maigret chiederà un username, eseguirà una ricerca predefinita e attenderà alla fine in modo che i link ai report rimangano visibili.
- **Avvialo da un terminale** — apri il Prompt dei comandi (premi `Win+R`, digita `cmd`, premi Invio) o PowerShell per passare opzioni aggiuntive:
```cmd
cd %USERPROFILE%\Downloads
maigret_standalone.exe USERNAME
maigret_standalone.exe USERNAME --html :: salva anche un report HTML
maigret_standalone.exe --help :: elenca tutte le opzioni
```
Guida video: https://youtu.be/qIgwTZOmMmM.
<a id="cloud-shells"></a>
### Cloud Shell
Esegui Maigret nel browser tramite cloud shell o notebook 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
```
Disponibile per amd64 e arm64, non richiede Python. Lo snap è rigorosamente confinato e può scrivere all'interno della tua directory home, quindi eseguilo da lì. Per le unità USB, collega l'interfaccia una volta con `sudo snap connect maigret:removable-media`.
### Installazione locale (pip)
```bash
# install from pypi
pip3 install maigret
# usage
maigret username
```
### Dai sorgenti
```bash
# or clone and install manually
git clone https://github.com/soxoj/maigret && cd maigret
# build and install
pip3 install .
# usage
maigret username
```
### Docker
Vengono pubblicate due varianti di immagine:
- `soxoj/maigret:latest` — modalità CLI (predefinita)
- `soxoj/maigret:web` — avvia automaticamente la [web interface](#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
```
### Risoluzione dei problemi
Errori di build? Vedi la [guida alla risoluzione dei problemi](https://maigret.readthedocs.io/en/latest/installation.html#troubleshooting).
I report PDF (`--pdf`) sono un extra opzionale — installali con `pip install 'maigret[pdf]'`. Richiedono librerie grafiche a livello di sistema su Linux/macOS; vedi la [sezione sui report PDF](https://maigret.readthedocs.io/en/latest/installation.html#optional-pdf-reports-maigret-pdf) per i passaggi di installazione per sistema operativo.
## Utilizzo
### Esempi
```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` scrive uno script `*_neo4j.cypher` del grafo dei risultati; importalo con `cypher-shell -u neo4j -p <password> < report_user_neo4j.cypher` oppure incollalo nel Neo4j Browser. Le reimportazioni sono idempotenti. Vedi la [documentazione sull'esportazione Neo4j](https://maigret.readthedocs.io/en/latest/command-line-options.html#neo4j-export).
Esegui `maigret --help` per tutte le opzioni. Documentazione: [opzioni CLI](https://maigret.readthedocs.io/en/latest/command-line-options.html), [altri esempi](https://maigret.readthedocs.io/en/latest/usage-examples.html). Ricevi errori 403 o timeout? Vedi [TROUBLESHOOTING.md](https://github.com/soxoj/maigret/blob/main/TROUBLESHOOTING.md).
<a id="web-interface"></a>
### Web interface
Maigret ha una web UI integrata con un grafo dei risultati e report scaricabili.
Non vuoi eseguirla tu stesso? Distribuisci l'immagine Docker pubblicata `soxoj/maigret:web` come app ospitata con un solo 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>
Funziona sul piano gratuito di Render (si spegne dopo 15 minuti di inattività, si riattiva alla richiesta successiva). Sull'istanza non è configurato alcun login, quindi chiunque abbia l'URL può usarla.
<details>
<summary>Screenshot della Web Interface</summary>
</details>
```console
maigret --web 5000
```
Apri http://127.0.0.1:5000, inserisci un username e visualizza i risultati.
### Libreria Python
**Maigret può essere integrato nei tuoi progetti Python.** La CLI è un sottile wrapper attorno a una funzione asincrona che puoi chiamare direttamente — crea pipeline personalizzate, alimenta i risultati nei tuoi strumenti o eseguilo all'interno di un flusso di lavoro OSINT più ampio.
Vedi la [guida completa all'utilizzo come libreria](https://maigret.readthedocs.io/en/latest/library-usage.html) per un esempio funzionante, i pattern asincroni e come filtrare i siti per tag.
### Flag CLI utili
- `--parse URL` — analizza una pagina di profilo, estrae ID/username e li usa per avviare una ricerca ricorsiva.
- `--permute` — genera probabili varianti di username da due o più input (ad es. `john doe` → `johndoe`, `j.doe`, …) e cerca tutte.
- `--self-check [--auto-disable]` — verifica le coppie `usernameClaimed` / `usernameUnclaimed` su siti reali per i manutentori che controllano il database.
- `--ai` / `--ai-model` — esegue l'[analisi AI](#ai-analysis) sui risultati della ricerca e trasmette in streaming un breve riepilogo investigativo al terminale.
<a id="ai-analysis"></a>
### Analisi AI
[](https://asciinema.org/a/979404)
`--ai` raccoglie i risultati della ricerca, costruisce un report Markdown interno e lo invia a un endpoint di chat completion compatibile con OpenAI per produrre un breve riepilogo investigativo neutrale (probabile nome reale, posizione, occupazione, interessi, lingue, livello di confidenza, piste da seguire). L'avanzamento per sito viene soppresso e l'output del modello viene trasmesso in streaming su stdout.
```bash
export OPENAI_API_KEY=sk-...
maigret user --ai
# pick a different model
maigret user --ai --ai-model gpt-4o-mini
```
La chiave può anche essere impostata come `openai_api_key` in `settings.json`. L'endpoint predefinito è `https://api.openai.com/v1`, ma `openai_api_base_url` in `settings.json` può puntare a qualsiasi API compatibile con OpenAI (Azure OpenAI, OpenRouter, un server locale, …). Vedi la [documentazione delle impostazioni](https://maigret.readthedocs.io/en/latest/settings.html) per l'elenco completo delle opzioni.
### Tor / I2P / proxy
Maigret può instradare i controlli attraverso un proxy, Tor o I2P — utile per i siti `.onion` / `.i2p` e per aggirare i WAF che bloccano gli IP dei 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
```
Avvia il tuo demone Tor / I2P prima di eseguire il comando — Maigret non gestisce questi gateway.
### Bypass di Cloudflare
> **Sperimentale.** Il webgate di Cloudflare è in fase di sviluppo attivo; lo schema di configurazione, il comportamento della CLI e l'insieme dei siti instradati possono cambiare senza garanzie di retrocompatibilità.
Un sottoinsieme di siti nel database richiede un browser reale per risolvere una sfida JavaScript. Maigret può delegare questi controlli a un'istanza locale di [FlareSolverr](https://github.com/FlareSolverr/FlareSolverr):
```bash
docker run -d -p 8191:8191 --name flaresolverr ghcr.io/flaresolverr/flaresolverr:latest
maigret --cloudflare-bypass <username>
```
Il bypass è opt-in (`--cloudflare-bypass` o `cloudflare_bypass.enabled` in `settings.json`) e si attiva solo per i siti il cui campo `protection` corrisponde. Vedi la [documentazione delle funzionalità](https://maigret.readthedocs.io/en/latest/features.html#cloudflare-bypass) per le opzioni di backend e la configurazione.
## Contribuire
Aggiungi o correggi nuovi siti in modo chirurgico in `data.json` (niente `json.load`/`json.dump`), poi esegui `./utils/update_site_data.py` per rigenerare `sites.md` e i metadati del database, e apri una pull request. Per maggiori dettagli, vedi la [guida CONTRIBUTING](https://github.com/soxoj/maigret/blob/main/CONTRIBUTING.md) e la [documentazione per sviluppatori](https://maigret.readthedocs.io/en/latest/development.html). Cronologia delle release: [CHANGELOG.md](https://github.com/soxoj/maigret/blob/main/CHANGELOG.md).
## Uso commerciale
Il Maigret open-source è distribuito con licenza MIT ed è gratuito per uso commerciale senza restrizioni — ma i controlli sui siti si rompono nel tempo e richiedono manutenzione attiva.
Per un uso commerciale serio — con un **database dei siti aggiornato quotidianamente** o una **API di verifica username** — contattaci: 📧 [[email protected]](mailto:[email protected])
- Database privato dei siti — oltre 5.000 siti, aggiornato quotidianamente (separato dal database open-source pubblico)
- API di verifica username — integra Maigret nel tuo prodotto
## Informazioni
### Disclaimer
**Solo per scopi educativi e leciti.** Sei responsabile del rispetto di tutte le leggi applicabili (GDPR, CCPA, ecc.) nella tua giurisdizione. Gli autori non si assumono alcuna responsabilità per usi impropri.
### Feedback
[Apri una issue](https://github.com/soxoj/maigret/issues) · [GitHub Discussions](https://github.com/soxoj/maigret/discussions) · [Telegram](https://t.me/soxoj)
### Classificazione SOWEL
Tecniche OSINT utilizzate:
- [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)
### Licenza
MIT © [Maigret](https://github.com/soxoj/maigret)