CarteleraCines.es

Obtiene la cartelera real de una ciudad entre dos fechas. Úsala cuando el usuario quiera saber qué películas están disponibles en una localidad, por ejemplo: - "qué ponen hoy en Córdoba" - "qué puedo ver este fin de semana en Sevilla" - "qué hay en cartelera mañana en Málaga" También permite filtrar resultados según: - películas aptas para niños - duración máxima - puntuación mínima - solo estrenos - géneros específicos - versión (VOSE, doblada...) o franja horaria (hora_desde/hora_hasta) Si el usuario pide recomendaciones generales en una ciudad, puedes usar esta tool como base.

{
  "type": "object",
  "properties": {
    "localidad": {
      "type": "string",
      "description": "OBLIGATORIO. Nombre de la ciudad, por ejemplo \"Córdoba\"."
    },
    "fecha_inicio": {
      "type": "string",
      "format": "date",
      "description": "Opcional. Fecha inicial YYYY-MM-DD. Si se omite, se usa hoy."
    },
    "fecha_fin": {
      "type": "string",
      "format": "date",
      "description": "Opcional. Fecha final YYYY-MM-DD. Si se omite, coincide con fecha_inicio. Máximo 14 días de rango."
    },
    "con_ninos": {
      "type": "boolean"
    },
    "duracion_max": {
      "type": "integer",
      "minimum": 1,
      "description": "Duración máxima en minutos."
    },
    "min_puntuacion": {
      "type": "number",
      "minimum": 0,
      "maximum": 10,
      "description": "Puntuación mínima entre 0 y 10."
    },
    "solo_estrenos": {
      "type": "boolean"
    },
    "generos": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "version": {
      "type": "string",
      "description": "Ej: VOSE, Doblada, 3D. Coincidencia parcial."
    },
    "hora_desde": {
      "type": "string",
      "description": "Hora mínima de la sesión, formato HH:MM."
    },
    "hora_hasta": {
      "type": "string",
      "description": "Hora máxima de la sesión, formato HH:MM."
    }
  },
  "required": [
    "localidad"
  ],
  "additionalProperties": false
}

Obtiene la cartelera real de un cine concreto entre dos fechas. Úsala cuando el usuario mencione un cine específico o quiera saber qué películas hay en un cine determinado, por ejemplo: - "qué ponen en Cinesur Córdoba hoy" - "cartelera de Kinépolis este sábado" - "qué películas hay en ese cine" Sirve para obtener todas las películas y sesiones disponibles en ese cine. Admite los mismos filtros que get_cartelera_localidad (niños, duración, puntuación, estrenos, géneros, versión, franja horaria).

{
  "type": "object",
  "properties": {
    "cine": {
      "type": "string",
      "description": "OBLIGATORIO. Nombre del cine, por ejemplo \"Kinépolis Ciudad de la Imagen\"."
    },
    "fecha_inicio": {
      "type": "string",
      "format": "date",
      "description": "Opcional. Fecha inicial YYYY-MM-DD. Si se omite, se usa hoy."
    },
    "fecha_fin": {
      "type": "string",
      "format": "date",
      "description": "Opcional. Fecha final YYYY-MM-DD. Si se omite, coincide con fecha_inicio. Máximo 14 días de rango."
    },
    "con_ninos": {
      "type": "boolean"
    },
    "duracion_max": {
      "type": "integer",
      "minimum": 1,
      "description": "Duración máxima en minutos."
    },
    "min_puntuacion": {
      "type": "number",
      "minimum": 0,
      "maximum": 10,
      "description": "Puntuación mínima entre 0 y 10."
    },
    "solo_estrenos": {
      "type": "boolean"
    },
    "generos": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "version": {
      "type": "string",
      "description": "Ej: VOSE, Doblada, 3D. Coincidencia parcial."
    },
    "hora_desde": {
      "type": "string",
      "description": "Hora mínima de la sesión, formato HH:MM."
    },
    "hora_hasta": {
      "type": "string",
      "description": "Hora máxima de la sesión, formato HH:MM."
    }
  },
  "required": [
    "cine"
  ],
  "additionalProperties": false
}

Busca en qué cines y horarios se proyecta una película. Úsala cuando el usuario quiera saber dónde o cuándo ver una película concreta, por ejemplo: - "dónde echan Dune en Córdoba" - "cuándo ponen Minecraft mañana" - "en qué cine puedo ver Oppenheimer" - "dónde la ponen en VOSE" Permite filtrar por ciudad, cine, rango de fechas, versión (VOSE/doblada) o franja horaria. Es la tool principal para responder preguntas sobre disponibilidad de una película, incluida la URL de compra de entradas de cada sesión.

{
  "type": "object",
  "properties": {
    "pelicula": {
      "type": "string",
      "description": "OBLIGATORIO. Título de la película; admite aproximaciones."
    },
    "localidad": {
      "type": "string",
      "description": "Opcional. Limita la búsqueda a esta ciudad."
    },
    "cine": {
      "type": "string",
      "description": "Opcional. Limita la búsqueda a este cine."
    },
    "fecha_inicio": {
      "type": "string",
      "format": "date",
      "description": "Opcional. Fecha inicial YYYY-MM-DD. Si se omite, busca desde ahora."
    },
    "fecha_fin": {
      "type": "string",
      "format": "date",
      "description": "Opcional. Fecha final YYYY-MM-DD. Máximo 14 días desde fecha_inicio cuando se indican ambas."
    },
    "version": {
      "type": "string",
      "description": "Ej: VOSE, Doblada, 3D. Coincidencia parcial."
    },
    "hora_desde": {
      "type": "string",
      "description": "Hora mínima de la sesión, formato HH:MM."
    },
    "hora_hasta": {
      "type": "string",
      "description": "Hora máxima de la sesión, formato HH:MM."
    }
  },
  "required": [
    "pelicula"
  ],
  "additionalProperties": false
}

Recomienda películas basadas en la cartelera real de una ciudad y fechas concretas. Úsala cuando el usuario pida sugerencias o recomendaciones, por ejemplo: - "qué me recomiendas ver este finde" - "qué puedo ver hoy" - "recomiéndame una película en Córdoba" Admite filtros como: - películas para niños - duración máxima - puntuación mínima - solo estrenos - géneros preferidos o a evitar - versión (VOSE, doblada...) o franja horaria Debe basarse siempre en películas que estén realmente disponibles en cartelera.

{
  "type": "object",
  "properties": {
    "localidad": {
      "type": "string",
      "description": "OBLIGATORIO. Ciudad en la que deben existir sesiones reales."
    },
    "fecha_inicio": {
      "type": "string",
      "format": "date",
      "description": "Opcional. Fecha inicial YYYY-MM-DD. Si se omite, se usa hoy."
    },
    "fecha_fin": {
      "type": "string",
      "format": "date",
      "description": "Opcional. Fecha final YYYY-MM-DD. Si se omite, coincide con fecha_inicio. Máximo 14 días de rango."
    },
    "con_ninos": {
      "type": "boolean"
    },
    "duracion_max": {
      "type": "integer",
      "minimum": 1,
      "description": "Duración máxima en minutos."
    },
    "min_puntuacion": {
      "type": "number",
      "minimum": 0,
      "maximum": 10,
      "description": "Puntuación mínima entre 0 y 10."
    },
    "solo_estrenos": {
      "type": "boolean"
    },
    "generos_preferidos": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "evitar_generos": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "version": {
      "type": "string",
      "description": "Ej: VOSE, Doblada, 3D. Coincidencia parcial."
    },
    "hora_desde": {
      "type": "string",
      "description": "Hora mínima de la sesión, formato HH:MM."
    },
    "hora_hasta": {
      "type": "string",
      "description": "Hora máxima de la sesión, formato HH:MM."
    }
  },
  "required": [
    "localidad"
  ],
  "additionalProperties": false
}

Obtiene la película más reciente asociada a una persona (actor o director). Úsala cuando el usuario pregunte por la última película de alguien, por ejemplo: - "la última de Stallone" - "la última de Scorsese" - "qué es lo último de DiCaprio" Opcionalmente puede limitarse a: - solo películas actualmente en cartel - una ciudad concreta Es útil como paso previo para luego buscar dónde ver esa película.

{
  "type": "object",
  "properties": {
    "persona": {
      "type": "string",
      "description": "OBLIGATORIO. Nombre del actor, actriz o director/a."
    },
    "tipo": {
      "type": "string",
      "enum": [
        "actor",
        "director"
      ],
      "description": "Opcional. Usa \"director\" solo cuando se busque dirección; por defecto se usa \"actor\"."
    },
    "solo_en_cartel": {
      "type": "boolean"
    },
    "localidad": {
      "type": "string"
    }
  },
  "required": [
    "persona"
  ],
  "additionalProperties": false
}

Busca películas por título con tolerancia a errores o búsquedas inexactas. Úsala cuando el usuario no escriba correctamente el nombre de la película o haya ambigüedad, por ejemplo: - "mision imposibl" - "avenger endgam" - "la de oppenheimer esa" Devuelve posibles coincidencias para identificar correctamente la película antes de buscar sesiones o cartelera.

{
  "type": "object",
  "properties": {
    "q": {
      "type": "string",
      "description": "OBLIGATORIO. Título o fragmento del título que se desea identificar."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 50,
      "description": "Opcional. Número máximo de coincidencias; por defecto 10."
    }
  },
  "required": [
    "q"
  ],
  "additionalProperties": false
}

Busca personas (actores o directores) por nombre con tolerancia a errores. Úsala cuando el usuario no escriba correctamente un nombre o haya ambigüedad, por ejemplo: - "almodovar" - "scorcesse" - "di caprio" Puede filtrar por tipo (actor o director) y priorizar personas con películas en cartel. Es útil antes de consultar la última película o filmografía relevante.

{
  "type": "object",
  "properties": {
    "q": {
      "type": "string",
      "description": "OBLIGATORIO. Nombre o fragmento del nombre."
    },
    "tipo": {
      "type": "string",
      "enum": [
        "actor",
        "director"
      ],
      "description": "Opcional. Filtra por actor o director."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 50,
      "description": "Opcional. Número máximo de coincidencias; por defecto 10."
    },
    "solo_en_cartel": {
      "type": "boolean"
    }
  },
  "required": [
    "q"
  ],
  "additionalProperties": false
}

Devuelve TODAS las películas de un actor o director que están en cartelera ahora mismo (con sesiones futuras reales), no solo la más reciente. Úsala cuando el usuario pregunte por la filmografía actual de alguien, por ejemplo: - "qué películas hay de Almodóvar en cartelera" - "qué puedo ver de Cruz en el cine ahora" - "todo lo que hay de Nolan ahora mismo" Diferencia con get_latest_movie_by_person: esa tool está pensada para "la última de X" (una sola película, priorizando la más reciente aunque no esté en cartel); esta siempre filtra a cartelera real y no limita a la más reciente. Útil como base para recomendaciones por gustos de actor/director.

{
  "type": "object",
  "properties": {
    "persona": {
      "type": "string",
      "description": "OBLIGATORIO. Nombre del actor, actriz o director/a."
    },
    "tipo": {
      "type": "string",
      "enum": [
        "actor",
        "director"
      ],
      "description": "Opcional. Por defecto \"actor\". Usa \"director\" cuando corresponda."
    },
    "localidad": {
      "type": "string"
    }
  },
  "required": [
    "persona"
  ],
  "additionalProperties": false
}

Indica en qué plataformas de streaming (suscripción, alquiler o compra) está disponible una película, si tenemos ese dato. Úsala cuando el usuario pregunte, por ejemplo: - "dónde puedo ver Oppenheimer en streaming" - "está en Netflix Dune" - "en qué plataforma puedo alquilar esa película" Si la película no tiene datos de streaming registrados, dilo explícitamente en vez de inventar una plataforma: no todas las películas de la base de datos tienen esta información.

{
  "type": "object",
  "properties": {
    "pelicula": {
      "type": "string",
      "description": "OBLIGATORIO. Título de la película."
    }
  },
  "required": [
    "pelicula"
  ],
  "additionalProperties": false
}

Busca cines cercanos a un punto, para "qué cines tengo cerca" o "cines cerca de mí"/"cerca de tal sitio". Si el cliente puede compartir coordenadas reales del usuario, pásalas en lat/lng; si no, pasa una localidad (p.ej. "Córdoba") y se usa el centro de esa localidad como referencia. Devuelve los cines ordenados por distancia en km dentro del radio indicado.

{
  "type": "object",
  "properties": {
    "lat": {
      "type": "number",
      "minimum": -90,
      "maximum": 90,
      "description": "Latitud. Si se usa, lng también es obligatoria."
    },
    "lng": {
      "type": "number",
      "minimum": -180,
      "maximum": 180,
      "description": "Longitud. Si se usa, lat también es obligatoria."
    },
    "localidad": {
      "type": "string",
      "description": "Ciudad usada como origen cuando no se dispone de lat+lng. Debe indicarse localidad O la pareja lat+lng."
    },
    "radio_km": {
      "type": "number",
      "exclusiveMinimum": 0,
      "maximum": 200,
      "description": "Opcional. Por defecto 25 km, máximo 200 km."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 50,
      "description": "Opcional. Por defecto 10, máximo 50."
    }
  },
  "additionalProperties": false
}

Da la ficha completa de una película: sinopsis, reparto (actores), dirección, géneros, país, año, duración, puntuación y calificación por edad. Úsala cuando el usuario pregunte, por ejemplo: - "de qué va Oppenheimer" - "quién sale en esa película" - "quién la dirige" - "cuánto dura" / "qué puntuación tiene" No la uses para saber dónde o cuándo verla (para eso, find_movie_showtimes) ni para cartelera general (get_cartelera_localidad).

{
  "type": "object",
  "properties": {
    "pelicula": {
      "type": "string",
      "description": "OBLIGATORIO. Título de la película cuya ficha se solicita."
    }
  },
  "required": [
    "pelicula"
  ],
  "additionalProperties": false
}