Desarrolladores y agentes

Todos los eventos de Cancún, Isla Mujeres y Puerto Morelos, disponibles como API REST, servidor MCP, Markdown y JSON. Leer es público: sin clave, sin registro y sin OAuth.

Empieza en un minuto

1. Los eventos de hoy en JSON

curl -s 'https://hoyencancun.mx/api/v1/events?date=today&lang=es'

2. Cualquier página en Markdown

curl -s https://hoyencancun.mx/hoy.md
curl -s -H 'Accept: text/markdown' https://hoyencancun.mx/hoy

3. Eventos gratis y para familias de un día

curl -s 'https://hoyencancun.mx/api/v1/events?date=2026-10-04&free=1&family=1'

4. Cerca de un hotel

curl -s 'https://hoyencancun.mx/api/v1/events?near=21.1619,-86.8515&radius_km=3'

Interfaces

• OpenAPI 3.1 — especificación REST completa
• MCP — Streamable HTTP, sin estado. Herramientas: buscar_eventos, detalle_evento, eventos_hoy, eventos_fin_de_semana, avisos_hoy, enviar_evento.
• Calendario ICS — acepta los mismos filtros que /api/v1/events
• llms.txt — cuándo usar esta fuente y cómo llamarla
• Catálogo de recursos · MCP server card · Agent Skills
• Sitemap — todas las URLs canónicas

Autenticación y límites

Leer no necesita credenciales. Las peticiones anónimas se limitan por IP (60 por minuto). Para más volumen, pide una API key y mándala en la cabecera x-api-key: sube la cuota y nada más, no hay datos privados.

curl -s -H 'x-api-key: hec_…' 'https://hoyencancun.mx/api/v1/events?date=today'

Pide una clave en [email protected]. Todos los detalles en auth.md.

Errores

Todas las rutas /api responden en JSON, incluidos los 404 y los 5xx. Cada error trae un código estable, un mensaje legible y un enlace a la documentación.

{
  "error": {
    "code": "invalid_parameter",
    "message": "date: Fecha inválida (usa YYYY-MM-DD).",
    "documentation_url": "https://hoyencancun.mx/api/openapi.json"
  }
}

Uso de los datos

• Atribución obligatoria: menciona Hoy en Cancún y enlaza la URL canónica del evento.
• No caches los eventos más de unas horas: revisa status por si hay cancelaciones.
• Todas las horas son America/Cancun (UTC−5, sin horario de verano). Si conviertes, dilo.
• Entrenar modelos con este contenido se rechaza en robots.txt (ai-train=no); leerlo y citarlo es bienvenido (ai-input=yes).

Publicar un evento

Es gratis y no necesita credenciales: usa el formulario o la herramienta MCP enviar_evento. Todo envío pasa por revisión humana.