# 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.

- Coordinate Vitali: ogni ricerca è un emisfero. Latitudine 90° = primo risultato, 0° = ultimo (scala logaritmica); longitudine = carattere del sito: 0° recente, 60°E voce piccola, 120°E indipendente, 180° consolidato, 120°W grande fonte, 60°W commerciale. Ogni risultato ha `coordinates` {lat, lon, text}; per andare a un punto: coord=LAT,LON (es. coord=64.2393,60).

## 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
- Sezioni con v=: news, images, videos, maps, books, science (es. /api/v1/search?q=ristoranti%20di%20pesce&place=Catania&v=maps → luoghi con lat/lon)
- Notizie: archivio proprio di Motore Vitale, testate lette direttamente dai loro feed (nessun aggregatore). I cursori ordinano l'intero archivio, non solo la pagina (es. size=1 porta in cima le voci piccole tra tutte le notizie trovate). Stato e testate: /api/v1/news/feeds