Inicio rápido

Este quickstart asume que ya tienes BCN Extractor instalado. En menos de 5 minutos tendrás tus primeras normas en la base de datos.

Descargar tus primeras normas

Inicializar la base de datos

Carga el esquema e importa las 700+ instituciones incluidas en el repositorio:
Terminal window
```
python bcn_cli.py init
```
Elegir una institución

Busca una institución que te interese:
Terminal window
```
python bcn_cli.py instituciones list --search "ministerio de salud"
```
Anota el id que aparece en el resultado (ej: 17).
Ver qué normas hay disponibles

Antes de descargar, puedes ver qué hay disponible consultando la BCN directamente:
Terminal window
```
python bcn_cli.py normas list 17 --limit 10
```
Sincronizar a la base de datos
Terminal window
```
python bcn_cli.py normas sync 17 --limit 10
```
Esto descarga las primeras 10 normas, las parsea y las almacena en PostgreSQL. Además de la norma, se guarda automáticamente su metadata estructurada (materias, organismos, flags) en una tabla separada.
Buscar en las normas descargadas

Búsqueda full-text por título y contenido:
Terminal window
```
python bcn_cli.py normas search "vacunación"
```
O filtrar por metadata específica:
Terminal window
```
python bcn_cli.py normas by-metadata materia "salud"
```
Explorar la metadata

Ver qué claves de metadata hay disponibles en tu base de datos:
Terminal window
```
python bcn_cli.py metadata claves
```
Ver la metadata completa de una norma específica:
Terminal window
```
python bcn_cli.py normas metadata 206396
```
Ver las estadísticas
Terminal window
```
python bcn_cli.py stats
```

Si prefieres explorar los datos via HTTP, levanta la REST API:

fastapi dev api/main.py

Luego abre http://localhost:8000/docs en tu navegador. Tendrás Swagger UI con todos los endpoints disponibles para explorar interactivamente.