bitsadmin /wesng

Windows Exploit Suggester - Next Generation

★ 4,978⑂ 608👁 91⑃ 28● 58▤ 0
PythonBSD-3-ClauseCreated 2019-03-02
+0
Daily
4,978
stars
608
forks
91
watchers
28
prs
58
issues
0
releases

README

Windows Exploit Suggester - Next Generation (WES-NG)
WES-NG is a tool based on the output of Windows' systeminfo utility which provides the list of vulnerabilities the OS is vulnerable to, including any exploits for these vulnerabilities. Every Windows OS between Windows XP and Windows 11, including their Windows Server counterparts, is supported.

At the BITSADMIN blog an in-depth article on WES-NG is available: Windows Security Updates for Hackers.

 Usage
1. Download WES-NG using pip install wesng or using the following commandline: git clone https://github.com/bitsadmin/wesng --depth 1
2. Obtain the latest database of vulnerabilities by executing the command wes.py --update
3. There are two options to check for missing patches:
    a. Launch missingkbs.vbs or missingkbs.ps1 on the host to have Windows determine which patches are missing
    b. Use Windows' built-in systeminfo.exe tool to obtain the system information of the local system, or from a remote system using systeminfo /S MyRemoteHost, and redirect this to a file: systeminfo  systeminfo.txt
4. Depending on the method chosen in step 3 execute WES-NG:
    a. With the missing.txt file as input: wes.py --missing missing.txt (or wes.py -m missing.txt)
    b. With the systeminfo.txt file as the parameter: wes.py systeminfo.txt
WES-NG then uses the database to determine which patches are applicable to the system and to which vulnerabilities are currently exposed, including exploits if available.
5. As the data provided by Microsoft's MSRC feed is frequently incomplete and false positives are reported by wes.py, @DominicBreuker contributed the --muc-lookup parameter to validate identified missing patches from the systeminfo.txt file against Microsoft's Update Catalog. Additionally, make sure to check the Eliminating false positives page at the Wiki on how to interpret the results.
For an overview of all available parameters for missingkbs.vbs, missingkbs.ps1 and wes.py, check CMDLINE.md.

 Demo
!Gif animation showing usage of Windows Exploit Suggester - Next Generation

 Collector
This GitHub repository regularly updates the database of vulnerabilities, so running wes.py with the --update parameter gets the latest version.
If manual generation of the .csv file with hotfix information is required, use the scripts from the /collector folder to compile the database. Read the comments at the top of each script and execute them in the order as they are listed below. Executing these scripts will produce definitions.zip.
The WES-NG collector pulls information from various sources:
- Microsoft Security Bulletin Data: KBs for older systems [1]
- MSRC: The Microsoft Security Update API of the Microsoft Security Response Center (MSRC): Standard source of information for modern Microsoft Updates [2]
- NIST National Vulnerability Database (NVD): Complement vulnerabilities with Exploit-DB links [3]
- OffSec Exploit-DB [4]
These are combined into a single .csv file which is com

Top issues

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON