Metadata-Version: 2.4
Name: cvequery
Version: 1.0.7
Summary: CVE research CLI — query Shodan's CVE database with advanced filtering and export.
Home-page: https://github.com/n3th4ck3rx/cvequery
Author: Neo
Author-email: Neo <neo.nzso@proton.me>
License: MIT
Project-URL: Homepage, https://github.com/n3th4ck3rx/cvequery
Project-URL: Repository, https://github.com/n3th4ck3rx/cvequery
Project-URL: Bug Tracker, https://github.com/n3th4ck3rx/cvequery/issues
Project-URL: Documentation, https://github.com/n3th4ck3rx/cvequery/blob/main/docs/README.md
Keywords: cve,security,vulnerability,exploit,cybersecurity,osint
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Information Technology
Classifier: Intended Audience :: System Administrators
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Security
Classifier: Topic :: Utilities
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: requests>=2.25.0
Requires-Dist: click>=8.0.0
Requires-Dist: colorama>=0.4.4
Requires-Dist: rich>=13.0.0
Requires-Dist: urllib3>=1.26.0
Requires-Dist: certifi
Requires-Dist: typing-extensions>=3.7.4; python_version < "3.11"
Requires-Dist: tomli>=2.0.0; python_version < "3.11"
Provides-Extra: formats
Requires-Dist: PyYAML>=6.0.0; extra == "formats"
Requires-Dist: stix2>=3.0.0; extra == "formats"
Provides-Extra: dev
Requires-Dist: pytest>=7.0.0; extra == "dev"
Requires-Dist: pytest-cov>=4.0.0; extra == "dev"
Requires-Dist: PyYAML>=6.0.0; extra == "dev"
Requires-Dist: stix2>=3.0.0; extra == "dev"
Provides-Extra: all
Requires-Dist: PyYAML>=6.0.0; extra == "all"
Requires-Dist: stix2>=3.0.0; extra == "all"
Requires-Dist: pytest>=7.0.0; extra == "all"
Requires-Dist: pytest-cov>=4.0.0; extra == "all"
Dynamic: author
Dynamic: home-page
Dynamic: license-file
Dynamic: requires-python

# CVEQuery
![cvequery](https://raw.githubusercontent.com/n3th4ck3rx/cvequery/main/static/cvequery.png)

[![Python Version](https://img.shields.io/badge/python-3.8%2B-blue.svg)](https://www.python.org/downloads/)
[![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
[![Version](https://img.shields.io/badge/version-1.0.7-orange.svg)](https://pypi.org/project/cvequery/)

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

## Quick Start

```bash
# 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
```bash
# 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
```bash
# Find vulnerabilities in specific products
cvequery --product-cve nginx
cvequery --product-cve "windows_10" -lcv 10

## Find Find vulnerabilities in windows builds
cvequery --product-cve "windows_11_25h2" -s high

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

### Advanced Filtering
```bash
# 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
```bash
# 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
```bash
# 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

```bash
# 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

- [Installation Guide](https://github.com/n3th4ck3rx/cvequery/blob/main/docs/installation.md)
- [Usage Guide](https://github.com/n3th4ck3rx/cvequery/blob/main/docs/usage.md)

## **Contributing**

 Take a look at the [Contributing](https://github.com/n3th4ck3rx/cvequery/blob/main/CONTRIBUTING.md) Page.

## 📬 Contact

[![X](https://img.shields.io/badge/X-%23000000.svg?style=for-the-badge&logo=X&logoColor=white)](https://x.com/n3th4ck3rx) 

## License

[MIT License](https://github.com/n3th4ck3rx/cvequery/blob/main/LICENSE)
