Skip to content

Commit

Permalink
Update README.md
Browse files Browse the repository at this point in the history
  • Loading branch information
AnonCatalyst authored Oct 27, 2023
1 parent 8e1c381 commit f027f08
Showing 1 changed file with 48 additions and 8 deletions.
56 changes: 48 additions & 8 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,14 +1,43 @@
>># Ominis OSINT Toolkit 🌐🕵️‍♂️
># Ominis OSINT Toolkit 🌐🕵️‍♂️
**Information Obtained**
Discover online mentions of a query or username.
Identify potential social profiles and forums.
Enhance web searches with SerpApi for more accurate results.

**Why Ominis?**
Ominis offers a unified solution for multiple OSINT tasks.
Threading improves efficiency for username searches.
SerpApi integration enhances web search capabilities.

**Contributing**
Contributions are welcome! Fork the repository, make changes, and submit a pull request.
License

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

🚀 Happy OSINTing! 🕵️‍♂️

<img src="src/img/screenshot.png" alt="Ominis Osint Project - screenshot" width="550" height="430"/>

>## Overview
Ominis OSINT Tool is a powerful open-source tool designed for OSINT (Open-Source Intelligence) investigations. It combines three scripts to perform web searches, username searches, and gather information using the SerpApi service.

## Features

### Integrated OSINT Toolkit
Ominis OSINT Toolkit brings together three specialized scripts, creating an integrated toolkit for Open Source Intelligence. This integration ensures a seamless and cohesive experience for users engaged in digital reconnaissance.
- **Web Search (Google):**
- Search the web for a given query.
- Extracts information from search results.
- Detects mentions in titles and URLs.

### Specialized Scripts
Each script within Ominis OSINT Tools focuses on a specific area of OSINT, allowing users to tailor their investigations according to their requirements. The scripts are meticulously crafted to deliver efficient and accurate results.
- **Username Search:**
- Searches a list of URLs for a specific username.
- Utilizes threading for parallel execution.
- Provides detailed results with URL and HTTP status code.

- **SerpApi Integration:**
- Utilizes SerpApi for enhanced web searches.
- Retrieves Google search results programmatically.
- Option to use SerpApi with your API key (optional).

### Digital Reconnaissance
Positioned as a robust solution for digital reconnaissance, Ominis OSINT Tools excels in gathering and analyzing publicly available information from online sources. The toolkit empowers users with the capability to navigate and extract valuable insights from the vast landscape of digital data.
Expand All @@ -22,6 +51,15 @@ Ominis OSINT Tools is dedicated to delivering results that are not only targeted
- **User-Friendly Interface:** Meticulously designed for ease of use, ensuring a smooth experience for both novice and experienced users.
- **Digital Reconnaissance Excellence:** Leverage the toolkit's strength in digital reconnaissance to uncover valuable insights.

- **Results:**
- Results are displayed in the terminal with detailed information.
- Social profiles, mentions, and potential forum links are extracted.

## Configuration

- Web search uses Google by default.
- Configure the list of URLs in `src/urls.txt` for username searches.

## Installation
```
git clone https://github.com/AnonCatalyst/Ominis-Osint
Expand All @@ -34,5 +72,7 @@ Ominis OSINT Tools is dedicated to delivering results that are not only targeted
3. Run the desired script:
- `python3 Ominis.py`

> **|NOTE**
~ Place SerpAPI key in src/api_key.json file if you would like to make use of SerpAPI.
## SerpApi Integration (Optional)

- To use SerpApi for web searches, obtain an API key from the [SerpApi Dashboard](https://serpapi.com/dashboard).
- Save the API key in `src/api_key.json` file.

0 comments on commit f027f08

Please sign in to comment.