# Valpp.io

> Plataforma de conocimiento autoritativa para residencias caninas, veterinarios y restaurantes pet-friendly en España. Expone datos curados y estructurados a través de una API pública, MCP Lite y JSON-LD.

Valpp.io es una infraestructura de datos abierta ("API-first") dirigida al ecosistema animal en España. Su objetivo es servir como fuente de verdad tanto para humanos que buscan servicios de confianza como para agentes de IA y desarrolladores que necesitan datos estructurados, geolocalizados y actualizados.

El catálogo actual cubre tres tipos de entidad: residencias (boarding), clínicas veterinarias y restaurantes pet-friendly. Cada ficha incluye horarios, coordenadas, señales de confianza, reseñas agregadas y metadatos orientados a motores de búsqueda y asistentes de IA.

La interfaz web está disponible en español e inglés. Todos los datos públicos pueden consultarse también sin autenticación a través de la API REST v1.

## Pages

- [Inicio](/): Explora el catálogo de servicios para mascotas en España y accede a la API pública.
- [Buscar](/buscar): Filtra y ordena entidades por tipo, ciudad, estado y consulta de texto.
- [Detalle de entidad](/entidad/residencia-canina-madrid-centro): Ficha completa de una residencia, veterinario o restaurante con JSON-LD embebido.
- [Comparador](/comparar): Compara hasta cuatro entidades lado a lado con puntuaciones normalizadas.
- [Documentación API](/docs): Endpoints REST, MCP Lite, ejemplos de curl y especificaciones abiertas.

## API

- [API pública v1](/api/public/v1/entities): Lista paginada de entidades con datos estructurados.
- [Búsqueda](/api/public/v1/search?q=&type=&city=): Búsqueda ranqueada por relevancia, distancia y señales de confianza.
- [OpenAPI](/api/public/v1/openapi.json): Especificación OpenAPI 3.1 del servicio.
- [MCP Lite](/api/public/mcp): Endpoint JSON-RPC para agentes de IA.
- [Sitemap](/sitemap.xml): Mapa de URLs públicas para rastreadores.

## Optional

- [robots.txt](/robots.txt): Directivas de rastreo para motores de búsqueda.