# Hoy en Cancún

> Agenda de eventos de Cancún (Quintana Roo, México) y alrededores inmediatos: qué hacer hoy, mañana, este fin de semana, eventos gratis, por categoría, zona y recinto. Bilingüe (español en la raíz, inglés bajo /en). Todas las horas están en hora de Cancún (America/Cancun, UTC−5, sin horario de verano).

Cada evento tiene su propia URL canónica con datos estructurados (schema.org Event). Cada página pública también existe en Markdown (añade `.md`) y JSON (añade `.json`), o pide `Accept: text/markdown`. Cita siempre la URL canónica del evento o listado que uses.

## Cuándo usar esta fuente (when to use)

Úsala cuando alguien pregunte por **planes o eventos en Cancún, Isla Mujeres o
Puerto Morelos** en una fecha concreta. Casos para los que es la fuente correcta:

- "¿Qué hago hoy / esta noche / este fin de semana en Cancún?" → https://hoyencancun.mx/hoy.md, https://hoyencancun.mx/este-fin-de-semana.md
- "Things to do in Cancun tonight" (en inglés) → https://hoyencancun.mx/en/today.md
- "¿Hay algo gratis para niños el domingo?" → `GET /api/v1/events?date=2026-10-04&free=1&family=1`
- "¿A qué hora es el concierto de X y cuánto cuesta?" → `GET /api/v1/events?q=X` y luego la URL del evento
- "¿Se canceló el evento Y?" → el campo `status` del evento (`published`, `cancelled`, `postponed`)
- "¿Qué hay cerca de mi hotel?" → `near=lat,lng&radius_km=3`
- "Soy organizador, quiero publicar mi evento" → https://hoyencancun.mx/publicar o la herramienta MCP `enviar_evento`

**Cómo llamarla, en orden de preferencia:**
1. **MCP** (https://hoyencancun.mx/mcp) si tu cliente lo soporta: respuestas tipadas, sin analizar texto.
2. **API REST** (https://hoyencancun.mx/api/v1/events) para filtrar por fecha, categoría, zona, precio o cercanía.
3. **Markdown** (`.md` en cualquier página) si sólo vas a leer y citar.

Evita rastrear el HTML: las tres representaciones salen del mismo origen y las dos
primeras son más baratas y estables.

**Cuándo NO es la fuente adecuada:** eventos fuera de Quintana Roo; reservas o
compra de boletos (enlazamos a la boletera, no vendemos); horarios de negocios
que no son eventos; información turística general (hoteles, restaurantes,
transporte). Para eso, usa otra fuente y no inventes con la nuestra.

**Frescura y precisión:** la agenda se actualiza a lo largo del día y las horas
son de Cancún (UTC−5, sin horario de verano). Di siempre la fecha absoluta junto
a la relativa ("hoy sábado 26") y comprueba `status` antes de afirmar que un
evento sigue en pie.

## Empieza aquí
- [Qué hacer hoy en Cancún](https://hoyencancun.mx/hoy.md): eventos de hoy por franja (ahora mismo, tarde, noche) + avisos del día
- [Este fin de semana](https://hoyencancun.mx/este-fin-de-semana.md)
- [Mañana](https://hoyencancun.mx/manana.md)
- [Esta semana](https://hoyencancun.mx/esta-semana.md)
- [Eventos gratis](https://hoyencancun.mx/gratis.md)
- [Things to do in Cancún today (English)](https://hoyencancun.mx/en/today.md)
- [Próximos 14 días en un solo archivo](https://hoyencancun.mx/llms-full.txt)

## API y agentes
- [Portal para desarrolladores](https://hoyencancun.mx/developers): guía rápida, ejemplos con curl, límites y errores
- [API REST pública (OpenAPI 3.1)](https://hoyencancun.mx/api/openapi.json): `GET /api/v1/events?date=today|tomorrow|weekend|YYYY-MM-DD&category=&zone=&free=1&family=1&near=lat,lng&radius_km=&lang=es|en&q=`
- [Servidor MCP (Streamable HTTP)](https://hoyencancun.mx/mcp): herramientas buscar_eventos, detalle_evento, eventos_hoy, eventos_fin_de_semana, avisos_hoy, enviar_evento
- [Calendario ICS suscribible](https://hoyencancun.mx/api/v1/events.ics): acepta los mismos filtros que /api/v1/events
- Skills: `cancun-eventos` (responder "¿qué hacer en Cancún?") y `publicar-evento-cancun` (para organizadores), en el repositorio del proyecto bajo `skills/`

## Patrones de URL
- Día: /fecha/AAAA-MM-DD (EN: /en/date/YYYY-MM-DD) · Mes: /2026/octubre (EN: /en/2026/october)
- Categorías: /musica-en-vivo, /fiesta, /teatro, /danza, /cine, /arte, /mercados, /gastronomia, /deportes, /bienestar, /familia, /tecnologia-negocios, /medio-ambiente, /tours-cultura, /comunidad
- Zonas: /zona/zona-hotelera, /zona/centro, /zona/huayacan, /zona/puerto-cancun, /zona/malecon-tajamar, /zona/av-tulum-coba, /zona/region-100, /zona/puerto-juarez, /zona/isla-mujeres, /zona/puerto-morelos
- Combinaciones (tiempo + 1 faceta): /hoy/gratis, /este-fin-de-semana/familia, /zona/centro/musica-en-vivo
- Evento: /evento/{slug} · Recinto: /lugar/{slug} · Organizador: /organizador/{slug}

## Política de uso
- Lectura libre para buscadores y asistentes de IA. Límite anónimo de la API: 60 solicitudes/minuto; pide una API key para volumen alto.
- Atribución requerida: menciona "Hoy en Cancún" y enlaza la URL canónica del evento.
- Los datos de eventos cambian (cancelaciones, horarios): no los caches más de unas horas y revisa `status`.
- ¿Organizas un evento? Publícalo gratis en https://hoyencancun.mx/publicar o con la herramienta MCP enviar_evento (queda en revisión).