CarteleraCines.es
Cartelera de España: películas, cines, sesiones, recomendaciones y enlaces de compra.
我该使用它吗
质量与安全性
发现(5)
- HIGH
- MEDIUM在 get_person_movies_in_cartelera 中
- LOW在 get_cartelera_localidad 中
- LOW在 find_nearby_cines 中
- INFO在 get_person_movies_in_cartelera 中
基于对工具定义和协议合规性的自动分析。
上下文开销
这是每次将服务器的工具加载到模型上下文窗口时所消耗的大致 token 数。数值越高,可用于其他任务的注意力就越少。
安装
一键安装
将以下内容添加到你的 `claude_desktop_config.json` 文件中:
{
"mcpServers": {
"cartelera": {
"url": "https://www.carteleracines.es/mcp_server.php"
}
}
}远程端点
https://www.carteleracines.es/mcp_server.phpstreamable-http它能做什么
工具清单
工具(11)
🟢get_cartelera_localidad(localidad, fecha_inicio, fecha_fin, con_ninos, duracion_max, ...)
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
}🟢get_cartelera_cine(cine, fecha_inicio, fecha_fin, con_ninos, duracion_max, ...)
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
}🟢find_movie_showtimes(pelicula, localidad, cine, fecha_inicio, fecha_fin, ...)
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
}🟢recommend_movies(localidad, fecha_inicio, fecha_fin, con_ninos, duracion_max, ...)
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
}🟢get_latest_movie_by_person(persona, tipo, solo_en_cartel, localidad)
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
}🟢find_movie(q, limit)
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
}🟢find_person(q, tipo, limit, solo_en_cartel)
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
}🟢get_person_movies_in_cartelera(persona, tipo, localidad)
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
}🟢where_to_watch_online(pelicula)
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
}🟢find_nearby_cines(lat, lng, localidad, radio_km, limit)
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
}🟢get_movie_details(pelicula)
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
}社区
证据