Home

Awesome

Inforensics - OSINT Discovery Tools

Inforensics
OSINT Discovery is a set of Python scripts designed to search for users or URLs across different social media platforms and caching services. Currently, it supports searching for users on Nostr and Mastodon networks, searching for cached tweets across various archiving services, and searching for cached versions of any URL. Along with report generator for any domain. Created by inforensics.ai

Scripts

1. Nostr User Search

This script searches for a Nostr user across multiple relays.

Features:

Usage:

python nostr-user-search.py [-h] [-r RELAYS [RELAYS ...]] [-f FILE] [-v] identifier

2. Mastodon User Search

This script searches for a Mastodon user across multiple instances.

Features:

Usage:

python mastodon-user-search.py [-h] [-c COUNT] [-m MIN_USERS] [--include-down] [--include-closed] [-v] [-i INSTANCES [INSTANCES ...]] [-f FILE] username

3. Tweet Cache Search

This script searches for cached tweets of a specified Twitter username across multiple archiving and caching services.

Features:

Usage:

python tweet-cache-search.py [-h] [-u USERNAME] [-o]

4. Cache-Me-Outside

This script searches for cached versions of any URL across various caching and archiving services.

Features:

Usage:

python cache-me-outside.py [-h] [-u URL] [-o] [-j]

Installation

  1. Clone the repository:
    git clone https://github.com/inforensics-ai/osint-user-discovery.git
    
  2. Navigate to the project directory:
    cd osint-user-discovery
    
  3. Each script will attempt to install its required dependencies when run. However, you can also install all dependencies manually:
    pip install -r requirements.txt
    

5. Domain Intelligence Tool

This script performs comprehensive intelligence gathering on a specified domain.

Features:

Usage:

python domain-intelligence-tool.py [-h] [--json] [--markdown] [--config CONFIG] domain

Installation

  1. Clone the repository:
    git clone https://github.com/inforensics-ai/osint-user-discovery.git
    
  2. Navigate to the project directory:
    cd osint-user-discovery/domain-intelligence-tool
    
  3. Each script will attempt to install its required dependencies when run. However, you can also install all dependencies manually:
    pip install -r requirements.txt
    
  4. For the Domain Intelligence Tool:
    • Create a config.json file in the same directory as the script with the following structure:
      {
          "api_keys": {
              "geoip2": "your_geoip2_api_key_here"
          },
          "markdown_output_path": "/path/to/output/directory",
          "geolite2_db_path": "/path/to/GeoLite2-City.mmdb"
      }
      
    • Download the GeoLite2-City.mmdb database and place it in the location specified in your config.json file.

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

License

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

Disclaimer

These tools are for educational and research purposes only. Always respect privacy and adhere to the terms of service of the platforms you're querying. Ensure you have permission before performing any scans or intelligence gathering on domains you do not own.

Contact

For bug reports and feature requests, please open an issue on this repository.