¿Qué hace Movie Finder?
Herramienta para identificar películas/series a partir de vídeos de TikTok mediante análisis de fotogramas y debate entre dos IA. Todos los archivos de trabajo (vídeo, fotogramas, transcripción, resultados) se guardan en Google Drive a través de rclone — el almacenamiento local solo se usa temporalmente y se limpia.
Parámetros que el usuario puede ajustar (preguntar o deducir de la solicitud)
| Parámetro | Valor por defecto | Descripción |
|---|---|---|
| número de fotogramas | 10 | 2º argumento de grab_frames.sh |
| modo de debate | por-imagen | 3 rondas de debate por fotograma (pesado, ~30 debates para 10 fotogramas). Modo lote = todos los fotogramas se discuten en 3 rondas (económico, suficiente para la mayoría de casos) |
| rondas | 3 | número de intercambios de respuestas IA1↔IA2 |
| remoto rclone | gdrive:Linux-Server/movie-finder | se puede sobrescribir con la variable de entorno MF_REMOTE |
| mantener local | 0 | 3er argumento, 1 = conservar el vídeo también en local |
Flujo de trabajo
1. Descargar + dividir en fotogramas
bash scripts/grab_frames.sh "<url_tiktok>" [num_frames] [keep_local]
- El JSON de salida contiene:
gdrive(carpeta de destino),frames_local(ruta de los fotogramas jpg),duration_sec,video_size,scratch_dir. - El script automatiza: descargar → extraer fotogramas (saltando el 10% inicial/final) → subir a gdrive → eliminar el vídeo local. Los fotogramas permanecen en local durante la sesión (necesarios para que puedas verlos).
- Si falla la descarga (bloqueo regional/de edad): informa al usuario, sugiere un enlace alternativo.
2. Ver todos los fotogramas
Lee cada archivo jpg de frames_local con la herramienta de lectura (imagen). Anota por tu cuenta
las pistas: vestuario, ubicación, actores, época/grano de la película, texto en pantalla, marca de agua,
estilo cinematográfico, créditos del título.
3. Debate entre dos IA (mediante subagente, agente: general)
Ejecuta dos roles de forma alterna, como un chat de WhatsApp:
- 🕵️ IA 1 DETECTIVE — prompt: analiza visualmente el fotograma (menciona pistas
concretas que se vean), propón 1–3 candidatos
título + año + motivo, da un nivel de confianza. IA 1 debe leer el archivo del fotograma directamente (proporciónale la ruta). - 🔍 IA 2 ESCÉPTICO — prompt: usa la herramienta de búsqueda web para verificar
cada candidato (busca
"<título> <año> película"+ detalles únicos de la escena), refuta/confirma con evidencia de enlaces, puede sugerir nuevos candidatos.
Reglas:
- 1 ronda = IA 1 analiza → IA 2 verifica. Por defecto 3 rondas.
- Anota y muestra el modelo usado por cada IA en la transcripción y la respuesta
(ejemplo de encabezado:
🕵️ IA 1 — Detective [modelo: custom/auto]). Obtén el nombre del modelo de los metadatos del subagente/configuración; si ambos roles usan el mismo modelo, escríbelo tal cual. Inclúyelo también endiscusión.mdy en la respuesta final. - Modo
por-imagen: repite para cada fotograma, incluye siempre la transcripción de la ronda anterior + el contexto de los candidatos ya existentes para que el debate sea coherente. Deduplica: si el mismo candidato aparece repetido en diferentes fotogramas, basta con 1 ronda de refuerzo, no es necesario hacer 3 rondas completas. - Modo
lote: envía todos los fotogramas (lista de rutas) en un solo debate de 3 rondas. - No establezcas el parámetro
modeldel subagente (usa el predeterminado). - Se recomienda limitar cada subagente: IA 1 solo analiza (no necesita herramientas), IA 2 se centra en la búsqueda web.
4. Conclusión
Redacta: título + año + confianza (alta/media/baja) + enlaces de referencia de IA 2 + notas si no hay consenso.
Especial SERIES/TV, IA 2 (ronda final) debe intentar completar:
- Temporada y episodio: qué episodio es el más probable como origen del clip (pistas: escena/personaje/vestuario identificados + búsqueda web "guía de episodios", sinopsis por episodio, créditos de TMDB por episodio).
- Título del episodio (si existe).
- Duración del episodio con precisión de minutos:segundos (formato
47:23), desde IMDb (especificaciones técnicas / página del episodio) o TMDB — no redondeos aproximados. - Si no se puede determinar el episodio específico, escribe explícitamente "no se puede determinar el episodio" + solo la duración del episodio.
- Bonus (mejor esfuerzo, indica "estimación"): estima la marca de tiempo de la posición del clip dentro del episodio basándote en la escena identificada en la guía/sinopsis del episodio.
Especial PELÍCULAS: indica la duración de la película con precisión horas:minutos:segundos (formato
1:52:47) desde las especificaciones técnicas de IMDb/TMDB, no "±120 minutos".
5. Guardar resultados en gdrive (sin nuevos archivos locales)
- Transcripción completa →
rclone rcat "<DEST>/discusión.md"(formato chat: emoji 🕵️/🔍, nombre del rol, contenido de la respuesta). - Conclusión →
rclone rcat "<DEST>/resultados.md".
Plantilla de resultados.md para SERIES (es obligatorio rellenar los detalles del episodio):
# Resultados de Identificación — Movie Finder
- Título / Tipo / Año / Plataforma / Creado por / Confianza
## Detalles del Episodio
- Temporada y Episodio : S01E05 (si se puede determinar, si no "no se puede determinar el episodio")
- Título del Episodio : "Beautiful Billionaires"
- Duración del Episodio : 47:23 (minutos:segundos, de IMDb/TMDB)
- Total de Episodios : 11 (T1)
- Estimación de posición del clip : ±12:40 dentro del episodio (mejor esfuerzo, estimación)
## Por qué coincide
...evidencia principal...
## Referencias
...enlaces...
Para PELÍCULAS: sustituye la sección "Detalles del Episodio" por "Duración de la Película: 1:52:47 (horas:minutos:segundos)".
6. Limpieza local
rm -rf <scratch_dir>
7. Responder al usuario
Orden de la respuesta: detalles del episodio y duración si es serie (temporada, número de episodio, título del episodio, duración) o duración de la película + resumen breve de los puntos del debate + enlaces de referencia + ubicación de la carpeta en gdrive — luego la suposición final (🎬 Resultado: título/año) colócala AL FINAL como cierre. No muestres la transcripción completa a menos que se solicite.
Ejemplo de transcripción
🕵️ IA 1 — Detective [modelo: custom/auto]: El fotograma 3 muestra un uniforme
de soldado británico del siglo XIX... Candidatos: "1917" (2019), "The Northman" (2022)
🔍 IA 2 — Escéptico [modelo: custom/auto]: Compruebo... [búsqueda web] "The Northman"
es de la era vikinga, no coincide. "1917" coincide: guerra de trincheras, plano secuencia.
Verificado: [enlace]