TMDB

[raulsara01]

Con la ayuda de la IA he desarrollado el sript de TMDB que actualmente no funcionaba, se lo paso a Antoine para que lo comparta. Os dejo las instrucciones y comentarios para que funcione.

TMDB (ES) — Script para Ant Movie Catalog
Importa datos de The Movie Database (TMDB) en castellano: título original y traducido, año, director, productor, guión, compositor, país, género, duración, nota, reparto, sinopsis y carátula. Romaniza automáticamente los nombres y títulos de cine asiático (japonés, chino, coreano…).

Requisitos
Ant Movie Catalog 4.2.0 o superior.
El módulo ExternalCurlHandler (los mismos archivos que usa el script de FilmAffinity: ExternalCurlHandler.pas, .ps1, .vbs + curl). Si ya usas FilmAffinity, lo tienes.
Una clave de API gratuita de TMDB (ver más abajo).
Instalación
Actualiza los scripts desde Herramientas/Scripting
Cómo conseguir tu clave de API de TMDB (gratis, 5 min)
Crea una cuenta en https://www.themoviedb.org y confirma el correo.
Arriba a la derecha, tu perfil → Ajustes.
En el menú lateral → API.
Pulsa Crear / Solicitar una clave de API → elige el tipo Developer (uso personal, gratuito).
Acepta los términos y rellena el formulario (nombre de aplicación cualquiera, p.ej. "AMC personal"; URL cualquiera, p.ej. https://www.themoviedb.org; una descripción breve; y tus datos).
Al terminar te dan la "Clave de API (v3 auth)" — una cadena de 32 caracteres. Esa es la que necesitas (NO el "Token de acceso de lectura", que es la v4).
Cómo poner la clave en el script
En AMC, abre la ventana de Scripting (Herramientas → Obtener información de Internet, o el botón de scripts).
Selecciona "TMDB (ES)" en la lista.
Pulsa "Propiedades…".
En la sección Script parameters (abajo), verás API_KEY con el valor PON_AQUI_TU_APIKEY. Edítalo y pega tu clave.
(Opcional) Idioma: es-ES por defecto; puedes poner es-MX, en-US, etc.
Acepta. Ya queda guardado.
Opciones (en Propiedades del script)
ImportarCaratula: 1 = importar carátula, 0 = no.
LimiteActores: nº máximo de actores (15 por defecto).
MaxResultados: máximo de películas que carga la búsqueda, 20 por página (500 por defecto; en búsquedas muy amplias tarda más).
RomanizarNombres: 1 = romaniza nombres/títulos no latinos (japonés, chino…), 0 = los deja como estén.
Uso
Selecciona una película de tu catálogo. (Activa "Permitir borrar campos" en las opciones de ejecución si quieres que sobrescriba campos ya rellenos.)
Doble clic en "TMDB (ES)" (o selecciónalo y pulsa Ejecutar / F9).
Escribe/edita el título a buscar → Aceptar.
Elige la película correcta de la lista (ordenada por año, las más recientes arriba) → Aceptar.
El script rellena todos los campos en español.

¿Por qué TMDB además de FilmAffinity? (ventajas)

La diferencia de fondo es cómo obtiene los datos cada script:

FilmAffinity no tiene API: el script scrapea la web (lee el HTML de las páginas). FilmAffinity está detrás de Cloudflare y limita por IP: si haces muchas consultas seguidas (catalogar en lote, varias pelis rápidas…), te bloquea temporalmente y empiezan los "no hay resultados" o errores, hasta que esperas un rato o cambias de IP/VPN.
TMDB usa API oficial y gratuita: cada usuario consulta con su propia clave, y el límite es muy holgado (decenas de peticiones por segundo). En la práctica no te bloquea aunque catalogues cientos de películas seguidas.
En concreto, este script aporta:

Sin bloqueos por IP — catalogación masiva sin baneos ni esperas.
Más estable — al leer una API con formato fijo (JSON), no se rompe cada vez que la web cambia el diseño del HTML (algo habitual con el scraping).
Búsqueda global y completa — recorre todas las páginas de resultados (hasta el tope que fijes), ordenadas por año; ideal para títulos genéricos ("Venganza", etc.).
Multiidioma — eliges el idioma de los datos (es-ES, es-MX, en-US…) sin cambiar de fuente.
Cine internacional / asiático — romaniza automáticamente títulos y nombres (p.ej. Hotaru no Haka, Tokyo monogatari, Wo de fu qin mu qin) y descarta los que solo están en alfabetos no latinos; también rellena el título original con su transliteración + el internacional entre paréntesis.
Carátulas integradas de buena calidad.
Sinopsis en español y, si no existe, la coge en inglés automáticamente (como hace la propia web de TMDB).
¿Dónde sigue ganando FilmAffinity?
Para ser justos: premios y críticas. FilmAffinity cura premios y reseñas y ofrece sinopsis en español redactadas por su comunidad — eso TMDB no lo tiene (apenas hay reseñas de usuarios). Por eso lo ideal es usar ambos: FilmAffinity para premios/críticas y sinopsis "de autor", y TMDB para el resto de metadatos, carátulas y todo el cine internacional/asiático, sin bloqueos.
Ademas TMDB tiene muchisimas mas pelis que Filmaffinity

[antp]

Thanks, I added the script to my server

Is curl needed here? As it is an API and not just scraping a website, I would expect that it would accept connections from AMC directly.