### README.md

````markdown
# BNVD Python Client

Cliente Python para a API do Banco Nacional de Vulnerabilidades Digitais (BNVD).

## Instalação

```bash
pip install bnvd
````

## Uso básico

```python
from bnvd.client import BNVDClient

client = BNVDClient()

# Buscar vulnerabilidades recentes
recentes = client.get_recent(days=5, per_page=10)
for vul in recentes:
    print(f"{vul['cve_id']} - {vul.get('title', 'Sem título')}")

# Buscar vulnerabilidade específica
detalhes = client.get_vulnerability("CVE-2025-12345")
print(detalhes)
```

## Funcionalidades

* Listar vulnerabilidades com filtros (ano, severidade, vendor)
* Buscar vulnerabilidade por CVE ID
* Buscar vulnerabilidades recentes
* Buscar estatísticas do banco de dados

## Contribuição

Contribuições são bem-vindas! Abra uma issue ou pull request no GitHub.

## Licença

Este projeto está licenciado sob a Licença MIT - veja o arquivo LICENSE para detalhes.

