Cinve
Showtimes, ticket prices, concessions and seat maps for cinemas in Venezuela.
사용해야 할까요
품질 및 안전성
도구 정의와 프로토콜 준수에 대한 자동 분석을 기반으로 합니다.
컨텍스트 비용
이는 서버의 도구가 모델의 컨텍스트에 로드될 때마다 소비되는 대략적인 토큰 수입니다. 수치가 높을수록 다른 작업에 사용할 수 있는 주의가 줄어듭니다.
설치
원클릭 설치
`claude_desktop_config.json` 파일에 다음을 추가하세요:
{
"mcpServers": {
"cinve": {
"url": "https://cinve.kevinbravo.com/mcp"
}
}
}원격 엔드포인트
https://cinve.kevinbravo.com/mcpstreamable-http할 수 있는 일
도구 목록
도구 (11)
🟢get_auth_status
Status of the Cinex, Cines Unidos and Supercines sessions and the next connection step. The Supercines account is optional for prices (without it they are the public ones) and needed for its seat maps. Returns no personal data or secrets. configured does not guarantee that the provider has not revoked the session.
입력 스키마
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}출력 스키마
{
"type": "object",
"properties": {
"connection": {
"type": "object",
"properties": {
"mode": {
"type": "string",
"enum": [
"local",
"hosted"
]
},
"client_authorized": {
"type": "boolean"
}
},
"required": [
"mode",
"client_authorized"
],
"additionalProperties": false
},
"providers": {
"type": "array",
"items": {
"type": "object",
"properties": {
"provider": {
"type": "string",
"enum": [
"cinex",
"cinesunidos",
"supercines"
]
},
"status": {
"type": "string"
},
"expires_at": {
"type": [
"string",
"null"
]
},
"login_command": {
"type": "string"
},
"remote_validity_checked": {
"type": "boolean",
"const": false
}
},
"required": [
"provider",
"status",
"expires_at",
"login_command",
"remote_validity_checked"
],
"additionalProperties": false
}
}
},
"required": [
"connection",
"providers"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}🟢list_providers
Lists providers and implemented coverage. This capability catalog does not perform a live availability check.
입력 스키마
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}출력 스키마
{
"type": "object",
"properties": {
"version": {
"type": "string"
},
"capability_audit_date": {
"type": "string"
},
"live_health_check": {
"type": "boolean",
"const": false
},
"providers": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"enum": [
"cinepic",
"cinesunidos",
"cinex",
"supercines",
"grancine"
]
},
"capabilities": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"type": "string"
}
}
},
"required": [
"id",
"capabilities"
],
"additionalProperties": false
}
}
},
"required": [
"version",
"capability_audit_date",
"live_health_check",
"providers"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}🟢connect_account(provider)
In hosted mode, starts Cinve authorization automatically when needed. If the account is already connected, returns connected=true: repeat the original query without asking the user for anything. Otherwise, returns connected=false and a private, single-use link for the user to connect their Cinex, Cines Unidos or Supercines account (Supercines shows public prices without an account, but its seat maps need one: connect it when get_seats returns auth_required for Supercines or the user asks). Present it only to the user in this conversation and do not share it with third parties: whoever uses it connects their account to this access. Do not open or fill in the form as an agent. Never ask for credentials in the chat. Expires in 10 minutes.
입력 스키마
{
"type": "object",
"properties": {
"provider": {
"type": "string",
"enum": [
"cinex",
"cinesunidos",
"supercines"
]
}
},
"required": [
"provider"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}출력 스키마
{
"type": "object",
"properties": {
"connected": {
"type": "boolean"
},
"url": {
"type": "string",
"format": "uri"
},
"expires_at": {
"type": "string"
}
},
"required": [
"connected"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}🔴disconnect_account(provider)
Disconnects the user's cinema account in Cinve and cancels pending links. Does not revoke the session directly on the cinema's website. Use when the user asks to disconnect.
입력 스키마
{
"type": "object",
"properties": {
"provider": {
"type": "string",
"enum": [
"cinex",
"cinesunidos",
"supercines"
]
}
},
"required": [
"provider"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}출력 스키마
{
"type": "object",
"properties": {
"disconnected": {
"type": "boolean",
"const": true
}
},
"required": [
"disconnected"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}🟢get_seats(provider, cinema_id, session_id, movie_id, date, ...)
Actual seat map without booking: Cinex and Cines Unidos require cinema_id, session_id and a connected account; Cinepic also requires movie_id, without login; Supercines requires cinema_id, session_id, movie_id, date if the showtime is not today, and a connected account (its website shows the map only inside a purchase, so Cinve opens one with a single ticket, picks no seat and cancels it in the same call). Use IDs from get_showtimes. Returns counters, a PNG image of the map oriented like the cinema's website (image=svg returns it as SVG) and the full ASCII map, where each seat appears with its label and state (O = status available); include_seats=true adds the per-seat detail, which is much longer. No local cache. For seat availability at Cinex, Cines Unidos, Cinepic and Supercines, use get_seats with verified venue and showtime IDs; Cinepic and Supercines also require movie_id, and Supercines the date when it is not today. Show the user the map image get_seats returns (PNG, oriented like the cinema's website, with a legend and the time of the lookup) so they can see or share it; if your client does not show images, show the ascii map in a monospaced text block with its legend and the time of the lookup. Do not describe a screen side the map marks as unverified. Use only each seat's status=available to say it is free; keep occupied, unavailable and unknown separate. The result's status=available means a map was obtained, not that all its seats are free or that the interpretation is complete. Check availability_complete and the counters: available=0 with unknown>0 does NOT mean sold out. If the map is partial, show the confirmed states and the ? marks, explain that Cinve could not interpret part of the map, and do not blame the cinema for that failure or claim that the MCP does not support seats. Do not invent seat positions or turn unknown or restricted seats into free ones. Do not repeat the login because of unknown states: only on auth_required. Lookups do not select or reserve seats; where a cinema shows the map only inside an order (Supercines, some Cinex rooms), Cinve opens a one-ticket order only to read the map and cancels it at once, as its warnings say. Availability may change before purchase.
입력 스키마
{
"type": "object",
"properties": {
"provider": {
"type": "string",
"enum": [
"cinepic",
"cinesunidos",
"cinex",
"supercines",
"grancine"
],
"description": "Cinema provider; get its capabilities and limitations with list_providers."
},
"cinema_id": {
"type": "string",
"pattern": "^[a-zA-Z0-9._-]{1,100}$",
"description": "Venue ID returned by list_cinemas for the same provider. Do not mix IDs across providers. If the venue includes code_status, use cinema_id only when it is verified; directory-* IDs cannot be queried."
},
"session_id": {
"type": "string",
"pattern": "^[a-zA-Z0-9._-]{1,100}$",
"description": "Showtime ID returned by get_showtimes for the same provider."
},
"movie_id": {
"type": "string",
"pattern": "^[a-zA-Z0-9._-]{1,100}$",
"description": "Movie ID returned by list_movies for the same provider; optional for Cinex when querying a whole venue."
},
"date": {
"description": "Supercines only: showtime date (YYYY-MM-DD), the same one used in get_showtimes; defaults to today in America/Caracas.",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"include_seats": {
"description": "true: adds seats with each seat's id, row, coordinates and provider state. Omit it to answer about availability: the ascii map is enough and is a fraction of the size.",
"type": "boolean"
},
"image": {
"description": "png (default): an image of the map to show and share. svg: the same map as an embedded SVG file, longer. none: data only.",
"type": "string",
"enum": [
"png",
"svg",
"none"
]
}
},
"required": [
"provider",
"cinema_id",
"session_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}출력 스키마
{
"type": "object",
"properties": {
"provider": {
"type": "string",
"enum": [
"cinepic",
"cinesunidos",
"cinex",
"supercines",
"grancine"
]
},
"cinema_id": {
"type": "string",
"pattern": "^[a-zA-Z0-9._-]{1,100}$"
},
"session_id": {
"type": "string",
"pattern": "^[a-zA-Z0-9._-]{1,100}$"
},
"status": {
"type": "string",
"enum": [
"available",
"empty",
"unavailable",
"auth_required",
"blocked",
"rate_limited",
"error"
]
},
"queried_at": {
"type": "string"
},
"timezone": {
"type": "string",
"const": "America/Caracas"
},
"sources": {
"type": "array",
"items": {
"type": "object",
"properties": {
"url": {
"type": "string",
"maxLength": 4096
},
"fetched_at": {
"type": "string"
},
"cached": {
"type": "boolean"
}
},
"required": [
"url",
"fetched_at",
"cached"
],
"additionalProperties": false
}
},
"warnings": {
"type": "array",
"items": {
"type": "string"
}
},
"seats": {
"description": "Per-seat detail; only with include_seats=true. The ascii map already shows each label with its state.",
"maxItems": 10000,
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"minLength": 1,
"maxLength": 200
},
"label": {
"type": "string",
"minLength": 1,
"maxLength": 40
},
"row": {
"type": "string",
"minLength": 1,
"maxLength": 40
},
"area": {
"type": "string",
"minLength": 1,
"maxLength": 40
},
"row_index": {
"type": "integer",
"minimum": 0,
"maximum": 199
},
"column_index": {
"type": "integer",
"minimum": 0,
"maximum": 199
},
"status": {
"type": "string",
"enum": [
"available",
"occupied",
"unavailable",
"unknown"
]
},
"provider_status": {
"type": "string",
"maxLength": 40
},
"category": {
"type": "string",
"maxLength": 100
},
"accessible": {
"description": "true: a wheelchair space according to the cinema's website. Its status does not change (restricted unless it is occupied).",
"type": "boolean"
}
},
"required": [
"id",
"label",
"row",
"area",
"row_index",
"column_index",
"status",
"provider_status"
],
"additionalProperties": false
}
},
"available": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"occupied": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"unavailable": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"unknown": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"total": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"availability_complete": {
"type": "boolean",
"description": "True only when a nonempty map has no unknown seat states. Does not promise purchase eligibility or a reservation."
},
"layout": {
"type": "object",
"properties": {
"screen": {
"type": "string",
"enum": [
"top",
"bottom",
"unverified"
],
"description": "Side of the screen in the ascii map and the image, as the provider's website draws it; unverified when it could not be confirmed."
},
"column_order": {
"type": "string",
"enum": [
"ascending",
"descending"
],
"description": "descending: the provider's website draws column_index from right to left; the ascii map and the image follow it."
},
"row_shift": {
"description": "Rows the provider's website centres because they are shorter: how many seats (possibly half a seat) each one is shifted from column_index 0. The ascii map and the image already apply it.",
"type": "object",
"propertyNames": {
"type": "string",
"maxLength": 40
},
"additionalProperties": {
"type": "number",
"minimum": 0,
"maximum": 100
}
}
},
"required": [
"screen",
"column_order"
],
"additionalProperties": false
},
"showing": {
"description": "The showtime as the same map response gives it (provider text), to label the image; absent fields could not be read.",
"type": "object",
"properties": {
"movie": {
"type": "string",
"maxLength": 200
},
"cinema_name": {
"type": "string",
"maxLength": 120
},
"screen": {
"type": "string",
"maxLength": 60
},
"date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"time": {
"type": "string",
"pattern": "^\\d{2}:\\d{2}$"
}
},
"additionalProperties": false
},
"ascii": {
"type": "string"
}
},
"required": [
"provider",
"cinema_id",
"session_id",
"status",
"queried_at",
"timezone",
"sources",
"warnings",
"available",
"occupied",
"unavailable",
"unknown",
"total",
"availability_complete",
"layout",
"ascii"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}🟢list_cities(provider, offset, limit, query, refresh)
Lists the provider's cities. Use their names when querying Cines Unidos.
입력 스키마
{
"type": "object",
"properties": {
"provider": {
"type": "string",
"enum": [
"cinepic",
"cinesunidos",
"cinex",
"supercines",
"grancine"
],
"description": "Cinema provider; get its capabilities and limitations with list_providers."
},
"offset": {
"default": 0,
"type": "integer",
"minimum": 0,
"maximum": 100000
},
"limit": {
"default": 50,
"type": "integer",
"minimum": 1,
"maximum": 100
},
"query": {
"description": "Filters by name, ignoring accents and case.",
"type": "string",
"minLength": 1,
"maxLength": 120
},
"refresh": {
"description": "true: queries the provider without the local cache and requests HTTP revalidation. Does not guarantee that the provider has updated its content.",
"type": "boolean"
}
},
"required": [
"provider"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}출력 스키마
{
"type": "object",
"properties": {
"provider": {
"type": "string",
"enum": [
"cinepic",
"cinesunidos",
"cinex",
"supercines",
"grancine"
]
},
"status": {
"type": "string",
"enum": [
"available",
"empty",
"unavailable",
"auth_required",
"blocked",
"rate_limited",
"error"
]
},
"queried_at": {
"type": "string"
},
"timezone": {
"type": "string",
"const": "America/Caracas"
},
"sources": {
"type": "array",
"items": {
"type": "object",
"properties": {
"url": {
"type": "string",
"maxLength": 4096
},
"fetched_at": {
"type": "string"
},
"cached": {
"type": "boolean"
}
},
"required": [
"url",
"fetched_at",
"cached"
],
"additionalProperties": false
}
},
"warnings": {
"type": "array",
"items": {
"type": "string"
}
},
"total": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"next_offset": {
"anyOf": [
{
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
{
"type": "null"
}
]
},
"partial": {
"type": "boolean"
},
"items": {
"type": "array",
"items": {
"type": "object",
"properties": {
"kind": {
"type": "string",
"const": "city"
},
"id": {
"type": "string",
"minLength": 1,
"maxLength": 200
},
"name": {
"type": "string",
"minLength": 1,
"maxLength": 512
}
},
"required": [
"kind",
"id",
"name"
],
"additionalProperties": false
}
}
},
"required": [
"provider",
"status",
"queried_at",
"timezone",
"sources",
"warnings",
"total",
"next_offset",
"partial",
"items"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}🟢list_cinemas(provider, city, near, offset, limit, ...)
Lists venues and IDs, with each venue's area. For a user who names where they are, pass near: venues come nearest first with distance_km. Cines Unidos requires city or near; Supercines accepts an optional city; Cinepic verifies its configured venues Candelaria and VVIP Lido. Providers keep known venues without a verified code (code_status=unverified). Cinex accepts an optional city and includes known venues missing from the current directory (directory_status=not_listed); neither condition indicates a closure.
입력 스키마
{
"type": "object",
"properties": {
"provider": {
"type": "string",
"enum": [
"cinepic",
"cinesunidos",
"cinex",
"supercines",
"grancine"
],
"description": "Cinema provider; get its capabilities and limitations with list_providers."
},
"city": {
"description": "City name as returned by list_cities for the same provider (e.g. Caracas); accents and case are ignored for Cines Unidos.",
"type": "string",
"minLength": 1,
"maxLength": 80
},
"near": {
"description": "Where the user is: a neighbourhood or town (Chacao, Las Mercedes, Naguanagua, Lechería) or \"lat,lng\". Sorts venues nearest first and adds distance_km; with it Cines Unidos needs no city.",
"type": "string",
"minLength": 1,
"maxLength": 120
},
"offset": {
"default": 0,
"type": "integer",
"minimum": 0,
"maximum": 100000
},
"limit": {
"default": 50,
"type": "integer",
"minimum": 1,
"maximum": 100
},
"query": {
"description": "Filters by name, ignoring accents and case.",
"type": "string",
"minLength": 1,
"maxLength": 120
},
"refresh": {
"description": "true: queries the provider without the local cache and requests HTTP revalidation. Does not guarantee that the provider has updated its content.",
"type": "boolean"
}
},
"required": [
"provider"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}출력 스키마
{
"type": "object",
"properties": {
"provider": {
"type": "string",
"enum": [
"cinepic",
"cinesunidos",
"cinex",
"supercines",
"grancine"
]
},
"status": {
"type": "string",
"enum": [
"available",
"empty",
"unavailable",
"auth_required",
"blocked",
"rate_limited",
"error"
]
},
"queried_at": {
"type": "string"
},
"timezone": {
"type": "string",
"const": "America/Caracas"
},
"sources": {
"type": "array",
"items": {
"type": "object",
"properties": {
"url": {
"type": "string",
"maxLength": 4096
},
"fetched_at": {
"type": "string"
},
"cached": {
"type": "boolean"
}
},
"required": [
"url",
"fetched_at",
"cached"
],
"additionalProperties": false
}
},
"warnings": {
"type": "array",
"items": {
"type": "string"
}
},
"total": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"next_offset": {
"anyOf": [
{
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
{
"type": "null"
}
]
},
"partial": {
"type": "boolean"
},
"items": {
"type": "array",
"items": {
"type": "object",
"properties": {
"kind": {
"type": "string",
"const": "cinema"
},
"id": {
"type": "string",
"pattern": "^[a-zA-Z0-9._-]{1,100}$",
"description": "Venue ID. directory-* identifies an entry without a queryable code; if code_status is present, use cinema_id only when it is verified."
},
"cinema_id": {
"type": "string",
"pattern": "^[a-zA-Z0-9._-]{1,100}$"
},
"code_status": {
"description": "Code confirmed by the current official data; unverified does not imply a closure.",
"type": "string",
"enum": [
"verified",
"unverified"
]
},
"directory_status": {
"description": "Presence in the directory received in this query; not_listed does not imply a closure.",
"type": "string",
"enum": [
"listed",
"not_listed"
]
},
"name": {
"type": "string",
"minLength": 1,
"maxLength": 512
},
"city": {
"type": "string"
},
"address": {
"type": "string"
},
"area": {
"description": "Neighbourhood and municipality or town of the venue (Chacao; Las Mercedes, Baruta), from Cinve's venue locations; absent for a venue Cinve has not located.",
"type": "string"
},
"distance_km": {
"description": "Straight-line distance in km from the place given in near; not a travel distance.",
"type": "number",
"minimum": 0
},
"url": {
"type": "string",
"maxLength": 4096
}
},
"required": [
"kind",
"id",
"name"
],
"additionalProperties": false
}
}
},
"required": [
"provider",
"status",
"queried_at",
"timezone",
"sources",
"warnings",
"total",
"next_offset",
"partial",
"items"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}🟢list_movies(provider, city, cinema_id, movie_id, date, ...)
Searches movies by name. Cinepic requires cinema_id (123300 Candelaria or 123301 VVIP Lido) and filters the day's showtimes; Cines Unidos requires city and allows cinema_id/date. Cinex returns the general catalog without date/venue: only provider, query and paging. Supercines returns its current listings (with presales), overall or for one venue with cinema_id, without a date. Gran Cine returns the titles with showtimes on the date, with optional cinema_id or city. IDs belong to the provider and, for Cinepic, to the venue.
입력 스키마
{
"type": "object",
"properties": {
"provider": {
"type": "string",
"enum": [
"cinepic",
"cinesunidos",
"cinex",
"supercines",
"grancine"
],
"description": "Cinema provider; get its capabilities and limitations with list_providers."
},
"city": {
"description": "City name as returned by list_cities for the same provider (e.g. Caracas); accents and case are ignored for Cines Unidos.",
"type": "string",
"minLength": 1,
"maxLength": 80
},
"cinema_id": {
"type": "string",
"pattern": "^[a-zA-Z0-9._-]{1,100}$",
"description": "Venue ID returned by list_cinemas for the same provider. Do not mix IDs across providers. If the venue includes code_status, use cinema_id only when it is verified; directory-* IDs cannot be queried."
},
"movie_id": {
"type": "string",
"pattern": "^[a-zA-Z0-9._-]{1,100}$",
"description": "Movie ID returned by list_movies for the same provider; optional for Cinex when querying a whole venue."
},
"date": {
"description": "YYYY-MM-DD; defaults to today in America/Caracas for Cinepic/Cines Unidos movies and showtimes and for Cinex, Supercines and Gran Cine showtimes.",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"refresh": {
"description": "true: queries the provider without the local cache and requests HTTP revalidation. Does not guarantee that the provider has updated its content.",
"type": "boolean"
},
"query": {
"description": "Filters by name, ignoring accents and case.",
"type": "string",
"minLength": 1,
"maxLength": 120
},
"offset": {
"default": 0,
"type": "integer",
"minimum": 0,
"maximum": 100000
},
"limit": {
"default": 50,
"type": "integer",
"minimum": 1,
"maximum": 100
}
},
"required": [
"provider"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}출력 스키마
{
"type": "object",
"properties": {
"provider": {
"type": "string",
"enum": [
"cinepic",
"cinesunidos",
"cinex",
"supercines",
"grancine"
]
},
"status": {
"type": "string",
"enum": [
"available",
"empty",
"unavailable",
"auth_required",
"blocked",
"rate_limited",
"error"
]
},
"queried_at": {
"type": "string"
},
"timezone": {
"type": "string",
"const": "America/Caracas"
},
"sources": {
"type": "array",
"items": {
"type": "object",
"properties": {
"url": {
"type": "string",
"maxLength": 4096
},
"fetched_at": {
"type": "string"
},
"cached": {
"type": "boolean"
}
},
"required": [
"url",
"fetched_at",
"cached"
],
"additionalProperties": false
}
},
"warnings": {
"type": "array",
"items": {
"type": "string"
}
},
"total": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"next_offset": {
"anyOf": [
{
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
{
"type": "null"
}
]
},
"partial": {
"type": "boolean"
},
"items": {
"type": "array",
"items": {
"type": "object",
"properties": {
"kind": {
"type": "string",
"const": "movie"
},
"id": {
"type": "string",
"pattern": "^[a-zA-Z0-9._-]{1,100}$",
"description": "Movie ID returned by list_movies."
},
"name": {
"type": "string",
"minLength": 1,
"maxLength": 512
},
"cinema_id": {
"type": "string",
"pattern": "^[a-zA-Z0-9._-]{1,100}$"
},
"city": {
"type": "string"
},
"duration_minutes": {
"type": "number"
},
"genre": {
"type": "string"
},
"rating": {
"type": "string"
},
"format": {
"type": "string"
},
"image_url": {
"type": "string",
"maxLength": 4096
},
"url": {
"type": "string",
"maxLength": 4096
}
},
"required": [
"kind",
"id",
"name"
],
"additionalProperties": false
}
}
},
"required": [
"provider",
"status",
"queried_at",
"timezone",
"sources",
"warnings",
"total",
"next_offset",
"partial",
"items"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}🟢get_showtimes(provider, city, cinema_id, movie_id, date, ...)
Gets showtimes for a date (today in Caracas by default). Cinepic requires cinema_id (123300 Candelaria or 123301 VVIP Lido); Cines Unidos requires city; Cinex accepts city for all its verified venues in the city in one call, cinema_id for one venue (with optional movie_id to filter), or only movie_id to read the movie's page across all venues; Supercines accepts cinema_id, city or movie_id; Gran Cine (arthouse cinema, includes the Paseo Las Mercedes theaters) accepts cinema_id, city or neither for all its theaters, without provider showtime IDs; use query to filter by title. The venue call resolves titles against the catalog and marks partial when it cannot confirm a movie_id. Returns the IDs needed for prices, screen/format when available and the website URL.
입력 스키마
{
"type": "object",
"properties": {
"provider": {
"type": "string",
"enum": [
"cinepic",
"cinesunidos",
"cinex",
"supercines",
"grancine"
],
"description": "Cinema provider; get its capabilities and limitations with list_providers."
},
"city": {
"description": "City name as returned by list_cities for the same provider (e.g. Caracas); accents and case are ignored for Cines Unidos.",
"type": "string",
"minLength": 1,
"maxLength": 80
},
"cinema_id": {
"type": "string",
"pattern": "^[a-zA-Z0-9._-]{1,100}$",
"description": "Venue ID returned by list_cinemas for the same provider. Do not mix IDs across providers. If the venue includes code_status, use cinema_id only when it is verified; directory-* IDs cannot be queried."
},
"movie_id": {
"type": "string",
"pattern": "^[a-zA-Z0-9._-]{1,100}$",
"description": "Movie ID returned by list_movies for the same provider; optional for Cinex when querying a whole venue."
},
"date": {
"description": "YYYY-MM-DD; defaults to today in America/Caracas for Cinepic/Cines Unidos movies and showtimes and for Cinex, Supercines and Gran Cine showtimes.",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"refresh": {
"description": "true: queries the provider without the local cache and requests HTTP revalidation. Does not guarantee that the provider has updated its content.",
"type": "boolean"
},
"query": {
"description": "Filters by name, ignoring accents and case.",
"type": "string",
"minLength": 1,
"maxLength": 120
},
"offset": {
"default": 0,
"type": "integer",
"minimum": 0,
"maximum": 100000
},
"limit": {
"default": 50,
"type": "integer",
"minimum": 1,
"maximum": 100
}
},
"required": [
"provider"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}출력 스키마
{
"type": "object",
"properties": {
"provider": {
"type": "string",
"enum": [
"cinepic",
"cinesunidos",
"cinex",
"supercines",
"grancine"
]
},
"status": {
"type": "string",
"enum": [
"available",
"empty",
"unavailable",
"auth_required",
"blocked",
"rate_limited",
"error"
]
},
"queried_at": {
"type": "string"
},
"timezone": {
"type": "string",
"const": "America/Caracas"
},
"sources": {
"type": "array",
"items": {
"type": "object",
"properties": {
"url": {
"type": "string",
"maxLength": 4096
},
"fetched_at": {
"type": "string"
},
"cached": {
"type": "boolean"
}
},
"required": [
"url",
"fetched_at",
"cached"
],
"additionalProperties": false
}
},
"warnings": {
"type": "array",
"items": {
"type": "string"
}
},
"total": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"next_offset": {
"anyOf": [
{
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
{
"type": "null"
}
]
},
"partial": {
"type": "boolean"
},
"items": {
"type": "array",
"items": {
"type": "object",
"properties": {
"kind": {
"type": "string",
"const": "showtime"
},
"id": {
"type": "string",
"pattern": "^[a-zA-Z0-9._-]{1,100}$",
"description": "Showtime identifier; use it as session_id when looking up prices."
},
"name": {
"type": "string",
"minLength": 1,
"maxLength": 512
},
"cinema_id": {
"type": "string",
"pattern": "^[a-zA-Z0-9._-]{1,100}$",
"description": "Venue ID returned by list_cinemas."
},
"cinema_name": {
"description": "Venue name when the source publishes it with the showtime.",
"type": "string",
"minLength": 1,
"maxLength": 200
},
"movie_id": {
"type": "string",
"pattern": "^[a-zA-Z0-9._-]{1,100}$",
"description": "Movie ID confirmed by list_movies or by the Cinex catalog when querying a whole venue."
},
"date": {
"type": "string",
"description": "Business date of the showtime in America/Caracas (YYYY-MM-DD)."
},
"time": {
"type": "string",
"description": "Local start time (HH:mm)."
},
"starts_at": {
"description": "Timestamp with time zone; may be missing for late-night showtimes.",
"type": "string"
},
"format": {
"type": "string"
},
"language": {
"description": "Version: es or en (dubbed) and subtitulada at Cinex and Cines Unidos (which also marks it in the title, (Esp) or (Sub)); subtitulada or no_subtitulada at Cinepic. Absent when not confirmed.",
"type": "string"
},
"screen": {
"description": "Room as the provider names it (3, VIP, VIP (Piso 5), 4DX).",
"type": "string"
},
"rating": {
"description": "Age rating the provider publishes (A, B, C; Cines Unidos may vary it by venue, such as B+12).",
"type": "string"
},
"url": {
"type": "string",
"maxLength": 4096
}
},
"required": [
"kind",
"id",
"name",
"cinema_id",
"movie_id",
"date",
"time"
],
"additionalProperties": false
}
}
},
"required": [
"provider",
"status",
"queried_at",
"timezone",
"sources",
"warnings",
"total",
"next_offset",
"partial",
"items"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}🟢get_ticket_prices(provider, movie_id, offset, limit, refresh, ...)
Gets ticket prices (Gran Cine does not publish them). Cinepic requires cinema_id, movie_id and session_id from get_showtimes. Cines Unidos requires cinema_id, session_id and a connected account. Cinex requires cinema_id, session_id and a connected account. Supercines requires cinema_id, movie_id and session_id, and date if the showtime is not today; it does not require an account (if the user connected theirs, prices are read with it). Returns USD/VES when verifiable, Cinex breakdown in VES. Does not return final purchase totals.
입력 스키마
{
"type": "object",
"properties": {
"provider": {
"type": "string",
"enum": [
"cinepic",
"cinesunidos",
"cinex",
"supercines",
"grancine"
],
"description": "Cinema provider; get its capabilities and limitations with list_providers."
},
"movie_id": {
"type": "string",
"pattern": "^[a-zA-Z0-9._-]{1,100}$",
"description": "Movie ID returned by list_movies for the same provider; optional for Cinex when querying a whole venue."
},
"offset": {
"default": 0,
"type": "integer",
"minimum": 0,
"maximum": 100000
},
"limit": {
"default": 50,
"type": "integer",
"minimum": 1,
"maximum": 100
},
"refresh": {
"description": "true: queries the provider without the local cache and requests HTTP revalidation. Does not guarantee that the provider has updated its content.",
"type": "boolean"
},
"cinema_id": {
"type": "string",
"pattern": "^[a-zA-Z0-9._-]{1,100}$",
"description": "Venue ID returned by list_cinemas for the same provider. Do not mix IDs across providers. If the venue includes code_status, use cinema_id only when it is verified; directory-* IDs cannot be queried."
},
"session_id": {
"type": "string",
"pattern": "^[a-zA-Z0-9._-]{1,100}$",
"description": "Showtime ID returned by get_showtimes for the same provider."
},
"date": {
"description": "Supercines only: showtime date (YYYY-MM-DD), the same one used in get_showtimes; defaults to today in America/Caracas. Its prices vary by day.",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
}
},
"required": [
"provider",
"cinema_id",
"session_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}출력 스키마
{
"type": "object",
"properties": {
"provider": {
"type": "string",
"enum": [
"cinepic",
"cinesunidos",
"cinex",
"supercines",
"grancine"
]
},
"status": {
"type": "string",
"enum": [
"available",
"empty",
"unavailable",
"auth_required",
"blocked",
"rate_limited",
"error"
]
},
"queried_at": {
"type": "string"
},
"timezone": {
"type": "string",
"const": "America/Caracas"
},
"sources": {
"type": "array",
"items": {
"type": "object",
"properties": {
"url": {
"type": "string",
"maxLength": 4096
},
"fetched_at": {
"type": "string"
},
"cached": {
"type": "boolean"
}
},
"required": [
"url",
"fetched_at",
"cached"
],
"additionalProperties": false
}
},
"warnings": {
"type": "array",
"items": {
"type": "string"
}
},
"total": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"next_offset": {
"anyOf": [
{
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
{
"type": "null"
}
]
},
"partial": {
"type": "boolean"
},
"items": {
"type": "array",
"items": {
"type": "object",
"properties": {
"kind": {
"type": "string",
"const": "ticket_price"
},
"id": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"description": "Ticket type identifier."
},
"name": {
"type": "string",
"minLength": 1,
"maxLength": 512
},
"cinema_id": {
"type": "string",
"pattern": "^[a-zA-Z0-9._-]{1,100}$",
"description": "ID of the queried venue."
},
"movie_id": {
"type": "string",
"pattern": "^[a-zA-Z0-9._-]{1,100}$"
},
"session_id": {
"type": "string",
"pattern": "^[a-zA-Z0-9._-]{1,100}$",
"description": "Showtime ID; comes from showtimes."
},
"prices": {
"type": "array",
"items": {
"type": "object",
"properties": {
"currency": {
"type": "string",
"enum": [
"USD",
"VES",
"unknown"
]
},
"amount": {
"type": "number",
"minimum": 0
},
"basis": {
"type": "string",
"enum": [
"provider",
"provider_conversion",
"unverified_currency"
]
}
},
"required": [
"currency",
"amount",
"basis"
],
"additionalProperties": false
},
"description": "Verifiable amounts from the provider; [] means there was no usable amount."
},
"provider_currency": {
"type": "string"
},
"provider_conversion_rate": {
"type": "number"
},
"final_total_verified": {
"type": "boolean"
},
"price_components": {
"type": "array",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"currency": {
"type": "string",
"enum": [
"USD",
"VES"
]
},
"amount": {
"type": "number",
"minimum": 0
}
},
"required": [
"name",
"currency",
"amount"
],
"additionalProperties": false
}
},
"redemption_only": {
"type": "boolean"
},
"child_only": {
"type": "boolean"
},
"sales_allowed": {
"type": "boolean"
},
"area_category_code": {
"type": "string"
},
"screen": {
"description": "Room as the provider names it (3, VIP, VIP (Piso 5), 4DX).",
"type": "string"
},
"format": {
"type": "string"
},
"language": {
"description": "Version: es or en (dubbed) and subtitulada at Cinex and Cines Unidos (which also marks it in the title, (Esp) or (Sub)); subtitulada or no_subtitulada at Cinepic. Absent when not confirmed.",
"type": "string"
},
"url": {
"type": "string",
"maxLength": 4096
},
"tickets_available": {
"description": "Tickets the provider's website still offers online with this fare (Cinepic: its quota minus tickets sold and held in purchases in progress). It can be lower than the free seats.",
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
}
},
"required": [
"kind",
"id",
"name",
"cinema_id",
"session_id",
"prices"
],
"additionalProperties": false
}
}
},
"required": [
"provider",
"status",
"queried_at",
"timezone",
"sources",
"warnings",
"total",
"next_offset",
"partial",
"items"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}🟢get_concessions(provider, query, offset, limit, refresh, ...)
Gets concessions by venue. Cinepic and Cines Unidos require only cinema_id, via a public API; Cinepic may return an empty catalog. Cinex requires cinema_id and a connected account. Supercines requires only cinema_id. Stock only when verified; does not use zero for missing prices.
입력 스키마
{
"type": "object",
"properties": {
"provider": {
"type": "string",
"enum": [
"cinepic",
"cinesunidos",
"cinex",
"supercines",
"grancine"
],
"description": "Cinema provider; get its capabilities and limitations with list_providers."
},
"query": {
"description": "Filters by name, ignoring accents and case.",
"type": "string",
"minLength": 1,
"maxLength": 120
},
"offset": {
"default": 0,
"type": "integer",
"minimum": 0,
"maximum": 100000
},
"limit": {
"default": 50,
"type": "integer",
"minimum": 1,
"maximum": 100
},
"refresh": {
"description": "true: queries the provider without the local cache and requests HTTP revalidation. Does not guarantee that the provider has updated its content.",
"type": "boolean"
},
"cinema_id": {
"type": "string",
"pattern": "^[a-zA-Z0-9._-]{1,100}$",
"description": "Venue ID returned by list_cinemas for the same provider. Do not mix IDs across providers. If the venue includes code_status, use cinema_id only when it is verified; directory-* IDs cannot be queried."
}
},
"required": [
"provider",
"cinema_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}출력 스키마
{
"type": "object",
"properties": {
"provider": {
"type": "string",
"enum": [
"cinepic",
"cinesunidos",
"cinex",
"supercines",
"grancine"
]
},
"status": {
"type": "string",
"enum": [
"available",
"empty",
"unavailable",
"auth_required",
"blocked",
"rate_limited",
"error"
]
},
"queried_at": {
"type": "string"
},
"timezone": {
"type": "string",
"const": "America/Caracas"
},
"sources": {
"type": "array",
"items": {
"type": "object",
"properties": {
"url": {
"type": "string",
"maxLength": 4096
},
"fetched_at": {
"type": "string"
},
"cached": {
"type": "boolean"
}
},
"required": [
"url",
"fetched_at",
"cached"
],
"additionalProperties": false
}
},
"warnings": {
"type": "array",
"items": {
"type": "string"
}
},
"total": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"next_offset": {
"anyOf": [
{
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
{
"type": "null"
}
]
},
"partial": {
"type": "boolean"
},
"items": {
"type": "array",
"items": {
"type": "object",
"properties": {
"kind": {
"type": "string",
"const": "concession"
},
"id": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"description": "Concession product identifier."
},
"name": {
"type": "string",
"minLength": 1,
"maxLength": 512
},
"cinema_id": {
"type": "string",
"pattern": "^[a-zA-Z0-9._-]{1,100}$",
"description": "ID of the queried venue."
},
"category": {
"type": "string"
},
"stock": {
"type": "number"
},
"prices": {
"type": "array",
"items": {
"type": "object",
"properties": {
"currency": {
"type": "string",
"enum": [
"USD",
"VES",
"unknown"
]
},
"amount": {
"type": "number",
"minimum": 0
},
"basis": {
"type": "string",
"enum": [
"provider",
"provider_conversion",
"unverified_currency"
]
}
},
"required": [
"currency",
"amount",
"basis"
],
"additionalProperties": false
},
"description": "Verifiable amounts from the provider; [] means there was no usable amount."
},
"final_total_verified": {
"type": "boolean"
},
"options_required": {
"type": "boolean"
},
"image_url": {
"type": "string",
"maxLength": 4096
},
"url": {
"type": "string",
"maxLength": 4096
}
},
"required": [
"kind",
"id",
"name",
"cinema_id",
"prices"
],
"additionalProperties": false
}
}
},
"required": [
"provider",
"status",
"queried_at",
"timezone",
"sources",
"warnings",
"total",
"next_offset",
"partial",
"items"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}커뮤니티
증거