Skip to content

Social Finder is an OSINT web app to search usernames across hundreds of platforms. Built with Flask and powered by Sherlock, it’s fast, privacy-friendly, and easy to deploy with Docker. A clean dashboard and a live demo make it simple to explore instantly.

Notifications You must be signed in to change notification settings

MattiaPasti/Social-Finder

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

10 Commits
 
 
 
 
 
 
 
 

Repository files navigation

🔎 Social Finder

Python Flask Gunicorn Docker OSINT

Demo


📌 Overview

Social Finder is an OSINT web application built with Flask and powered by Sherlock.
It allows you to search for a username across hundreds of social networks and get structured results in a modern web interface.

The project is fully containerized with Docker and production-ready with Gunicorn.


✨ Features

  • 🌐 Search usernames across multiple platforms (GitHub, Twitter, Instagram, etc.)
  • 📊 Clear and modern dashboard interface
  • 🐳 Docker-ready setup (easy deployment)
  • 🔒 Privacy-focused, no data stored
  • ⚡ Fast & concurrent checks using Sherlock

🛠 Tech Stack

  • Backend: Python, Flask, Gunicorn
  • Frontend: HTML, CSS, Vanilla JS
  • OSINT Engine: Sherlock
  • Deployment: Docker & Docker Compose

🚀 Getting Started

🔧 Local Installation

# Clone the repository
git clone https://github.com/MattiaPasti/Social-Finder.git
cd social-finder/Social

# Install dependencies
pip install -r backend/requirements.txt

# Run the app
cd backend
python app.py

App will run on: http://localhost:5000


🐳 Docker Setup

# Clone the repository
git clone https://github.com/MattiaPasti/Social-Finder.git
cd social-finder/Social

# Build and run
docker compose up --build

App will run on: http://localhost:8000


🌍 Live Demo

You can test Social Finder directly at: 👉 sfinder.mattiapasti.com


📜 License

This project is licensed under the MIT License – see the LICENSE file for details.


🤝 Contributing

Contributions, issues, and feature requests are welcome! Feel free to open an issue or submit a pull request.


📌 Roadmap

  • Add PDF export of search results
  • Improve detection heuristics
  • Extend supported platforms
  • Add authentication layer for private instances

📸 Preview

Screenshot 2025-08-29 215135

Screenshot 2025-08-29 215802

Screenshot 2025-08-29 215831

⚡ Built with ❤️ for OSINT & Cybersecurity research.

About

Social Finder is an OSINT web app to search usernames across hundreds of platforms. Built with Flask and powered by Sherlock, it’s fast, privacy-friendly, and easy to deploy with Docker. A clean dashboard and a live demo make it simple to explore instantly.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published