How kasem545/vulnsearch works
Project type and purpose
• This is an open‑source, command‑line vulnerability enumeration tool written as two shell scripts (vulnsearch.sh and vulnsearch‑cve.sh).
• Purpose: Given a domain or IP, it uses DNS resolution and the Shodan API to discover running services, extract CVE identifiers via JSON parsing (jq), and then fetch proof‑of‑concept references for each CVE.
File structure
• Top level:
• LICENSE – open‑source license
• README.md – usage instructions and project description
• img/ – example screenshots of output
• vulnsearch.sh – primary script that:
a. reads domain from stdin
b. resolves DNS to IP
c. queries Shodan
d. parses JSON for ports, CPEs, CVEs
• vulnsearch‑cve.sh – secondary script that, given a CVE, pulls POC references from multiple online trackers
• No complex directories (no frontend/backend split); it’s a linear CLI pipeline.
• Configuration: requires jq and an environment variable (Shodan API key, implied).
README for additional insights
• Dependencies: jq (JSON parser), Shodan API
• Usage examples show data flow: domain → script → shodan/search → JSON output → CVE list → PoC URLs
• Screenshots (img/*.png) demonstrate two modes: all‑in‑one scan and CVE‑to‑POC lookup.