Skip to content

Un outil de reconnaissance open-source (OSINT) en ligne de commande permettant de rechercher des informations sur des pseudos, des adresses IP et de vérifier si une IP est associée à un VPN.

Notifications You must be signed in to change notification settings

S29Duckys/osint-tool

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

7 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

OSINT Tool

Un outil de reconnaissance open-source (OSINT) en ligne de commande permettant de rechercher des informations sur des pseudos, des adresses IP et de vérifier si une IP est associée à un VPN.

Description

OSINT Tool est une application Python interactive qui facilite la collecte d'informations publiques via plusieurs API et outils. Il offre une interface menu intuitive pour :

  • Recherche par pseudonyme : Trouver les comptes associés à un pseudo sur plusieurs plateformes via Sherlock
  • Recherche IP : Obtenir des informations géographiques et organisationnelles sur une adresse IP
  • Vérification VPN : Déterminer si une IP est associée à un service VPN
  • Scanner les ports d'une IP pour vérifier leur état (ouvert/fermé)

Prérequis

  • Python 3.7+
  • pip (gestionnaire de paquets Python)
  • Les outils suivants installés :
    • sherlock (pour la recherche de pseudos)
    • curl (pour les animations lors de la recherche)

Installation

1. Cloner le projet

git clone https://github.com/username/osint-tool.git
cd osint-tool/osint

2. Créer un environnement virtuel (recommandé)

python -m venv venv
# Windows
venv\Scripts\activate
# Linux/Mac
source venv/bin/activate

3. Installer les dépendances Python

pip install -r requirements.txt

4. Installer Sherlock

pip install sherlock-project

5. Installer curl (si nécessaire)

Windows : Curl est généralement pré-installé. Sinon :

choco install curl

Linux :

sudo apt-get install curl

Mac :

brew install curl

6. Configurer les variables d'environnement

Créez un fichier .env à la racine du projet :

API_KEY__VPNAPI=votre_cle_api_vpnapi

Obtenez votre clé API sur vpnapi.io

Utilisation

Lancer l'application

python src/osint/main.py

Navigation

L'application utilise le clavier pour la navigation :

  • 0 : Quitter / Retour au menu précédent
  • 1 : Menu IP ou Rechercher une adresse IP
  • 2 : Menu Pseudos ou Vérifier un VPN

Fonctionnalités détaillées

Menu IP

  • Rechercher une adresse IP (ville, région, pays, organisation)
  • Vérifier si une IP est associée à un VPN (informations complètes)
  • Scanner les ports d'une IP pour vérifier leur état (ouvert/fermé)

Menu Pseudos

  • Rechercher un pseudo sur plusieurs plateformes (Twitter, Instagram, GitHub, etc.)

Structure du projet

osint-tool/
├── osint/
│   └── src/
│       └── osint/
│           └── main.py          # Fichier principal
├── .env                          # Variables d'environnement
├── requirements.txt              # Dépendances Python
└── README.md                     # Ce fichier

Fichier requirements.txt

requests==2.31.0
keyboard==0.13.5
python-dotenv==1.0.0
colorama==0.4.6
sherlock-project==0.14.3

Dépannage

Erreur "sherlock not found"

Assurez-vous que Sherlock est installé :

pip install sherlock-project

Erreur API VPN

  • Vérifiez que votre clé API est correctement configurée dans .env
  • Vérifiez votre connexion Internet
  • Vérifiez les limites d'appels API de votre compte VPN API

Erreur keyboard

Assurez-vous d'exécuter le script avec les permissions appropriées.

API utilisées

  • ipinfo.io : Géolocalisation et informations IP
  • vpnapi.io : Détection VPN et informations détaillées
  • Sherlock : Recherche de pseudos sur les réseaux sociaux

Licence

Ce projet est sous licence MIT.

Contribution

Les contributions sont bienvenues ! N'hésitez pas à ouvrir une issue ou une pull request.

Avertissement légal

Cet outil est destiné à des fins éducatives et de recherche légale uniquement. L'utilisateur est responsable de son utilisation et doit respecter les lois locales et internationales concernant la collecte et l'utilisation de données.

About

Un outil de reconnaissance open-source (OSINT) en ligne de commande permettant de rechercher des informations sur des pseudos, des adresses IP et de vérifier si une IP est associée à un VPN.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages