WordPress plugin & theme version fingerprinter with CVE matching — prioritized vulnerability reports for authorized testing. Offline inventory mode, zero dependencies.
# wp-cve-hunter
[](https://github.com/gravion-ux/wp-cve-hunter/actions/workflows/ci.yml)
[](https://codecov.io/gh/gravion-ux/wp-cve-hunter)
[](https://www.python.org/)
[](LICENSE)
[](#installation)
**Find out whether the WordPress plugins and themes you run are affected by known CVEs — before someone else does.**
`wp-cve-hunter` is a small, dependency-free Python CLI that fingerprints the
versions of WordPress plugins/themes installed on a site (or reads them from
an inventory file you supply) and matches them against a bundled dataset of
real, publicly disclosed vulnerabilities. It produces a prioritised report —
Markdown for humans, JSON for pipelines — with severity, affected and fixed
versions, and concrete remediation steps.
It is a **defensive, authorised-testing tool**: read-only fingerprinting, no
exploitation, no credential attacks, no bypasses. See
[Authorised use & ethics](#authorised-use--ethics).
---
## Features
- **Two scan modes**
- **Online fingerprinting** — point it at a WordPress site you own. Versions
are detected from public signals only: plugin `readme.txt` *Stable tag*
headers, theme `style.css` *Version* headers, and `ver=` parameters in
asset URLs on the homepage. Plain GET requests, nothing else.
- **Offline inventory mode** — supply a text or JSON file listing
slugs + versions and get a full report with **zero network calls**. Ideal
for fleets, restricted environments, and CI.
- **Curated local CVE dataset** — 12 real, high-impact WordPress plugin
vulnerabilities (SQL injection, authentication bypass, privilege
escalation,