Skip to content
Social Recon
Python HTML CSS Other
Branch: master
Clone or download

Build Status

Coverage Status

Social Recon

This application locates and compiles information about online personalities, given a username and/or email address. Use this to investigate your own online presence, summarize the digital footprint of someone you know, or uncover the person behind a specific username.

Getting Started

  • Clone or fork the repo to your machine.
  • Once downloaded, cd into the osint-scraper directory.
  • Begin a new virtual environment with Python 3 and activate it.
    • python3 -m venv ENV
    • source ENV/bin/activate
  • cd into the next osint-scraper directory. It should be at the same level of the file.
  • pip install -e . or pip install -r requirements.txt on the command line to install all dependencies.
  • $ pserve development.ini --reload to serve the application on http://localhost:6543


  • Python 3.5
  • See requirements.txt and


Kavdi Hodgson

Gabriel Meringolo

Chris Closser

Matt Favoino

Bernard Bass - For french translation.


This project is licensed under the MIT License - see the file for details


French translation

Social Recon

Sous Debian Stretch et Kali Linux 2018

git clone
cd osint-scraper

Pour Debian Stretch

apt-get install python-pip
apt-get install python3
apt-get install python3-pip

Pour Kali Linux

apt-get install python3-venv

Créer un environnement virtuel en python3 et activer le avant d'installer les éléments nécessaires.
Passer en root
python3 -m venv ENV
source ENV/bin/activate
pip install -r requirements.txt
pip install -e .
pserve development.ini

Starting server in PID 2408.
Serving on http://localhost:6543
Serving on http://localhost:6543

Une fois la machine redémarrée, relancer le service de la façon suivante :
Se placer dans le dossier de osint-scraper
python3 -m venv ENV
source ENV/bin/activate
pserve development.ini

You can’t perform that action at this time.