Skip to main content

Query CVE details using Shodan's public CVE database API.

Project description

CVEQuery

cvequery

Python Version License Version

Powerfull CVE research tool for security researchers and bug bounty hunters. Query Shodan's CVE database with advanced filtering and export capabilities.

Quick Start

# Install
pipx install cvequery

# Single CVE lookup
cvequery -c CVE-2021-44228

# Product vulnerability search
cvequery --product-cve nginx --severity critical

# KEV (Known Exploited Vulnerabilities) only
cvequery --is-kev --limit-cves 10

Core Commands

CVE Lookup

# Single CVE
cvequery -c CVE-2021-44228

# Multiple CVEs (parallel processing)
cvequery -mc "CVE-2021-44228,CVE-2023-44487"

# Detailed view (no truncation)
cvequery -c CVE-2021-44228 -d

Product Research

# Find vulnerabilities in specific products
cvequery --product-cve nginx
cvequery --product-cve "windows_10" -lcv 10

# Filter by severity
cvequery --product-cve django --severity critical,high

Advanced Filtering

# KEV vulnerabilities only
cvequery --is-kev --limit-cves 20

# Date range filtering
cvequery --product-cve log4j --start-date 2021-01-01 --end-date 2021-12-31

# Sort by exploitation probability
cvequery --product-cve nginx --sort-by-epss

Output Formats

Display Options

# Compact format (one line per CVE)
cvequery --product-cve apache --format compact

# Summary format (statistical analysis)
cvequery --product-cve apache --format summary

# Custom fields only
cvequery -c CVE-2021-44228 --fields cve_id,cvss,epss,kev

# Exclude specific fields
cvequery -c CVE-2021-44228 --fields-exclude summary,references

Export Formats

# JSON for automation
cvequery --product-cve nginx --json results.json

# CSV for analysis
cvequery --is-kev --csv kev_report.csv

# STIX for threat intelligence
cvequery -c CVE-2021-44228 --stix intel.json

Installation

# Recommended
pipx install cvequery

# Alternative
pip install cvequery

Key Features

  • KEV Integration - Focus on actively exploited vulnerabilities
  • EPSS Scoring - Exploitation probability assessment
  • Parallel Processing - Fast multiple CVE lookups
  • Rich Filtering - Severity, date range, product-based
  • Export Options - JSON, CSV, YAML, XML, STIX 2.1
  • Field Customization - Show/hide specific data fields

Documentation

Contributing

Take a look at the Contributing Page.

📬 Contact

X

License

MIT License

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

cvequery-1.0.6.post1.tar.gz (64.1 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

cvequery-1.0.6.post1-py3-none-any.whl (44.0 kB view details)

Uploaded Python 3

File details

Details for the file cvequery-1.0.6.post1.tar.gz.

File metadata

  • Download URL: cvequery-1.0.6.post1.tar.gz
  • Upload date:
  • Size: 64.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.13.3

File hashes

Hashes for cvequery-1.0.6.post1.tar.gz
Algorithm Hash digest
SHA256 bdea039d3035f0d000195a1f3bdded77c8c194eb0e50c57273011a1b497661ac
MD5 fe9baca1ef05cdcd26b509e15b69a3e7
BLAKE2b-256 435708d18e307aa33ead782fc1292494f739c05d61b3669ae3d1fc5601274999

See more details on using hashes here.

File details

Details for the file cvequery-1.0.6.post1-py3-none-any.whl.

File metadata

  • Download URL: cvequery-1.0.6.post1-py3-none-any.whl
  • Upload date:
  • Size: 44.0 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.13.3

File hashes

Hashes for cvequery-1.0.6.post1-py3-none-any.whl
Algorithm Hash digest
SHA256 2741a0611f4ee81abd15a7a094d84137b6b82bed71d4b6c23260680dd4f3d890
MD5 f320c4c1ee451c57edd60fdddcfa3894
BLAKE2b-256 cec3d6347ae47605322cc7530199c9963575e64526fc59b6c8b4b48fd9011bba

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page