How pirxthepilot/wtfis works
wtfis is a command-line OSINT lookup tool for domains, hostnames, and IP addresses. The main flow parses configuration, selects an entity handler, fetches VirusTotal and optional provider enrichments, then formats the collected results as terminal panels. IP and domain lookups have distinct handler stages; provider-specific clients and normalized response models support enrichment, while the UI presents the results. The README documents the provider capabilities. Some handler and client implementations were not excerpted, so those documented relationships use README evidence rather than assumed call chains.
Main entry points: main.py CLI workflow · ui/base.py Panel rendering · handlers/base.py Shared handler · config.py Configuration
Components 26
Lookup flow
- CLI workflow
wtfis/main.py - Configuration
wtfis/config.py - Shared handler
wtfis/handlers/base.py - Domain lookup
wtfis/handlers/domain.py - IP lookup
wtfis/handlers/ip.py
Enrichment providers
- VirusTotal client
wtfis/clients/virustotal.py - AbuseIPDB client
wtfis/clients/abuseipdb.py - GreyNoise client
wtfis/clients/greynoise.py - IP2Location client
wtfis/clients/ip2location.py - IP2Whois client
wtfis/clients/ip2whois.py - IPinfo client
wtfis/clients/ipinfo.py - IPWhois client
wtfis/clients/ipwhois.py - Shodan client
wtfis/clients/shodan.py - URLhaus client
wtfis/clients/urlhaus.py
Data models
- VirusTotal models
wtfis/models/virustotal.py - IPWhois model
wtfis/models/ipwhois.py - AbuseIPDB model
wtfis/models/abuseipdb.py - GreyNoise model
wtfis/models/greynoise.py - Shodan model
wtfis/models/shodan.py - URLhaus model
wtfis/models/urlhaus.py - Shared models
wtfis/models/base.py
Terminal output
- Panel rendering
wtfis/ui/base.py - Lookup views
wtfis/ui/view.py - Progress display
wtfis/ui/progress.py
Other components
- User
- OSINT services
Connections 37
- User → CLI workflow: submits lookup
- CLI workflow → Configuration: loads options
wtfis/main.py - CLI workflow → Domain lookup: selects domain
wtfis/main.py - CLI workflow → IP lookup: selects IP
wtfis/main.py - CLI workflow → Shared handler: fetches data
wtfis/main.py - CLI workflow → Progress display: shows progress
wtfis/main.py - CLI workflow → Lookup views: creates view
wtfis/main.py - CLI workflow → Panel rendering: prints results
wtfis/main.py - Domain lookup → Shared handler: inherits behavior
wtfis/handlers/domain.py - IP lookup → Shared handler: inherits behavior
wtfis/handlers/ip.py - Configuration → IP2Location client: selects provider
wtfis/config.py - Configuration → IPinfo client: selects provider
wtfis/config.py - Configuration → IPWhois client: selects provider
wtfis/config.py - Configuration → IP2Whois client: selects WHOIS
wtfis/config.py - Shared handler → AbuseIPDB client: requests enrichment
wtfis/handlers/base.py - Shared handler → GreyNoise client: requests enrichment
wtfis/handlers/base.py - Shared handler → Shodan client: requests enrichment
wtfis/handlers/base.py - Shared handler → URLhaus client: requests enrichment
wtfis/handlers/base.py - Shared handler → VirusTotal client: uses primary source
wtfis/handlers/base.py - VirusTotal client → VirusTotal models: validates responses
wtfis/clients/virustotal.py - VirusTotal client → OSINT services: queries VirusTotal
- AbuseIPDB client → OSINT services: queries AbuseIPDB
- GreyNoise client → OSINT services: queries GreyNoise
- IP2Location client → OSINT services: queries IP2Location
- IP2Whois client → OSINT services: queries IP2Whois
- IPinfo client → OSINT services: queries IPinfo
- IPWhois client → OSINT services: queries IPWhois
- Shodan client → OSINT services: queries Shodan
- URLhaus client → OSINT services: queries URLhaus
- Panel rendering → VirusTotal models: renders analysis
wtfis/ui/base.py - Panel rendering → AbuseIPDB model: renders reports
wtfis/ui/base.py - Panel rendering → GreyNoise model: renders classification
wtfis/ui/base.py - Panel rendering → Shodan model: renders host data
wtfis/ui/base.py - Panel rendering → URLhaus model: renders URL data
wtfis/ui/base.py - Panel rendering → Shared models: renders normalized data
wtfis/ui/base.py - Lookup views → Panel rendering: builds panels
wtfis/ui/view.py - IPWhois model → Shared models: extends shared fields
wtfis/models/ipwhois.py