# EPSS Client
A Python client to query the FIRST EPSS API for CVE EPSS scores. This tool allows users to easily fetch EPSS scores for different CVEs right from the command line.
## Installation
Before installing the EPSS Checker, make sure you have Python 3.6+ installed on your system. You can install the EPSS Checker using pip:
```sh
pip install epss-checker
```
## Usage
You can use the EPSS Client from the command line as follows:
```sh
epss-checker CVE-XXXX-XXXX
```
Replace `CVE-XXXX-XXXX` with the actual CVE identifier you want to query. The tool will fetch the EPSS score for the given CVE identifier and display it in the console. The following is the help message of the tool:
```sh
┌──(omar㉿websploit)-[~]
└─$ epss-checker -h
usage: epss-checker [-h] [-s] cve_id
EPSS-Checker
Author: @santosomar
A tool to fetch EPSS scores for CVEs from the FIRST EPSS API.
positional arguments:
cve_id The CVE identifier to query (format: CVE-XXXX-XXXX)
options:
-h, --help show this help message and exit
-s, --silent Only display the EPSS score, without any additional text
```
## Contributing
To contribute to this project, please read the [CONTRIBUTING](CONTRIBUTING.md) file.
## License
This project is licensed under the MIT License. See the LICENSE file for details.
Raw data
{
"_id": null,
"home_page": "https://github.com/santosomar/epss-client",
"name": "epss-checker",
"maintainer": "",
"docs_url": null,
"requires_python": "",
"maintainer_email": "",
"keywords": "",
"author": "Omar Santos",
"author_email": "santosomar@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/4c/cc/3018431d04838659e64888f111d28649e1a82fa630cee4175fb3b6fb0667/epss-checker-1.0.tar.gz",
"platform": null,
"description": "# EPSS Client\n\nA Python client to query the FIRST EPSS API for CVE EPSS scores. This tool allows users to easily fetch EPSS scores for different CVEs right from the command line.\n\n## Installation\n\nBefore installing the EPSS Checker, make sure you have Python 3.6+ installed on your system. You can install the EPSS Checker using pip:\n\n```sh\npip install epss-checker\n```\n\n## Usage\n\nYou can use the EPSS Client from the command line as follows:\n\n```sh\nepss-checker CVE-XXXX-XXXX\n```\n\nReplace `CVE-XXXX-XXXX` with the actual CVE identifier you want to query. The tool will fetch the EPSS score for the given CVE identifier and display it in the console. The following is the help message of the tool:\n\n```sh\n\u250c\u2500\u2500(omar\u327fwebsploit)-[~]\n\u2514\u2500$ epss-checker -h\nusage: epss-checker [-h] [-s] cve_id\n\n EPSS-Checker\n Author: @santosomar\n A tool to fetch EPSS scores for CVEs from the FIRST EPSS API.\n\npositional arguments:\n cve_id The CVE identifier to query (format: CVE-XXXX-XXXX)\n\noptions:\n -h, --help show this help message and exit\n -s, --silent Only display the EPSS score, without any additional text\n```\n\n\n## Contributing\nTo contribute to this project, please read the [CONTRIBUTING](CONTRIBUTING.md) file.\n\n\n\n## License\n\nThis project is licensed under the MIT License. See the LICENSE file for details.\n",
"bugtrack_url": null,
"license": "",
"summary": "A client to query the FIRST EPSS API for CVE EPSS scores",
"version": "1.0",
"project_urls": {
"Homepage": "https://github.com/santosomar/epss-client"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "a59d6bceecc76ff0e771d95466fbaba9e2e542849077eec3d2f170963790b421",
"md5": "8d69f114784d044a666b16b3f103b127",
"sha256": "3711028c5d43fa95c02b276174d9ca18a0c89cdbb7b85e3ac9504cadb12cb5ee"
},
"downloads": -1,
"filename": "epss_checker-1.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "8d69f114784d044a666b16b3f103b127",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 3991,
"upload_time": "2023-09-11T05:23:28",
"upload_time_iso_8601": "2023-09-11T05:23:28.493886Z",
"url": "https://files.pythonhosted.org/packages/a5/9d/6bceecc76ff0e771d95466fbaba9e2e542849077eec3d2f170963790b421/epss_checker-1.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "4ccc3018431d04838659e64888f111d28649e1a82fa630cee4175fb3b6fb0667",
"md5": "6750344158f7190d66aada9b229d7f31",
"sha256": "8e89a1ba5f30c0c01dd65b19571248cf0f46ceb809280ce050fcb866357ec312"
},
"downloads": -1,
"filename": "epss-checker-1.0.tar.gz",
"has_sig": false,
"md5_digest": "6750344158f7190d66aada9b229d7f31",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 4762,
"upload_time": "2023-09-11T05:23:30",
"upload_time_iso_8601": "2023-09-11T05:23:30.135734Z",
"url": "https://files.pythonhosted.org/packages/4c/cc/3018431d04838659e64888f111d28649e1a82fa630cee4175fb3b6fb0667/epss-checker-1.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-09-11 05:23:30",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "santosomar",
"github_project": "epss-client",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "epss-checker"
}