vulners 4.0.0

v4.0.0

on Python PyPI

The first release of the modernized v4 SDK — a ground-up rewrite that keeps 100% backward compatibility with the v3 API.

Install

pip install -U vulners

Requires Python 3.10+.

Added

• New sync and async clients, Vulners and AsyncVulners, with resource
  namespaces (search, documents, audit, archive, misc, report, stix,
  subscriptions, subscriptions_email, webhooks, vscanner), importable as
  from vulners import Vulners, AsyncVulners.
• Typed response models (bulletin family hierarchy), SearchPage pagination
  with auto-iteration bounded by the 10 000-document search window, and lazy
  streaming of the gzip/zip-compressed JSON-array archive downloads.
• A structured exception hierarchy (VulnersError → APIError → …) and
  with_raw_response / with_streaming_response accessors.
• audit.smart() — the Smart Audit endpoint (POST /api/v4/audit/smart).
• Subscription and webhook methods accept an optional api_key argument naming
  the owner of the subscription, defaulting to the client's own key so existing
  calls stay byte-identical on the wire.
• HTTP/2 on by default (h2 is a core dependency); a new http2 argument
  lets you force HTTP/1.1 for huge single-stream archive downloads.
• Faster, more modern transport by default, no build step — response
  compression (brotli + zstandard), ISA-L-accelerated gzip (isal),
  multi-member gzip/zip streaming (stream-unzip), all core with prebuilt wheels
  for CPython 3.10–3.14. The http2 / stream-zip extras are removed (now core);
  mcp and otel remain.
• Proxy configuration via the proxy= argument (a URL or httpx.Proxy), plus
  automatic support for the HTTPS_PROXY / HTTP_PROXY / ALL_PROXY environment
  variables (honouring NO_PROXY) when trust_env is set.
• A built-in Model Context Protocol server
  (vulners-mcp, vulners[mcp] extra) exposing search/lookup/audit tools to AI agents.
• License change to MIT for 4.0.0.

Compatibility

• The entire v3 API (VulnersApi, VScannerApi, vulners.base.*,
  vulners.vulners.*, all import paths) is preserved unchanged. Existing code
  keeps working; new code should prefer the v4 clients.

Docs: https://vulnersCom.github.io/api/ · PyPI: https://pypi.org/project/vulners/4.0.0/ · Full changelog: CHANGELOG.md