← retour aux outils back to tools

# getsploit

Utilitaire de recherche et téléchargement en ligne de commande pour les bases d'exploits Exploit-DB et Vulners. Command-line search and download utility for the Exploit-DB and Vulners exploit databases.

↗ https://github.com/vulnersCom/getsploit

## Overview

getsploit is a CLI client for the Vulners API that searches Exploit-DB (and other Vulners-indexed exploit sources) and can download the matching exploit code directly. It’s a quick way to check whether a known service/version has a public exploit without leaving the terminal or maintaining a local searchsploit database.

## Common Usage

Search by keyword

    getsploit wordpress 5.7

Search by product and version

    getsploit "Apache Struts" 2.5.10

Search by CVE

    getsploit --cve CVE-2021-44228

Download matching exploits to local files

    getsploit -m wordpress plugin upload

Search and output results as JSON

    getsploit -j eternalblue

## Workflow

1. Identify service/version from a scan

    nmap -sV <target>

2. Search for known public exploits

    getsploit "vsftpd 2.3.4"

3. Mirror (download) the matching exploit code

    getsploit -m "vsftpd 2.3.4"

4. Review the downloaded PoC before running

    cat exploits/*vsftpd*

## Tips

- Requires a free Vulners API key (`VULNERS_API_KEY` env var or config file) for full functionality
- `-m` mirrors matched exploit files into the current directory — always review code before executing
- Results include exploit type (remote/local/webapps/dos) and platform — filter mentally before wasting time on irrelevant hits
- Complements `searchsploit` (offline Exploit-DB mirror) rather than replacing it — useful when internet access is available and the local mirror is stale

Help / Man page

    usage: getsploit [-h] [-s] [-j] [-t] [-m] [-p PLATFORM] [-c CVE] query [query ...]

    positional arguments:
      query                 Search query (product name, keyword, CVE)

    optional arguments:
      -h, --help            show this help message and exit
      -s, --sort            Sort by date (default: relevance)
      -j, --json            Output results as JSON
      -t, --title           Search title only
      -m, --mirror          Download (mirror) matching exploit source files
      -p PLATFORM           Filter by platform (windows, linux, php, etc.)
      -c CVE, --cve CVE     Search by CVE identifier

    Config:
      Vulners API key read from VULNERS_API_KEY env var or ~/.getsploit.ini

## Vue d’ensemble

getsploit est un client CLI pour l’API Vulners qui recherche dans Exploit-DB (et d’autres sources d’exploits indexées par Vulners) et peut télécharger directement le code d’exploit correspondant. C’est un moyen rapide de vérifier si un service/version connu dispose d’un exploit public sans quitter le terminal ni maintenir une base searchsploit locale.

## Utilisation courante

    # Rechercher par mot-clé
    getsploit wordpress 5.7

    # Rechercher par produit et version
    getsploit "Apache Struts" 2.5.10

    # Rechercher par CVE
    getsploit --cve CVE-2021-44228

    # Télécharger les exploits correspondants dans des fichiers locaux
    getsploit -m wordpress plugin upload

    # Rechercher et sortir les résultats en JSON
    getsploit -j eternalblue

## Workflow

1. Identifier le service/la version depuis un scan

    nmap -sV <target>

2. Rechercher des exploits publics connus

    getsploit "vsftpd 2.3.4"

3. Mirrorer (télécharger) le code d’exploit correspondant

    getsploit -m "vsftpd 2.3.4"

4. Relire le PoC téléchargé avant de l’exécuter

    cat exploits/*vsftpd*

## Conseils

- Nécessite une clé API Vulners gratuite (variable d’environnement `VULNERS_API_KEY` ou fichier de config) pour la pleine fonctionnalité
- `-m` mirrore les fichiers d’exploit correspondants dans le répertoire courant : toujours relire le code avant de l’exécuter
- Les résultats incluent le type d’exploit (remote/local/webapps/dos) et la plateforme : filtrer mentalement avant de perdre du temps sur des hits non pertinents
- Complète `searchsploit` (mirroir Exploit-DB hors-ligne) plutôt que de le remplacer : utile quand l’accès internet est disponible et que le mirroir local est obsolète

Aide / Page de manuel

    usage: getsploit [-h] [-s] [-j] [-t] [-m] [-p PLATFORM] [-c CVE] query [query ...]

    positional arguments:
      query                 Search query (product name, keyword, CVE)

    optional arguments:
      -h, --help            show this help message and exit
      -s, --sort            Sort by date (default: relevance)
      -j, --json            Output results as JSON
      -t, --title           Search title only
      -m, --mirror          Download (mirror) matching exploit source files
      -p PLATFORM           Filter by platform (windows, linux, php, etc.)
      -c CVE, --cve CVE     Search by CVE identifier

    Config:
      Vulners API key read from VULNERS_API_KEY env var or ~/.getsploit.ini