Skip to main content

Python library for the Vulnebify API. Run scans, inspect hosts/domains, and fetch results with real-time updates and JSON output.

Project description

Vulnebify CLI

⚡️ A fast, portable CLI to scan assets, view results, and integrate the Vulnebify API into your workflows with real-time, structured output.

Run Tests Publish Release

🔹Profile entire country within minutes

🔹Scan 65k ports in 7 seconds

🔹Enumarate subdomains and discovery open ports

asciicast

Vulnebify conducts safe, non-intrusive scans focused strictly on public metadata, following a transparent and ethical approach that respects system boundaries and privacy.

Quick start

Install

pip install vulnebify

Login

vulnebify login

Run a scan

vulnebify run scan 45.33.32.156

View results

via CLI

vulnebify get scan SCAN_ID

via UI

https://vulnebify.com/scan/SCAN_ID

Installation

From PyPI

pip install vulnebify

From Release

Download the latest precompiled binary from the Releases page:

chmod +x vulnebify && ./vulnebify

From Sources

git clone https://github.com/vulnebify/vulnebify-python.git && cd vulnebify-python && python3 -m venv .venv && source .venv/bin/activate && pip install .

Commands

login

Command Description
vulnebify login Login to the Vulnebify API.
vulnebify login --api-key API_KEY API key for authentication. Prefer using the interactive prompt for security. Only use this flag in CI/CD or trusted environments. You can also set the VULNEBIFY_API_KEY environment variable.

✅ The API key will be stored at ~/.vulnebifyrc after successful login.

run scan

Command Description
vulnebify run scan 45.33.32.156 Run scan for a IP scanning scope.
vulnebify run scan 45.33.32.156 --output json Run scan for a IP scanning scope with json output. Default: human.
vulnebify run scan 45.33.32.156 --wait Run scan for a IP scanning scope and block until the scan finishes.
vulnebify run scan 45.33.32.156 --ports TOP1000 Run scan for a IP scanning scope to check TOP1000 ports. Default: TOP100.
vulnebify run scan 45.33.32.156 -p- Run scan for a IP scanning scope to check full-range (65,535) ports. Default: TOP100.
vulnebify run scan vulnebify.com --scanners subdomain Run scan for a domain scanning scope and enumerate subdomains with subdomain scanner.
vulnebify run scan 193.176.180.0/22 -p 554 --scanners rtsp Run scan for a CIDR scanning scope to check a single 554 port with detailed checks for RTSP using rtsp scanner.
vulnebify run scan 45.33.32.156 vulnebify.com 193.176.180.0/22 -p 8000-9000 Run scan for multiple scanning scopes to check 8000-9000 port range.

📥 Piping is supported too:

echo 193.176.180.0/22 | vulnebify run scan -p 80 443 --wait -o json | jq .hosts[]

get scan|host|domain

Command Description
vulnebify get scan s_061a2fb6ade31d8e8sf82b5e36290a51 Get previously executed scan.
vulnebify get host 45.33.32.156 --output json Get previously scanned host with json output. Default: human.

ls scan|scanners

Command Description
vulnebify list scans List previously executed scans.
vulnebify list scanners List available scanners.
vulnebify get domain vulnebify.com Get previously scanned domain

cancel scan

Command Description
vulnebify cancel scan s_061a2fb6ade31d8e8sf82b5e36290a51 Cancels running scan

Learn more


Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

vulnebify-1.0.4.tar.gz (13.7 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

vulnebify-1.0.4-py3-none-any.whl (13.7 kB view details)

Uploaded Python 3

File details

Details for the file vulnebify-1.0.4.tar.gz.

File metadata

  • Download URL: vulnebify-1.0.4.tar.gz
  • Upload date:
  • Size: 13.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.11.13

File hashes

Hashes for vulnebify-1.0.4.tar.gz
Algorithm Hash digest
SHA256 89f24f0faaa404f9c2b2eb3a7c59c0bfd9c6d1b504649782606e87e9a9648937
MD5 f816675f061b05b4d34e0dd1a8d251a0
BLAKE2b-256 e0b2ba7e6c132aa3a04c668b33e5ea6a62ac553cae57da3a36809575562d3d28

See more details on using hashes here.

File details

Details for the file vulnebify-1.0.4-py3-none-any.whl.

File metadata

  • Download URL: vulnebify-1.0.4-py3-none-any.whl
  • Upload date:
  • Size: 13.7 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.11.13

File hashes

Hashes for vulnebify-1.0.4-py3-none-any.whl
Algorithm Hash digest
SHA256 ab97c827ec9a5e8c64ca3b3b31751dbaa02ab6b5aab4edd01ef24c2304efa52a
MD5 2c983296cbf64ba8e349e0cee8415887
BLAKE2b-256 ba7f42fca87da54728e4f1f2e9f09cc836e1c8a6c8034d74ac42ba0955510b01

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page