Metadata-Version: 2.4
Name: nvd-client
Version: 0.1.3.2
Summary: A Python client for interacting with the National Vulnerability Database (NVD) API to fetch CVE data.
Home-page: https://github.com/ahur4/nvd-client
Author: Ahur4
Author-email: ahur4.rahmani@gmail.com
Keywords: vulnerability,nvd,national vulnerability database,nvd_client,nvd_client-api,ahur4,ahura rahmani,redteam,soc,vulnerability assessment,penetration testing
Classifier: Programming Language :: Python :: 3
Requires-Python: >=3.6
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: certifi==2024.6.2
Requires-Dist: charset-normalizer==3.3.2
Requires-Dist: idna==3.7
Requires-Dist: requests[socks]==2.32.3
Requires-Dist: urllib3==2.2.1
Requires-Dist: pytz==2025.2
Dynamic: author
Dynamic: author-email
Dynamic: classifier
Dynamic: description
Dynamic: description-content-type
Dynamic: home-page
Dynamic: keywords
Dynamic: license-file
Dynamic: requires-dist
Dynamic: requires-python
Dynamic: summary


# NVD API Client

![PyPI](https://img.shields.io/pypi/v/nvd-client)
![Daily Downloads](https://img.shields.io/pypi/dd/nvd-client)
![Monthly Downloads](https://img.shields.io/pypi/dm/nvd-client)
[![Telegram-Channel](https://img.shields.io/badge/Telegram--Channel-Ahura_Rahmani-blue)](https://t.me/Ahur4_Rahmani)


A Python client for interacting with the National Vulnerability Database (NVD) API to fetch CVE data.

## Features

- Fetch all CVEs with pagination
- Fetch CVE by its ID
- Fetch CVEs by publication or modification date
- Fetch CVEs by CPE name
- Other features coming soon...

## Installation

You can install the package using pip:

```sh
pip install nvd_client
```

## Usage

```python
from nvd_client import NvdApi
from datetime import datetime, timedelta

# Initialize the API client
api_key = "your_api_key_here"
nvd_api = NvdApi(api_key)

# Fetch all CVEs
cves = nvd_api.get_all_cves(per_page=100, offset=0)
print(cves)

# Fetch a CVE by ID
cve = nvd_api.get_cve_by_id(cve_id="CVE-2024-30078")
print(cve)

# Fetch CVEs by publish or modify date range
cves_by_date = nvd_api.get_cve_by_date(
    per_page=100,
    offset=0,
    publish_start_date=datetime.now() - timedelta(days=2),
    publish_end_date=datetime.now()
)
print(cves_by_date)

# Fetch CVEs by CPE name
cves_by_cpe = nvd_api.get_cve_by_cpe(
    cpe_name="cpe:2.3:o:microsoft:windows_10:1607:*:*:*:*:*:*:*",
    per_page=100,
    offset=0
)
print(cves_by_cpe)
```

## Author

- Author: Ahur4

- Telegram: [@Ahura_rahmani](https://t.me/Ahura_rahmani)

## License

This project is licensed under the MIT License. See the `LICENSE` file for details.


### Explanation:
1. **Features**: Lists the main functionalities provided by the module.
2. **Installation**: Provides instructions for installing the package using pip from PyPI.
3. **Usage**: Gives examples of how to initialize the client and use its methods.
4. **Author**: Provides your name and a link to your Telegram channel.
5. **License**: States that the project is licensed under the MIT License.
