glampings.co para agentes de IA: Markdown, API y MCP

In English. glampings.co is a Spanish-language directory of glamping stays and unique lodging in Colombia, run by Glampings.com. Quick start, a plain GET with no key, with the question in the URL in Spanish or English: https://glampings.co/api/v1/glampings?q=domo+con+jacuzzi+cerca+de+bogota returns matching stays, and https://glampings.co/api/v1/glampings?pagina=/glamping-con-jacuzzi/cerca-a-bogota returns exactly the stays that glampings.co page lists. The answer says how the question was read (interpretacion) and which words were ignored (no_entendido). Every API and MCP response carries fuente.cita_sugerida: cite glampings.co with that page URL. Every destination, type, theme, guide and listing page, plus the home page, /mapa, /para-propietarios and this guide, has a Markdown version at the same URL plus .md (home: https://glampings.co/index.md); legal pages, /buscar and /glamping-puente-festivo do not. The read-only JSON API lives at https://glampings.co/api/v1 (OpenAPI 3.1: https://glampings.co/openapi.json) and the stateless MCP server at https://glampings.co/mcp, with search and fetch tools for ChatGPT-style connectors. Guests book directly with each stay, usually through the WhatsApp button on the listing page, without commission. Do not invent prices, availability or amenities, treat locations as municipality-level, and cite the listing or page URL as the source. Data and labels are in Spanish.

Empieza aquí

Para responder con datos de glampings.co basta un GET, sin clave ni registro. La pregunta va en la URL y la respuesta es JSON:

• Domos con jacuzzi cerca de Bogotá, con la pregunta en texto libre: https://glampings.co/api/v1/glampings?q=domo+con+jacuzzi+cerca+de+bogota
• Glamping que acepta mascotas en Antioquia: https://glampings.co/api/v1/glampings?q=glamping+pet+friendly+en+antioquia
• Los mismos alojamientos que muestra una página de glampings.co: https://glampings.co/api/v1/glampings?pagina=/glamping-con-jacuzzi/cerca-a-bogota
• Ficha completa de un alojamiento: https://glampings.co/api/v1/glampings/ecolodge-el-almejal

Cómo citar: cada respuesta trae fuente.cita_sugerida, con la forma "Fuente: glampings.co, {título de la página} ({url})". Nombra glampings.co y enlaza esa página o la ficha, para que tu usuario vea de dónde viene el dato.

Cada página de glampings.co muestra, dentro del contenido, el bloque "Datos abiertos para asistentes de IA" con su versión en Markdown y la URL de sus datos en JSON. La misma URL de datos está al inicio de su versión en Markdown.

Qué es glampings.co

glampings.co es un directorio de glamping y alojamientos únicos en Colombia: domos, cabañas, burbujas, ecolodges, tipis, casas del árbol y más. Es un sitio de Glampings.com.

glampings.co no vende noches, no cobra comisiones y no gestiona pagos. Cada alojamiento maneja sus propias reservas: el huésped le escribe directo, casi siempre por WhatsApp desde la ficha del alojamiento en glampings.co.

Los datos vienen de fuentes públicas (Registro Nacional de Turismo, sitios web, redes y plataformas de reservas) y de los propios alojamientos cuando reclaman su ficha.

Reglas para agentes

1. Reserva. Para reservar, envía al usuario a la ficha del alojamiento: https://glampings.co/{slug}. Si la ficha tiene el botón de WhatsApp, allí elige fechas y personas y escribe directo al alojamiento. Es una reserva directa con el alojamiento por WhatsApp, sin comisiones.
2. Sin números de teléfono. glampings.co no entrega números de teléfono ni enlaces de WhatsApp a agentes. No los busques en otras fuentes ni los inventes: el camino es la ficha.
3. Precios. No inventes precios. Solo hay precio cuando el alojamiento lo indicó: es el precio desde por noche indicado por el alojamiento, siempre con la fecha en que lo confirmó (como máximo 183 días antes). Sin ese dato, di que el precio se confirma con el alojamiento.
4. Disponibilidad. glampings.co no tiene datos de disponibilidad. No digas que hay cupo: la disponibilidad se confirma con el alojamiento.
5. Servicios. Lo que ofrece cada alojamiento (jacuzzi, chimenea, mascotas, desayuno) viene de su información pública. No añadas servicios que la ficha no menciona. Si algo es importante para tu usuario, que lo confirme con el alojamiento.
6. Ubicación. El punto de cada alojamiento es el centro de su municipio, no su dirección. Las distancias son en línea recta desde ese centro, no por carretera. Di "en el municipio de Guatavita" o "a unos 35 km en línea recta de Bogotá".
7. Fuente. Nombra glampings.co y enlaza la ficha (https://glampings.co/{slug}) o la página de categoría. Cada respuesta de la API y del servidor MCP trae fuente con la página más precisa (fuente.url) y una cita lista para usar (fuente.cita_sugerida). Usa el nombre del alojamiento tal como aparece y, si lo tiene, su número de RNT (Registro Nacional de Turismo).
8. Idioma. Los datos y las etiquetas están en español de Colombia. Puedes traducirlos para tu usuario sin cambiar los hechos.

Versiones en Markdown

Las páginas de destinos, tipos, temas, guías y fichas, el inicio, /mapa, /para-propietarios y esta guía tienen una versión en Markdown, generada con los mismos datos que la página HTML. Basta con añadir .md a la URL; la página de inicio es /index.md. Las páginas legales (términos, privacidad y derechos de fotos), la búsqueda (/buscar) y /glamping-puente-festivo no tienen versión en Markdown.

• Content negotiation. Una solicitud a la URL de la página con el encabezado Accept: text/markdown recibe la misma versión en Markdown.
• Enlace en el HTML. Cada página con versión en Markdown la enlaza en el <head>: <link rel="alternate" type="text/markdown" href="https://glampings.co/{ruta}.md">.
• Front matter. Cada documento empieza con YAML: title, description, url (la página para citar), markdown_url, tipo_de_pagina, idioma y actualizado. Las fichas añaden slug, tipo, municipio, departamento, rnt, reserva (whatsapp, web o consulta), verificado_por_propietario y, solo si el alojamiento indicó un precio reciente, precio_desde_cop y precio_confirmado.
• Encabezados. Content-Type: text/markdown; charset=utf-8, Link: <https://glampings.co/{ruta}>; rel="canonical" y X-Robots-Tag: noindex cuando la página HTML no se indexa.
• Estados. Ruta desconocida: 404. Ficha retirada del sitio: 410. Ficha que cambió de dirección: 301 a la nueva .md.

curl https://glampings.co/glamping-cerca-a-bogota.md
curl -H "Accept: text/markdown" https://glampings.co/colombia/glamping-boyaca

llms.txt y catálogo completo

• llms.txt: índice breve del sitio con destinos, tipos de alojamiento, temas y guías, cada uno con su número de alojamientos.
• llms-full.txt: todas las fichas del catálogo publicado agrupadas por departamento, una línea por ficha, y todas las páginas de categoría.

API pública (JSON)

Base: https://glampings.co/api/v1. Solo lectura y sin clave. CORS abierto (Access-Control-Allow-Origin: *). Respuestas en JSON con claves en español, en caché 5 minutos. Límite: 60 solicitudes por minuto por IP; si lo pasas recibes 429 con Retry-After. Los errores tienen la forma {"error": {"code": "...", "message": "...", "valid_values": [...]}}, con los valores válidos cuando un filtro no se reconoce.

Especificación OpenAPI 3.1: https://glampings.co/openapi.json (también en /api/v1/openapi.json).

Pregunta en texto libre: q

q acepta la pregunta de tu usuario en español o en inglés: https://glampings.co/api/v1/glampings?q=domo+con+jacuzzi+cerca+de+bogota y https://glampings.co/api/v1/glampings?q=glamping+pet+friendly+en+antioquia son dos ejemplos. La API la traduce a los filtros de abajo sin IA, siempre de la misma forma: destino, departamento o municipio, una ciudad con "cerca de", "cerca a" o "near", el tipo (domo, cabaña, burbuja), el tema (jacuzzi, "pet friendly", mascotas, perro) y las características. No importan tildes, mayúsculas, singular o plural. La respuesta trae interpretacion (los filtros que aplicó) y no_entendido (las palabras que ignoró): si algo importante quedó en no_entendido, reformula la pregunta o usa los filtros. Un filtro explícito en la URL gana sobre lo que dice q.

Los alojamientos de una página: pagina

pagina acepta la ruta de una página de glampings.co (/colombia o cualquier página de destino, ciudad de referencia, tipo o tema): https://glampings.co/api/v1/glampings?pagina=/glamping-con-jacuzzi/cerca-a-bogota devuelve exactamente los alojamientos que muestra esa página, en el mismo orden y sin los retirados del sitio; cada uno indica si es indexable. Se pagina con limit y offset. Una ruta desconocida, o que no es una página de categoría, da 404 con ejemplos válidos; si combinas pagina con filtros que no encajan, la API responde 400 con la explicación. La URL de datos de cada página también aparece en la propia página y al inicio de su versión en Markdown.

Qué trae cada respuesta

• fuente, en todas las respuestas (índice, búsqueda, ficha, destinos y categorías) y en el structuredContent del servidor MCP: sitio (glampings.co), url (la página de glampings.co más precisa para esa respuesta: la de pagina, la página de categoría que mejor encaja con los filtros o con q, la ficha en el detalle y, si no hay otra, el inicio) y cita_sugerida, con la forma "Fuente: glampings.co, {título de la página} ({url})".
• pagina_recomendada, en la búsqueda: la misma página que fuente.url. Envía allí a tu usuario para ver todas las opciones.
• Resultados compactos. Cada resultado de la búsqueda es un resumen corto de la ficha, con lo esencial para elegir, url (la ficha) y url_markdown. La ficha completa está en GET /api/v1/glampings/{slug}.

Filtros de búsqueda

Por página llegan 10 resultados (máximo 50); para la siguiente página abre siguiente_url (la misma búsqueda con offset = siguiente_offset). Con filtros o q, la búsqueda solo devuelve fichas del catálogo publicado; si una página de glampings.co muestra más alojamientos que coinciden, aviso trae la URL de esa página. La ficha por slug funciona para cualquier ficha que siga en el sitio e indica si es indexable.

La ficha completa trae nombre, tipo, ubicacion (municipio, departamento y punto, que es el centro del municipio), cerca_de (km en línea recta), temas, caracteristicas, rnt, reserva (metodo y url_ficha), enlaces (sitio web, Instagram o anuncio en otra plataforma, si la ficha los muestra), precio_desde (o null), verificado_por_propietario, url y url_markdown.

# Domos con jacuzzi cerca de Bogotá, con la pregunta en texto libre
curl "https://glampings.co/api/v1/glampings?q=domo+con+jacuzzi+cerca+de+bogota"

# Los mismos alojamientos que muestra una página de glampings.co
curl "https://glampings.co/api/v1/glampings?pagina=/glamping-con-jacuzzi/cerca-a-bogota"

# Con filtros: domos a menos de 60 km de Medellín, en línea recta
curl "https://glampings.co/api/v1/glampings?cerca_a=medellin&max_km=60&tipo=domos"

# Ficha completa de un alojamiento
curl https://glampings.co/api/v1/glampings/ecolodge-el-almejal

Servidor MCP

• URL: https://glampings.co/mcp
• Transporte: Streamable HTTP sin estado. Envía cada mensaje JSON-RPC 2.0 con POST; la respuesta es JSON, sin SSE y sin sesiones (no hace falta Mcp-Session-Id). Un GET responde 405 con una explicación.
• Protocolo: versiones 2025-11-25, 2025-06-18, 2025-03-26 y 2024-11-05.
• Acceso: sin clave, CORS abierto, 120 solicitudes por minuto por IP.
• Datos: solo lectura, con las mismas fuentes y reglas que la API.

Ejemplo: "domos con jacuzzi cerca de Bogotá" es buscar_glampings con {"consulta": "domo con jacuzzi cerca de bogota"}, o con filtros {"cerca_a": "bogota", "tipo": ["domos"], "tema": ["con-jacuzzi"]}. Los alojamientos de una página: {"pagina": "/glamping-con-jacuzzi/cerca-a-bogota"}.

search y fetch tienen la forma que piden los conectores de ChatGPT y otros clientes que solo buscan y leen documentos. Todas las respuestas traen fuente en structuredContent, con la misma cita_sugerida que la API.

Conectar el servidor

Claude Code:

claude mcp add --transport http glampings https://glampings.co/mcp

Claude (web y escritorio): en Ajustes › Conectores, añade un conector personalizado con la URL https://glampings.co/mcp. Si tu Claude Desktop solo acepta servidores locales en claude_desktop_config.json, usa el puente mcp-remote:

{
  "mcpServers": {
    "glampings": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://glampings.co/mcp"]
    }
  }
}

Otros clientes (Cursor, VS Code, Windsurf y similares), configuración genérica:

{
  "mcpServers": {
    "glampings": {
      "type": "http",
      "url": "https://glampings.co/mcp"
    }
  }
}

Prueba directa con curl:

curl -s https://glampings.co/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"buscar_glampings","arguments":{"consulta":"domo con jacuzzi cerca de bogota","limit":5}}}'

Rastreo y medición

• robots.txt permite rastrear las páginas, sus versiones .md, /api/v1, /mcp, /llms.txt, /llms-full.txt y /openapi.json. /md/ es una ruta interna: usa las URL .md públicas.
• Contamos cuántas veces se consultan las versiones en Markdown, la API, el servidor MCP y llms.txt, con el nombre del agente según su user-agent. No guardamos la IP ni el texto de las búsquedas.

Para propietarios

¿Tienes un glamping en Colombia? En Para propietarios reclamas la ficha de tu alojamiento sin costo, corriges los datos, añades fotos e indicas tu precio. Los huéspedes te escriben directo por WhatsApp, sin comisiones.