← retour aux outils back to tools

# osrframework

Open Source Research Framework pour l'OSINT de noms d'utilisateur et d'identité. Vérifie la disponibilité et la présence de noms d'utilisateur sur plus de 300 réseaux sociaux, génère des variantes de pseudos, et effectue des investigations email/domaine. Open Source Research Framework for username and identity OSINT. Checks username availability and presence across 300+ social networks, generates username variants, and performs email/domain investigation.

↗ https://github.com/i3visio/osrframework

## Overview

OSRFramework is a set of OSINT tools for username-based reconnaissance. Its flagship tool `usufy` checks if a username exists across hundreds of platforms simultaneously. Includes tools for alias generation, email investigation, and domain analysis.

## Installation

    pip3 install osrframework

## usufy — Username Search

Check a username across all platforms

    usufy -n targetuser

Check multiple usernames

    usufy -n targetuser1 targetuser2

Search specific platforms

    usufy -n targetuser -p twitter instagram github linkedin

Export results

    usufy -n targetuser -e csv -o results.csv

Full JSON export

    usufy -n targetuser -e json -o results.json

## mailfy — Email Investigation

Check if email is registered on platforms

    mailfy -n user@example.com

Multiple emails

    mailfy -n user1@example.com user2@example.com

Check breach data

    mailfy -n user@example.com --breach

## searchfy — Web Search Integration

Search for a name across platforms

    searchfy -q "John Smith"

Domain-specific search

    searchfy -q "John Smith" -p linkedin twitter

## domainfy — Domain Investigation

Check domain variations

    domainfy -n "targetcompany"

Check specific TLDs

    domainfy -n "targetcompany" -t com net org

## alias Generation

Generate username variations from real name

    alias -n "john smith"

→ Generates: jsmith, johnsmith, john.smith, j.smith, smithj, etc.

Common patterns for targeting

    alias -n "John Smith" | head -20

## Tips

- `usufy` is the most useful tool — quickly maps a username across social platforms
- False positives occur — verify results manually before using as intelligence
- Combine alias generation with usufy: `alias -n "target name" | xargs usufy -n`
- Use -p to narrow platforms and avoid noise — focus on relevant ones
- OSRFramework can be slow — run in background for large searches

Help / Man page

    Tools in OSRFramework:
      usufy     — Check username across platforms
      mailfy    — Email investigation
      searchfy  — Web search integration
      domainfy  — Domain variant checking
      alias     — Username/alias generation
      phonefy   — Phone number investigation

    usufy [options]:
      -n NICK     Username(s) to search
      -p PLATFORM Platform list (default: all)
      -e FORMAT   Export format (csv, json, xls)
      -o FILE     Output file
      -v          Verbose

## Vue d’ensemble

OSRFramework est un ensemble d’outils OSINT pour la reconnaissance basée sur les noms d’utilisateur. Son outil phare `usufy` vérifie si un nom d’utilisateur existe sur des centaines de plateformes simultanément. Inclut des outils pour la génération d’alias, l’investigation email, et l’analyse de domaine.

## Installation

    pip3 install osrframework

## usufy : recherche de nom d’utilisateur

    # Vérifier un nom d'utilisateur sur toutes les plateformes
    usufy -n targetuser

    # Vérifier plusieurs noms d'utilisateur
    usufy -n targetuser1 targetuser2

    # Rechercher sur des plateformes spécifiques
    usufy -n targetuser -p twitter instagram github linkedin

    # Exporter les résultats
    usufy -n targetuser -e csv -o results.csv

    # Export JSON complet
    usufy -n targetuser -e json -o results.json

## mailfy : investigation email

    # Vérifier si un email est enregistré sur des plateformes
    mailfy -n user@example.com

    # Plusieurs emails
    mailfy -n user1@example.com user2@example.com

    # Vérifier les données de fuite (breach)
    mailfy -n user@example.com --breach

## searchfy : intégration de recherche web

    # Rechercher un nom sur plusieurs plateformes
    searchfy -q "John Smith"

    # Recherche spécifique à un domaine
    searchfy -q "John Smith" -p linkedin twitter

## domainfy : investigation de domaine

    # Vérifier les variations de domaine
    domainfy -n "targetcompany"

    # Vérifier des TLD spécifiques
    domainfy -n "targetcompany" -t com net org

## Génération d’alias

    # Générer des variations de nom d'utilisateur depuis un vrai nom
    alias -n "john smith"
    # -> Génère : jsmith, johnsmith, john.smith, j.smith, smithj, etc.

    # Motifs courants pour le ciblage
    alias -n "John Smith" | head -20

## Conseils

- `usufy` est l’outil le plus utile : cartographie rapidement un nom d’utilisateur sur les plateformes sociales
- Des faux positifs surviennent : vérifier manuellement les résultats avant de les utiliser comme renseignement
- Combiner la génération d’alias avec usufy : `alias -n "target name" | xargs usufy -n`
- Utiliser -p pour restreindre les plateformes et éviter le bruit : se concentrer sur celles pertinentes
- OSRFramework peut être lent : lancer en arrière-plan pour les recherches volumineuses

Aide / Page de manuel

    Tools in OSRFramework:
      usufy     — Check username across platforms
      mailfy    — Email investigation
      searchfy  — Web search integration
      domainfy  — Domain variant checking
      alias     — Username/alias generation
      phonefy   — Phone number investigation

    usufy [options]:
      -n NICK     Username(s) to search
      -p PLATFORM Platform list (default: all)
      -e FORMAT   Export format (csv, json, xls)
      -o FILE     Output file
      -v          Verbose