# Motore Vitale

> Motore di ricerca a cursori (prototipo). Naviga l'intero spazio dei risultati, dal primo all'ultimo, su fonti aperte e gratuite. Nessuna registrazione, nessuna chiave, nessun pagamento alle fonti.

## Per gli agenti
- Ricerca in una chiamata: GET /api/v1/search?q=PROMPT
- Cursori (da -1 a 1): time (recente↔consolidato), size (grande fonte↔voce piccola), comm (commerciale↔indipendente), geo (vicino↔ovunque, con place=LUOGO), depth (sintesi↔approfondimento), trust (verificato↔qualsiasi)
- Posizione: pos=1 … total_estimated, oppure pos=first|mid|last
- Lenti pronte: GET /api/v1/lenses — uso: lens=voci-piccole
- Descrizione completa: /api/v1/openapi.json — pagina leggibile: /api.html
- Ogni risultato dichiara fonte, data, verifica (alta/media/bassa con motivi) e se la posizione è esatta o stimata.

## Esempi
- /api/v1/search?q=dieta%20mediterranea&trust=-0.9&depth=0.6&n=5
- /api/v1/search?q=granita%20siciliana&pos=last
- /api/v1/search?q=produttori%20pistacchio&place=Bronte%20Sicilia&geo=-0.9&size=0.8