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.tar.gz (64.0 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-py3-none-any.whl (43.9 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: cvequery-1.0.6.tar.gz
  • Upload date:
  • Size: 64.0 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.tar.gz
Algorithm Hash digest
SHA256 8021a74928bbed6324a39b0081bf213ddd2afa66b1fde236c8cb4c0c365e0452
MD5 ecde301b8936f464e7920cdd485b4c2c
BLAKE2b-256 6a4f3775c47aadc6d43ab90f6d55aa4fb646de462063f987cc6da20cc4bee325

See more details on using hashes here.

File details

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

File metadata

  • Download URL: cvequery-1.0.6-py3-none-any.whl
  • Upload date:
  • Size: 43.9 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-py3-none-any.whl
Algorithm Hash digest
SHA256 b081cc48a01fe9d7b86e29bd6fd6492fddff4255fdaa42bb5e05b0bd688fdfd2
MD5 094b0acaf741a1e51c7818ebd97a605d
BLAKE2b-256 5e1fd2b098513f3dc4a57b14cde016b0ff14439e0f89c37ec1b85c0801c69eeb

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