Osintgram ist ein OSINT-Tool für Instagram. Es bietet eine interaktive Shell, um Analysen von Instagram-Konten beliebiger Benutzer anhand ihres Benutzernamens durchzuführen.
# Osintgram 🔎📸
[](doc/CHANGELOG.md)
[](LICENSE)
[](https://www.python.org/)
[](.github/workflows/tests.yml)
[](#quick-start)
**Richte es auf ein Instagram-Konto und finde heraus, wer dahintersteckt.** Osintgram
sammelt, verknüpft und stellt alles dar, was ein öffentliches Profil preisgibt
– Follower, Bildunterschriften, Hashtags, mit Geotags versehene Orte, Posting-Gewohnheiten, öffentliche
Kontaktdaten – in einer Web-Oberfläche, die du auf deiner eigenen Maschine betreibst.
Stelle deine Frage in natürlicher Sprache und ein **lokales KI-Modell** ermittelt, welche Abfragen
ausgeführt werden sollen. Oder auch nicht: Wähle die Befehle selbst und überspringe das Modell ganz.
<p align="center">
<img src="https://assets.kitploit.com/production/public/readmes/143/d6eaa19d795a604cab713f300cd9b5db4dce554bc604e3436a88d3d63e6f132b/6e4b370c0dd97191375d1281f84ddf2bc1653a0379d942b46787fd1ebe124ba0-display-v1.webp" width="900" alt="Die Osintgram-Weboberfläche: das Anfrageformular mit einem Ausführungsblatt, das Limits und Kosten anzeigt, die schriftliche Antwort und nummerierte Ergebnisbelege mit Profildetails und Hashtags">
</p>
---
## Warum es dir gefallen könnte
**Es beantwortet Fragen, nicht nur Befehle.** *„Wie viele Follower haben sie und welche
Hashtags verwenden sie am häufigsten?“* führt drei Abfragen aus und liefert eine schriftliche Antwort –
und darunter die Rohdaten, sodass du die Arbeit überprüfen kannst, statt dem
Text zu vertrauen.
**Nichts verlässt deine Maschine außer den Abfragen selbst.** Die KI läuft
lokal über [Ollama](https://ollama.com): kein OpenAI-Schlüssel, kein Abonnement, kein
Prompt von dir wird an irgendjemanden gesendet. Die Oberfläche wird von `127.0.0.1` ausgeliefert.
**Es sagt dir, was eine Suche kostet, bevor du sie ausführst.** Instagram-Daten
sind nicht kostenlos, und die meisten Tools lassen dich das auf die teure Art herausfinden. Dieses
berechnet deine Auswahl im Voraus, zeigt dein verbleibendes Guthaben an, cached jede Anfrage, sodass
du nie zweimal für dieselbe Abfrage zahlst, und lässt dich einen Lauf begrenzen oder stoppen –
serverseitig, nicht nur im Browser.
**Es zeigt dir, was es gefunden hat, und zwar richtig.** Post-Vorschaubilder in einem filterbaren Raster,
mit Geotags versehene Orte auf einer Karte, eine Wochentag-×-Stunde-Heatmap, wann jemand postet,
Vergleich zwischen zwei Konten. Keine JSON-Wand – obwohl das JSON auf
jeder Karte nur einen Klick entfernt ist.
**Du kannst das Ergebnis an jemand anderen weitergeben.** Ein Knopfdruck verwandelt eine abgeschlossene Suche
in einen eigenständigen HTML-Bericht, der sich in jedem Browser öffnen lässt, ohne Server und ohne
Osintgram.
---
## Zwei Arten, es zu steuern
<p align="center">
<img src="https://assets.kitploit.com/production/public/readmes/143/423f425ac28ff28e4a24bbfa2e327d0d6a7120758dcc141a88a05ee4dc244424/6c18229ce4134dc3117d01b134aab494b5c4e8f6e36d817b4cacd9abababebfc-display-v1.webp" width="860" alt="Basis-Modus: 28 Befehle in zwei Spalten, farblich gruppiert und einklappbar, mit einem Suchfeld und dem Ausführungsblatt">
</p>
**KI-Modus** – beschreibe, was du willst. Ein lokales Modell wählt die Befehle aus, führt
sie aus und fasst zusammen. Es kann nur aus derselben Liste unten wählen; es kann keine
Abfragen erfinden oder Daten erfinden.
**Basis-Modus** – kein Modell, kein Ollama nötig. Alle 29 Befehle, eine Zeile pro Befehl,
gruppiert und durchsuchbar. Hake an, was du willst, lege die Parameter fest, führe sie
der Reihe nach aus.
Du kannst im KI-Modus auch den Benutzernamen leer lassen und einfach nach einem Hashtag
oder einem Ort fragen – diese Suchen gehören zu keinem Konto.
---
## Was du herausfinden kannst
| | |
|---|---|
| **Profil** | Bio und jeder darin enthaltene Link, Follower-/Following-/Post-Zähler, Kategorie, öffentliche E-Mail, Telefon und Geschäftsadresse bis hin zu den Koordinaten, verknüpfte Facebook-ID — plus Instagrams eigene *Info zu diesem Konto*: Land der Registrierung, Erstellungsdatum, wie oft der Benutzername geändert wurde |
| **Netzwerk** | Follower und Followings, von Instagram als verwandt vorgeschlagene Konten, wer sie markiert hat, wen sie markiert haben, wer am meisten kommentiert — und **gemeinsame Verbindungen** zwischen zwei Konten |
| **Inhalt** | Hashtags nach Verwendung sortiert, Bildunterschriften, jeder Kommentar, Like- und Kommentarstatistiken, Aufschlüsselung nach Foto/Video/Karussell mit Aufrufen und bezahlten Partnerschaften, **Heatmap der Posting-Zeiten**, geotagged Standorte **auf einer Karte**, Foto-Alt-Text |
| **Kontakte** | Öffentliche E-Mail-Adressen und Telefonnummern unter den Followern oder Followings eines Ziels |
| **Kein Ziel erforderlich** | Beiträge, die mit einem **Hashtag** (Top oder Aktuell) oder von einem **Ort** veröffentlicht wurden, und wer sie veröffentlicht hat — plus jeder **Kommentar zu einem bestimmten Beitrag oder Reel**, angegeben über dessen URL, Shortcode oder ID |
Stories, Highlights und Profilbilder werden als direkte CDN-Links zurückgegeben — und
jede Karte mit Medien bietet einen Ein-Klick-Zip der Originale.
---
## Schnellstart
```bash
pip install -r requirements.txt
uvicorn src.web.app:app --host 127.0.0.1 --port 8000 --reload # or: make run
```
Öffne **<http://127.0.0.1:8000>**.
Du benötigst ein Daten-Backend. Die Seite öffnet sich auf einem Panel, in dem du einen
[HikerAPI](https://hikerapi.com)-Schlüssel direkt einfügen kannst — er wird vor der
Annahme verifiziert und kann für das nächste Mal gespeichert werden. (Ein kostenloser
[instagrapi](https://github.com/subzeroid/instagrapi)-Login funktioniert ebenfalls, mit einem
eigenen Instagram-Konto — siehe die Anleitung für die Abwägungen.)
Für den KI-Modus installiere [Ollama](https://ollama.com/download) und lade ein
tool-calling-fähiges Modell herunter:
```bash
ollama pull llama3.1:8b # ~4.7 GB, the default
```
Der Basis-Modus funktioniert ohne ihn.
Bevorzugen Sie Container?
```bash
docker compose up --build # or: make docker
```
Gleiche Adresse, gleiches Verhalten — nur auf `127.0.0.1` veröffentlicht. Dein Schlüssel, Cache und deine gespeicherten Suchen bleiben auf dem Host in `config/`, `cache/` und `dossier/`, niemals im Image. Der KI-Modus erreicht ein auf deinem Host laufendes Ollama.
> $${\color{red}Warnung:}$$ Dies läuft auf `127.0.0.1` **ohne Authentifizierung**. Es ist dafür gedacht, auf deiner eigenen Maschine zu laufen — stelle es nicht über localhost hinaus bereit, ohne zuvor eine Authentifizierungsschicht davorzusetzen.
### 📖 [Die vollständige Anleitung lesen → `doc/web-ui.md`](https://github.com/datalux/osintgram/blob/master/doc/web-ui.md)
Einrichtung für beide Backends, jeder Befehl mit seinen Parametern und Kosten, wie du die Ausgaben gering hältst, Exportieren und Teilen von Ergebnissen, alle Konfigurationsoptionen und Fehlerbehebung.
---
## Bevor du es verwendest
**NUR FÜR BILDUNGSZWECKE.** Die Mitwirkenden übernehmen keinerlei Verantwortung für die Verwendung dieses Tools.
- **Verwende dafür nicht dein eigenes oder dein primäres Instagram-Konto.**
- **Committen Sie niemals `config/credentials.ini`** — dort liegen API-Schlüssel und Instagram-Zugangsdaten. Die Datei ist git-ignoriert; das sollte so bleiben. Falls ein Schlüssel jemals gepusht wurde, rotiere ihn: Das Löschen der Datei entfernt ihn nicht aus der Historie.
- Ergebnisse enthalten personenbezogene Daten anderer Personen. Behandle sie im Einklang mit dem Datenschutzrecht (DSGVO und Entsprechungen) und den Nutzungsbedingungen von Instagram.
- Du kannst private Profile nicht sehen. Nichts kann das. Tools, die etwas anderes behaupten, sind Betrug.
---
## Entwicklung
```bash
pip install -r requirements-dev.txt
python -m pytest
```
Die Testsuite läuft vollständig gegen synthetische Fixtures — kein API-Schlüssel, kein Kontingent, kein Netzwerk. Sie prüft außerdem, ob die Dokumentation nicht vom Code abgewichen ist.
Feature-Anfragen und Pull Requests sind willkommen — eröffne ein Issue. Ein Sicherheitsproblem gefunden? Bitte melde es stattdessen privat: siehe [SECURITY.md](https://github.com/datalux/osintgram/blob/master/SECURITY.md).
---
## Danksagungen
Osintgram wird von **Giuseppe Criscione** ([Datalux](https://github.com/Datalux)) geschrieben. Version 2.0 baut es rund um eine Weboberfläche und eine wiederverwendbare Service-Schicht neu auf und fügt den KI-Modus, die Kostenkontrollen und die neueren Analysen hinzu — siehe das [Changelog](https://github.com/datalux/osintgram/blob/master/doc/CHANGELOG.md).
Es verdankt sehr viel allen, die seit der ersten Veröffentlichung beigetragen haben:
<a href="https://github.com/Datalux/Osintgram/graphs/contributors">
<img src="https://contributors-img.web.app/image?repo=Datalux/Osintgram" alt="Osintgram contributors">
</a>
Instagram-Daten stammen von [HikerAPI](https://hikerapi.com) oder [instagrapi](https://github.com/subzeroid/instagrapi). Geocoding durch [Nominatim](https://nominatim.org) / [OpenStreetMap](https://www.openstreetmap.org/copyright). Karten von [Leaflet](https://leafletjs.com). Lokale Modelle über [Ollama](https://ollama.com).
Veröffentlicht unter der [GPL-3.0](https://github.com/datalux/osintgram/blob/master/LICENSE)-Lizenz.
Instagram ist eine Marke von Meta Platforms, Inc. Dieses Projekt ist nicht mit Meta verbunden, wird nicht von Meta unterstützt und ist nicht von Meta genehmigt.