A lightweight Python command-line toolkit for gathering publicly available username, domain and IP information.
Features • Installation • Usage • Reports • Contributing
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.
Checks whether a username appears to exist on supported platforms:
- GitHub
- GitLab
The report includes:
- Platform name
- Profile URL
- HTTP status code
- Whether the profile was detected
Collects common DNS records for a supplied domain:
A— IPv4 address recordsAAAA— IPv6 address recordsMX— Mail server recordsNS— Authoritative name serversTXT— Text and verification recordsCNAME— Canonical name records
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.
Each completed lookup is automatically saved in the reports/ directory with a timestamped filename.
Example:
reports/example_com_20260819_104500.json
| 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 |
Simple-Osint/
├── main.py
├── requirements.txt
├── modules/
│ ├── __init__.py
│ ├── domain.py
│ ├── ip.py
│ └── username.py
├── reports/ # Generated automatically
├── .gitignore
├── LICENSE
└── README.md
- 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.
git clone https://github.com/Ankit-ku-panda/Simple-Osint.git
cd Simple-Osintpython -m venv .venv
.\.venv\Scripts\Activate.ps1If PowerShell blocks activation, run:
Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass
.\.venv\Scripts\Activate.ps1python3 -m venv .venv
source .venv/bin/activatepip install -r requirements.txtStart the application:
python main.pypython3 main.pyThe 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.
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
Select option 2, then enter a domain without a URL path:
Domain: example.com
Do not include https://, /login, query parameters or fragments.
Select option 3, then enter a valid IPv4 or IPv6 address:
IP address: 8.8.8.8
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.
- Username detection is currently limited to GitHub, GitLab and Reddit.
- An HTTP
200response 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.
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.
- 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
Contributions are welcome.
- Fork the repository.
- Create a feature branch:
git checkout -b feature/your-feature- Make and test your changes.
- Commit the changes:
git commit -m "Add your feature"- Push your branch:
git push origin feature/your-feature- Open a pull request.
Please ensure new OSINT modules use public information responsibly and handle network failures, timeouts and rate limits safely.
Ankit Kumar Panda
- GitHub: @Ankit-ku-panda
- Repository: Simple-Osint
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 ⭐.