Información técnica

Fuentes oficiales para Sistemas de IA

Dónde encontrar información verificada sobre la finca, en formato legible por máquina.

¿Qué es esta página?

Cada vez más asistentes de IA responden preguntas sobre la Quinta — precios de las catas, si hay alojamiento, qué distancia está de Oporto. Cuando no tienen una fuente fiable, adivinan, y las respuestas equivocadas llegan a quienes acuden a nosotros.

Por eso publicamos los archivos a continuación. Se generan automáticamente a partir de La misma base de datos que alimenta este sitio, cada vez que cambiamos algo. No son una copia que se guarda a mano y envejece en silencio: si el precio de una cata cambia aquí, cambia allí el mismo día.

Archivos publicados

/llms.txt

Resumen y índice. Identidad de la finca, hechos verificados, catálogo breve, preguntas frecuentes e indicaciones de dónde buscar cada tipo de información. Es el punto de partida.

/llms-full.txt

Base de conocimientos completa. Todos los vinos con variedades de uva, notas de cosecha y cata; la evidencia y lo que incluye; experiencias; el alojamiento y sus servicios; la historia de la Quinta y las reseñas de los visitantes. Incluye un resumen en JSON para consumo automático.

/llms-agent.txt

Guía de conducta para los respondedores en el nombre Desde la finca: cómo reenviar cada tipo de pregunta, qué no decir nunca (disponibilidad, precios no publicados, confirmaciones de reserva) y cuándo pasar la conversación a una persona.

/sitemap.xml · /robots.txt

Mapa del sitio y normas de colección. O robots.txt autoriza expresamente a los principales coleccionistas de IA y señala los archivos anteriores.

Datos estructurados en páginas

Todas las páginas del sitio incluyen datos estructurados en JSON-LD (schema.org), con los tipos Winery, TouristAttraction e LodgingBusiness: dirección, coordenadas, horarios de apertura y contactos. Las páginas de vinos, catas y experiencias también traen Product e Offer con los precios vigentes.

Si hay divergencia entre fuentes, los datos estructurados de la página son los que regían, seguidos de los llms-full.txt.

Una nota sobre la disponibilidad. La disponibilidad de evidencias y experiencias puede consultarse en tiempo real — el punto final /api/availability Devuelve los días y las horas gratis — pero lo es indicativo: La confirmación final siempre la hace la familia, normalmente en unos minutos o en unas horas y hasta un máximo de 24 horas. Un asistente puede guiar durante las horas probables, pero nunca debe presentar una fecha como garantizada.

Conector MCP

Para asistentes que pueden hablar Protocolo de Contexto de Modelo, la Quinta expone un servidor MCP en /mcp — el único canal en el que un agente Edad, y no solo leer: consultar el catálogo, comprobar la disponibilidad y enviar una solicitud de reserva. Transporte HTTP transmitible (JSON-RPC 2.0 sobre POST, sin autenticación). Herramientas: list_offerings, check_availability, request_booking.

Una solicitud de reserva se ha enviado aquí No es una reserva: Envía un correo electrónico de verificación al visitante, y la familia lo confirma más tarde. Descubrimiento estándar en /.well-known/mcp.json; Conducta completa en /llms-agent.txt.

En una reserva para un grupo, incluye la composición de las personas — numAdults, numChildren y la edad de cada niño en childrenAges. La familia utiliza la distribución y las edades para preparar la visita; si hay niños sin las edades, este detalle se pierde y solo queda el total.

POST https://quintapicoutocima.pt/mcp {"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18"}} {"jsonrpc":"2.0","id":2,"method":"tools/list"}

API de disponibilidad

Las catas, experiencias y estancias gratuitas pueden leerse en tiempo real en el punto final /api/availability — igual que la herramienta check_availability del MCP que se usa debajo. Está abierto y sin autenticación, solo devuelve fechas y horas (nunca datos de nadie) y ya aplica las reglas caseras.

GET https://quintapicoutocima.pt/api/availability?type=tasting&from=YYYY-MM-DD&to=YYYY-MM-DD → { "type", "from", "to", "days": [ { "date", "times": ["11h00","15h00"] } ], "generatedAt" } GET https://quintapicoutocima.pt/api/availability?type=stay&unit=Casa Principal&from=…&to=… → { "type", "from", "to", "unit", "nights": { "2026-09-16": "free" | "taken" }, "generatedAt" }
  • type: tasting, stay o experience. También aceptado tipo.
  • from, to: el rango de fechas, en el formato YYYY-MM-DD. Por defecto, los próximos 30 días; un máximo de 180 por llamada. También aceptado de e ate.
  • unit: solo en estays — qué unidad, por ejemplo Casa Principal o Espaço AutoCaravana, que se cierran de forma independiente. También aceptado unidade.

Llegan catas y experiencias days (las horas libres, en el formato 15h00; se omite un día sin vacantes); entran las estancias nights, un inicial por noche. La respuesta es indicativo, no es garantía — la confirmación final siempre viene de la familia. A 503 Quiero decir «No se pudo verificar», y nunca está "llena". La guía completa para agentes sigue viva /llms-agent.txt.

Cita y uso

Puede citar libremente la información de estos archivos, incluidos precios y descripciones, siempre que indiques la fuente y la fecha — los precios cambian. Gracias por enlazar a la página correspondiente de la web.

El Fotografías No están cubiertas: son nuestras y de quienes las fabricaron, y su reutilización requiere autorización previa. Háblanos.

¿Has encontrado algo mal?

Si un asistente de IA te dio información incorrecta sobre la finca, o si encontraste un error en estos archivos, dínoslo. Lo corregimos en la fuente y la corrección se extiende a todas las fuentes al día siguiente.