Skip to content

A powerful Go tool for finding origin IPs of domains by querying multiple security APIs and validating results with built-in HTTP client.

Notifications You must be signed in to change notification settings

rix4uni/originiphunter

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

12 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

OriginipHunter

A powerful Go tool for finding origin IPs of domains by querying multiple security APIs and validating results with built-in HTTP client.

Supported Search Engines

Engine Status Methods
Shodan ✅ Active Favicon hash, Title, SSL certificate
Hunter ✅ Active Favicon hash, Title, Certificate
SecurityTrails ✅ Active DNS history
ViewDNS ✅ Active IP history
Censys 🚧 Coming Soon -
FOFA 🚧 Coming Soon -

Installation

Install via Go

go install github.com/rix4uni/originiphunter@latest

Download Prebuilt Binaries

wget https://github.com/rix4uni/originiphunter/releases/download/v0.0.4/originiphunter-linux-amd64-0.0.4.tgz
tar -xvzf originiphunter-linux-amd64-0.0.4.tgz
rm -rf originiphunter-linux-amd64-0.0.4.tgz
mv originiphunter ~/go/bin/originiphunter

Or download the latest release for your platform.

Compile from Source

git clone --depth 1 https://github.com/rix4uni/originiphunter.git
cd originiphunter; go install

Note: You can add multiple Free API keys per service for load balancing and rate limit management.

Get Free API Keys

Configuration

Default Config Location

The tool uses ~/.config/originiphunter/config.yaml by default.

Create Config File

  1. Create config directory:
mkdir -p ~/.config/originiphunter
  1. Create config.yaml:
securitytrails:
  - "YOUR_SECURITYTRAILS_API_KEY_1"
  - "YOUR_SECURITYTRAILS_API_KEY_2"
shodan:
  - "YOUR_SHODAN_API_KEY_1"
  - "YOUR_SHODAN_API_KEY_2"
viewdns:
  - "YOUR_VIEWDNS_API_KEY_1"
  - "YOUR_VIEWDNS_API_KEY_2"
hunter:
  - "YOUR_HUNTER_API_KEY_1"
  - "YOUR_HUNTER_API_KEY_2"
censys: []
fofa: []

Usage

Usage of originiphunter:
      --config string    Custom config file path (default: ~/.config/originhunter/config.yaml)
      --engine strings   Specific search engines to use (comma-separated). Available: shodan,securitytrails,viewdns,hunter,censys,fofa
      --silent           Silent mode.
      --verbose          Show detailed information about the scanning process
      --version          Print the version of the tool and exit.

Basic Usage

Process a single domain:

echo "example.com" | originiphunter

Process multiple domains:

cat domains.txt | originiphunter

Command Line Options

Flag Shorthand Description
--engine - Specify which search engines to use (comma-separated: shodan,securitytrails,viewdns,hunter,censys,fofa)
--config - Use a custom config file path
--verbose - Show detailed information about the scanning process
--useragent -H HTTP User-Agent header (default: Mozilla/5.0 Chrome/141.0.0.0)
--silent - Silent mode (no banner)
--version - Print version and exit

Examples

# Use all configured engines (default)
echo "example.com" | originiphunter

# Use specific engines only
echo "example.com" | originiphunter --engine shodan,hunter

# Enable verbose mode for detailed output
echo "example.com" | originiphunter --verbose

# Use custom config file
echo "example.com" | originiphunter --config /path/to/config.yaml

# Custom User-Agent
echo "example.com" | originiphunter -H "MyBot/1.0"

# Process multiple domains silently
cat domains.txt | originiphunter --silent

# Show version
originiphunter --version

Output

Example Output

                _         _         _         __                   __
  ____   _____ (_)____ _ (_)____   (_)____   / /_   __  __ ____   / /_ ___   _____
 / __ \ / ___// // __  // // __ \ / // __ \ / __ \ / / / // __ \ / __// _ \ / ___/
/ /_/ // /   / // /_/ // // / / // // /_/ // / / // /_/ // / / // /_ /  __// /
\____//_/   /_/ \__, //_//_/ /_//_// .___//_/ /_/ \__,_//_/ /_/ \__/ \___//_/
               /____/             /_/

                     Current originiphunter version v0.0.4

Processing: aiaqa.visa.com
https://aiaqa.visa.com [200] [12746] [Visa - Public Key Infrastructure]

Origin IPs Found:
http://198.241.171.81 [200] [12746] [Visa - Public Key Infrastructure]
http://198.241.169.249 [200] [12746] [Visa - Public Key Infrastructure]

Other IPs:
http://104.18.157.147 [403] [16]
http://104.18.158.147 [403] [16]
http://3.7.198.7 [301] [134] [301 Moved Permanently]
http://31.210.5.60 [Failed]

Verbose Output Example

Processing: aiaqa.visa.com
https://aiaqa.visa.com [200] [12746] [Visa - Public Key Infrastructure]
Shodan favicon hash: 26794c373adad855c3fc9705d9a65d40
Hunter favicon hash: 26794c373adad855c3fc9705d9a65d40
Page title: Visa - Public Key Infrastructure

Searching Shodan favicon: https://api.shodan.io/shodan/host/search?key=YOUR_APIKEY&query=http.favicon.hash:"26794c373adad855c3fc9705d9a65d40"
Shodan favicon search found 2 IPs
Searching Shodan title: https://api.shodan.io/shodan/host/search?key=YOUR_APIKEY&query=http.title:"Visa - Public Key Infrastructure"
Shodan title search found 4 IPs
Searching Shodan SSL: https://api.shodan.io/shodan/host/search?key=YOUR_APIKEY&query=ssl:"aiaqa.visa.com"
Shodan SSL search found 32 IPs
Shodan total unique IPs: 17

For Browser - Hunter favicon: favicon_hash=="26794c373adad855c3fc9705d9a65d40"
Searching Hunter favicon: https://api.hunter.how/search?api-key=YOUR_APIKEY&query=ZmF2aWNvbl9oYXNoPT0iMjY3OTRjMzczYWRhZDg1NWMzZmM5NzA1ZDlhNjVkNDAi...
Hunter favicon search found 10 IPs
Hunter total unique IPs: 4

Total unique IPs: 21

Origin IPs Found:
http://198.241.171.81 [200] [12746] [Visa - Public Key Infrastructure]
http://198.241.169.249 [200] [12746] [Visa - Public Key Infrastructure]

Other IPs:
http://104.18.157.147 [403] [16]
...