Analizador de TikTok

¿Qué hace Analizador de TikTok?

Claude no puede ver videos ni abrir enlaces de TikTok, pero puede leer imágenes y texto. Esta habilidad convierte el video en ambos: una transcripción con marcas de tiempo, fotogramas espaciados uniformemente y los metadatos de la publicación. Luego los lees y respondes.

Pasos

1. Ejecuta el extractor (funciona para una URL o una ruta de video local). <skill-dir> es la carpeta que contiene este SKILL.md, dondequiera que esté instalada la habilidad:

   python "<skill-dir>/scripts/extract.py" "<url-o-archivo>" "<dir-salida>"
   

   Si el script falla por un paquete faltante, instala las dependencias una vez con python -m pip install -r "<skill-dir>/requirements.txt". Usa el bloc de notas o un directorio temporal para <dir-salida>, no el proyecto del usuario. Argumentos opcionales: máximo de fotogramas (por defecto 24), modelo Whisper (por defecto base; usa small si el habla es ruidosa, con acento o no es inglés). La primera ejecución descarga el modelo Whisper, así que permite unos minutos.
2. Lee metadata.json (descripción, autor, fecha, hashtags, recuentos, sonido), luego transcript.txt.
3. Lee los fotogramas en frames/ con la herramienta Read, en orden. Los nombres de archivo llevan la marca de tiempo (t0012.3s.jpg), para que puedas alinear cada fotograma con la transcripción. Los fotogramas son importantes porque gran parte de la información de TikTok es texto incrustado, tomas de productos, gráficos y demostraciones que nunca se mencionan.
4. Responde a la pregunta real del usuario. Para la extracción de hechos, separa lo que se dijo (transcripción), lo que se mostró (fotogramas, incluido texto en pantalla) y lo que se afirmó en la descripción. Cita marcas de tiempo para que el usuario pueda verificar la fuente.

Reglas para un análisis honesto

• Los fotogramas son muestras, aproximadamente uno cada 2 segundos. No afirmes que algo estaba ausente del video, solo que no apareció en los fotogramas muestreados o en la transcripción. Para un momento específico, vuelve a ejecutar con un número máximo de fotogramas mayor.
• Whisper comete errores con nombres, marcas, números y jerga. Señala cualquier hecho que dependa de una palabra o número transcrito, y verifícalo con el texto en pantalla.
• Que un creador diga algo no es prueba de que sea cierto. Cuando el usuario quiera verificar hechos, enumera las afirmaciones, marca cuáles son verificables y verifica con una búsqueda web en lugar de repetir la afirmación como un hecho.
• Whisper a menudo escucha mal los nombres de productos (en las pruebas escuchó "Claude" como "nube" cada vez). Usa el contexto y el texto en pantalla para corregirlos, y di que lo hiciste.
• Los recuentos de interacción y las descripciones son contexto, no veredictos.

Cuándo falla

• Carruseles de fotos / presentaciones de diapositivas: es posible que yt-dlp no los descargue. Pide al usuario que grabe la pantalla o guarde el video, luego pasa la ruta del archivo.
• Videos con inicio de sesión, privados, bloqueados por región o eliminados: la descarga falla. Pide un archivo guardado en su lugar.
• "Respuesta inesperada de la solicitud de página web": la comprobación de bots de TikTok necesita suplantación de navegador. Ejecuta python -m pip install -U "yt-dlp[curl-cffi]" y vuelve a intentarlo. Esto fue necesario en la primera prueba real.
• HTTP 403 u otros errores del extractor: TikTok cambia a menudo. Ejecuta python -m pip install -U yt-dlp y vuelve a intentarlo una vez.
• Sin habla: la transcripción está vacía, apóyate en los fotogramas y la descripción, y dilo.
• Paquetes faltantes: python -m pip install -r "<skill-dir>/requirements.txt" (ffmpeg está incluido a través de imageio-ffmpeg, no se necesita instalación del sistema).