
Osintgram è uno strumento OSINT su Instagram. Offre una shell interattiva per eseguire analisi sull'account Instagram di qualsiasi utente tramite il suo nickname.
# Osintgram 🔎📸
[](doc/CHANGELOG.md)
[](LICENSE)
[](https://www.python.org/)
[](.github/workflows/tests.yml)
[](#quick-start)
**Puntalo su un account Instagram e scopri chi c'è dietro.** Osintgram
raccoglie, incrocia e presenta tutto ciò che un profilo pubblico lascia trapelare
— follower, didascalie, hashtag, luoghi geolocalizzati, abitudini di pubblicazione, dettagli
di contatto pubblici — in un'interfaccia web che esegui sulla tua macchina.
Chiedi in linguaggio naturale e un **modello AI locale** capisce quali ricerche
eseguire. Oppure no: scegli tu stesso i comandi e salta del tutto il modello.
<p align="center">
<img src="https://assets.kitploit.com/production/public/readmes/143/d6eaa19d795a604cab713f300cd9b5db4dce554bc604e3436a88d3d63e6f132b/6e4b370c0dd97191375d1281f84ddf2bc1653a0379d942b46787fd1ebe124ba0-display-v1.webp" width="900" alt="L'interfaccia web di Osintgram: il modulo di richiesta con un riepilogo di esecuzione che mostra limiti e costo, la risposta scritta e i risultati numerati con dettagli del profilo e hashtag">
</p>
---
## Perché potrebbe piacerti
**Risponde a domande, non solo a comandi.** *"Quanti follower hanno e quali
hashtag usano di più?"* esegue tre ricerche e restituisce una risposta scritta —
e i risultati grezzi sotto, così puoi verificare il lavoro invece di fidarti
del testo.
**Niente esce dalla tua macchina tranne le ricerche stesse.** L'AI gira
localmente tramite [Ollama](https://ollama.com): nessuna chiave OpenAI, nessun abbonamento, nessun
tuo prompt inviato a qualcuno. L'interfaccia è servita da `127.0.0.1`.
**Ti dice quanto costerà una ricerca prima che la esegui.** I dati di Instagram
non sono gratuiti, e la maggior parte degli strumenti te lo fa scoprire nel modo più costoso. Questo
preventiva la tua selezione in anticipo, mostra il credito rimanente, memorizza in cache ogni richiesta così
non paghi mai due volte la stessa ricerca, e ti permette di limitare o fermare un'esecuzione —
lato server, non solo nel browser.
**Ti mostra ciò che ha trovato, come si deve.** Miniature dei post in una griglia filtrabile,
luoghi geolocalizzati su una mappa, una heatmap giorno della settimana × ora di quando qualcuno pubblica,
confronto tra due account. Non un muro di JSON — anche se il JSON è a un
clic di distanza su ogni scheda.
**Puoi consegnare il risultato a qualcun altro.** Un pulsante trasforma una ricerca completata
in un report HTML autonomo che si apre in qualsiasi browser, senza server e senza
Osintgram.
---
## Due modi per guidarlo
<p align="center">
<img src="https://assets.kitploit.com/production/public/readmes/143/423f425ac28ff28e4a24bbfa2e327d0d6a7120758dcc141a88a05ee4dc244424/6c18229ce4134dc3117d01b134aab494b5c4e8f6e36d817b4cacd9abababebfc-display-v1.webp" width="860" alt="Modalità base: 28 comandi in due colonne, raggruppati per colore e comprimibili, con una casella di ricerca e il riepilogo di esecuzione">
</p>
**Modalità AI** — descrivi ciò che vuoi. Un modello locale sceglie i comandi, li esegue
e riassume. Può scegliere solo dalla stessa lista qui sotto; non può
inventare ricerche o fabbricare dati.
**Modalità base** — nessun modello, nessun Ollama necessario. Tutti i 29 comandi, una riga ciascuno,
raggruppati e ricercabili. Seleziona ciò che vuoi, imposta i parametri, eseguili in
ordine.
Puoi anche lasciare vuoto il nome utente in modalità AI e chiedere semplicemente di un hashtag
o di un luogo — quelle ricerche non appartengono a nessun account.
---
## Cosa puoi scoprire
| | |
|---|---|
| **Profilo** | Bio e ogni link in essa contenuto, conteggi di follower/following/post, categoria, email pubblica, telefono e indirizzo commerciale fino alle coordinate, id Facebook collegato — oltre alla sezione *Informazioni su questo account* di Instagram: paese di registrazione, data di creazione, quante volte è stato cambiato il nome utente |
| **Rete** | Follower e following, account che Instagram suggerisce come correlati, chi li ha taggati, chi hanno taggato, chi commenta di più — e **connessioni reciproche** tra due account |
| **Contenuti** | Hashtag classificati per utilizzo, didascalie, ogni commento, statistiche di like e commenti, ripartizione foto/video/carosello con visualizzazioni e partnership a pagamento, **mappa di calore degli orari di pubblicazione**, luoghi geotaggati **su una mappa**, testo alternativo delle foto |
| **Contatti** | Email e numeri di telefono pubblici tra i follower o i following di un target |
| **Nessun target necessario** | Post pubblicati con un **hashtag** (top o recenti) o da un **luogo**, e chi li ha pubblicati — oltre a ogni **commento su uno specifico post o reel**, dato il suo URL, shortcode o id |
Storie, highlight e immagini del profilo vengono restituiti come link CDN diretti — e
qualsiasi scheda contenente media offre uno zip con un clic degli originali.
---
## Avvio rapido
```bash
pip install -r requirements.txt
uvicorn src.web.app:app --host 127.0.0.1 --port 8000 --reload # or: make run
```
Apri **<http://127.0.0.1:8000>**.
Serve un backend dati. La pagina si apre su un pannello in cui puoi incollare
direttamente una chiave [HikerAPI](https://hikerapi.com) — viene verificata prima di essere
accettata e può essere salvata per la volta successiva. (Funziona anche un login gratuito
con [instagrapi](https://github.com/subzeroid/instagrapi), usando un
account Instagram proprio — consulta la guida per i compromessi.)
Per la modalità AI, installa [Ollama](https://ollama.com/download) e scarica un
modello con supporto al tool-calling:
```bash
ollama pull llama3.1:8b # ~4.7 GB, the default
```
La modalità base funziona senza di esso.
Preferisci i container?
```bash
docker compose up --build # or: make docker
```
Stesso indirizzo, stesso comportamento — pubblicato solo su `127.0.0.1`. La tua chiave, la cache
e le ricerche salvate restano sull'host in `config/`, `cache/` e `dossier/`,
mai all'interno dell'immagine. La modalità AI raggiunge un'istanza di Ollama in esecuzione sul tuo host.
> $${\color{red}Attenzione:}$$ Questo viene eseguito su `127.0.0.1` **senza autenticazione**. È pensato per essere eseguito sulla tua macchina — non esporlo oltre localhost senza prima anteporre un livello di autenticazione.
### 📖 [Leggi la guida completa → `doc/web-ui.md`](https://github.com/datalux/osintgram/blob/master/doc/web-ui.md)
Configurazione per entrambi i backend, ogni comando con i suoi parametri e costi, come
contenere la spesa, esportare e condividere i risultati, tutte le opzioni di configurazione
e la risoluzione dei problemi.
---
## Prima di usarlo
**SOLO A SCOPO EDUCATIVO.** I contributori non si assumono alcuna
responsabilità per l'uso di questo strumento.
- **Non usare il tuo account Instagram personale o principale** con esso.
- **Non committare mai `config/credentials.ini`** — le chiavi API e le credenziali di Instagram
risiedono lì. È ignorato da git; mantienilo così. Se una chiave è stata
mai pushata, ruotala: eliminare il file non la rimuove dalla cronologia.
- I risultati contengono dati personali di altre persone. Gestiscili in conformità con
la legge sulla protezione dei dati (GDPR e equivalenti) e i Termini di utilizzo di Instagram.
- Non puoi vedere i profili privati. Niente può farlo. Gli strumenti che affermano il contrario sono
truffe.
---
## Sviluppo
```bash
pip install -r requirements-dev.txt
python -m pytest
```
La suite di test viene eseguita interamente su fixture sintetiche — nessuna chiave API, nessuna quota, nessuna rete. Verifica inoltre che la documentazione non si sia discostata dal codice.
Richieste di funzionalità e pull request sono benvenute — apri una issue. Hai trovato un problema di sicurezza? Segnalalo in privato: vedi [SECURITY.md](https://github.com/datalux/osintgram/blob/master/SECURITY.md).
---
## Crediti
Osintgram è scritto da **Giuseppe Criscione** ([Datalux](https://github.com/Datalux)). La versione 2.0 lo ricostruisce attorno a un'interfaccia web e a un livello di servizio riutilizzabile, e aggiunge la modalità AI, i controlli sui costi e le analisi più recenti — vedi il [changelog](https://github.com/datalux/osintgram/blob/master/doc/CHANGELOG.md).
Deve molto a tutti coloro che hanno contribuito sin dalla prima release:
<a href="https://github.com/Datalux/Osintgram/graphs/contributors">
<img src="https://contributors-img.web.app/image?repo=Datalux/Osintgram" alt="Osintgram contributors">
</a>
I dati di Instagram provengono da [HikerAPI](https://hikerapi.com) o [instagrapi](https://github.com/subzeroid/instagrapi). Geocoding tramite [Nominatim](https://nominatim.org) / [OpenStreetMap](https://www.openstreetmap.org/copyright). Mappe tramite [Leaflet](https://leafletjs.com). Modelli locali tramite [Ollama](https://ollama.com).
Rilasciato con licenza [GPL-3.0](https://github.com/datalux/osintgram/blob/master/LICENSE).
Instagram è un marchio di Meta Platforms, Inc. Questo progetto non è affiliato, approvato o sostenuto da Meta.