Skip to content

About

Python OSINT toolkit for username search, DNS lookup, IP intelligence, information gathering and automated JSON security reports.

Topics

Resources

Stars

11 stars

Watchers

0 watching

Forks

Latest commit

 

History

3 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Simple OSINT

A lightweight Python command-line toolkit for gathering publicly available username, domain and IP information.

Python OSINT License: MIT Platform

Features • Installation • Usage • Reports • Contributing


Overview

Simple OSINT is a modular, beginner-friendly command-line tool written in Python for collecting publicly available information.

It provides three investigation modes:

  • Username discovery across supported public platforms
  • Domain and DNS record enumeration
  • IP address validation and public network information lookup

Every investigation automatically produces a timestamped JSON report that can be reviewed, archived or processed by another application.

This project is intended for education, defensive security, research and authorized investigations only.

Features

Username Search

Checks whether a username appears to exist on supported platforms:

  • GitHub
  • GitLab
  • Reddit

The report includes:

  • Platform name
  • Profile URL
  • HTTP status code
  • Whether the profile was detected

Domain and DNS Lookup

Collects common DNS records for a supplied domain:

  • A — IPv4 address records
  • AAAA — IPv6 address records
  • MX — Mail server records
  • NS — Authoritative name servers
  • TXT — Text and verification records
  • CNAME — Canonical name records

IP Address Lookup

Collects available information about an IPv4 or IPv6 address:

  • IP version
  • Private or public classification
  • Global reachability status
  • Reverse DNS hostname
  • Country
  • Region
  • City
  • Organization
  • ASN information when available

Public location and organization information is requested from the ipinfo.io service.

JSON Reports

Each completed lookup is automatically saved in the reports/ directory with a timestamped filename.

Example:

reports/example_com_20260819_104500.json

Technology Stack

Technology Purpose
Python Application and CLI logic
Requests HTTP requests and public profile checks
dnspython DNS record resolution
ipaddress IP validation and classification
socket Reverse DNS resolution
JSON Structured report storage

Project Structure

Simple-Osint/
├── main.py
├── requirements.txt
├── modules/
│   ├── __init__.py
│   ├── domain.py
│   ├── ip.py
│   └── username.py
├── reports/             # Generated automatically
├── .gitignore
├── LICENSE
└── README.md

Requirements

  • Python 3.9 or newer
  • pip
  • An internet connection for public profile and IP intelligence requests

The core IP validation functions work locally, but external profile checks, DNS resolution and public IP information require network access.

Installation

1. Clone the repository

git clone https://github.com/Ankit-ku-panda/Simple-Osint.git
cd Simple-Osint

2. Create a virtual environment

Windows PowerShell

python -m venv .venv
.\.venv\Scripts\Activate.ps1

If PowerShell blocks activation, run:

Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass
.\.venv\Scripts\Activate.ps1

Linux or macOS

python3 -m venv .venv
source .venv/bin/activate

3. Install the dependencies

pip install -r requirements.txt

Usage

Start the application:

Windows

python main.py

Linux or macOS

python3 main.py

The following menu will appear:

==================================================
              SIMPLE OSINT
==================================================

1. Username search
2. Domain/DNS lookup
3. IP lookup
4. Exit

Enter the number corresponding to the lookup you want to perform.

Usage Examples

Username Search

Select option 1, then enter a username:

Username: octocat

Example output:

[+] GitHub: Found
[-] GitLab: Not found
[-] Reddit: Not found

[+] Report saved: reports/octocat_20260819_104500.json

Domain Lookup

Select option 2, then enter a domain without a URL path:

Domain: example.com

Do not include https://, /login, query parameters or fragments.

IP Lookup

Select option 3, then enter a valid IPv4 or IPv6 address:

IP address: 8.8.8.8

JSON Reports

A generated username report follows this general format:

{
    "tool": "Simple OSINT",
    "type": "username",
    "target": "octocat",
    "timestamp": "2026-08-19T10:45:00",
    "results": [
        {
            "site": "GitHub",
            "found": true,
            "status_code": 200,
            "url": "https://github.com/octocat"
        }
    ]
}

Reports may contain information returned by external services. Verify important results independently before relying on them.

Limitations

  • Username detection is currently limited to GitHub, GitLab and Reddit.
  • An HTTP 200 response does not always guarantee that a profile belongs to the intended person.
  • Some websites may use redirects, bot protection or rate limiting.
  • DNS results depend on the configured resolver and current DNS state.
  • IP geolocation is approximate and does not reveal an exact physical address.
  • External API availability and rate limits may affect results.
  • Results can become outdated as public information changes.

Responsible Use

Use Simple OSINT only for lawful purposes, including:

  • Researching your own digital footprint
  • Authorized security assessments
  • Defensive cybersecurity
  • Academic learning
  • Verifying publicly available technical information

Do not use this project to harass, stalk, impersonate, threaten or invade another person's privacy. Do not attempt unauthorized access or use collected information for malicious activity.

You are responsible for complying with applicable laws, platform terms and organizational policies.

Roadmap

  • Add more username platforms
  • Support command-line arguments
  • Add CSV and HTML report formats
  • Add WHOIS and SSL certificate inspection
  • Improve input validation
  • Add optional API-key configuration
  • Add asynchronous username checks
  • Add automated tests
  • Add configurable request delays
  • Package the project as an installable Python CLI

Contributing

Contributions are welcome.

  1. Fork the repository.
  2. Create a feature branch:
git checkout -b feature/your-feature
  1. Make and test your changes.
  2. Commit the changes:
git commit -m "Add your feature"
  1. Push your branch:
git push origin feature/your-feature
  1. Open a pull request.

Please ensure new OSINT modules use public information responsibly and handle network failures, timeouts and rate limits safely.

Author

Ankit Kumar Panda

License

This project is licensed under the MIT License.

Third-party services and Python packages remain subject to their own licenses and terms of use.


If you find this project useful, consider giving it a ⭐.

About

Python OSINT toolkit for username search, DNS lookup, IP intelligence, information gathering and automated JSON security reports.

Topics

Resources

Stars

11 stars

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors

Languages