# Usá los hilos de comentarios de YouTube para detectar carencias en un tutorial

Relacioná un comentario de un espectador con el pasaje exacto de la lección antes de modificar un tutorial. Leé las respuestas públicas y escuchá la explicación de la lección. Mirá también las imágenes. Después registrá lo que encontraste. Puede que falte una explicación en la lección. Puede que la lección ya explique ese punto. O puede que los hechos verificados no alcancen para evaluar.

Una carencia en la lección es una explicación que falta, una redacción poco clara o una configuración que no coincide con la de la lección. Un mapa de carencias de la lección es un conjunto de filas. Cada fila vincula un comentario con la lección, una decisión y una prueba.

Usá el Actor [YouTube Comments Scraper](https://apify.com/chronometrica/youtube-comments-scraper) para recopilar comentarios públicos. Un Actor es un programa alojado en un servidor que recopila filas de la fuente. Una Task es una configuración de entrada guardada. La [Task pública de análisis de comentarios de video](https://apify.com/chronometrica/youtube-comments-scraper/examples/youtube-video-comment-analysis) solo ofrece una configuración de entrada inicial. No demuestra que la verificación se ejecute por sí sola. El Actor no evalúa la lección. Ese trabajo lo hacés vos.

Estos límites corresponden a las versiones públicas verificadas el 2026-10-13. Las versiones posteriores pueden cambiar. Leé la salida de la ejecución de la versión que uses.

## Recopilá una muestra acotada de comentarios

La versión pública 1.1.6 del recopilador de comentarios acepta una dirección conocida de un video público o su identificador. Podés enviar entre 1 y 100 direcciones en `startUrls`. Configurá `maxCommentsPerVideo` entre 1 y 1000. Ese número es el límite. El límite es la cantidad máxima de comentarios de nivel superior que solicitás. Un comentario de nivel superior es un comentario que no es una respuesta. Configurá `commentSortMode` como `top`, `newest` o `both`. Top corresponde a los comentarios que YouTube muestra primero en su clasificación. Newest corresponde a los comentarios más recientes. Activá o desactivá `includeReplies`. Cuando las respuestas están activadas, `maxRepliesPerComment` acepta entre 1 y 100. Una respuesta es una contestación que aparece debajo de un comentario de nivel superior. Las filas de respuestas son adicionales. No consumen el límite de comentarios de nivel superior.

La Task guardada todavía tiene un video de una canción como ejemplo, un límite de 250, las respuestas activadas y un máximo de 10 respuestas. Reemplazá ese ejemplo antes de evaluar un tutorial.

```json
{
  "startUrls": ["https://www.youtube.com/watch?v=dQw4w9WgXcQ"],
  "maxCommentsPerVideo": 250,
  "commentSortMode": "both",
  "includeReplies": true,
  "maxRepliesPerComment": 10
}
```

Recopilá una muestra acotada de comentarios

Para la primera verificación, usá un tutorial que ya sepas que es público. Fijá el límite en 2. Configurá `commentSortMode` como `both`. Configurá `includeReplies` como false. Omití el límite anterior de respuestas.

```json
{
  "startUrls": ["https://www.youtube.com/watch?v=YOUR_TUTORIAL"],
  "maxCommentsPerVideo": 2,
  "commentSortMode": "both",
  "includeReplies": false
}
```

Recopilá una muestra acotada de comentarios

Una pequeña prueba de control independiente usó un video educativo, un límite de 2 y ambos modos de orden. Guardó 2 comentarios de nivel superior que tenían texto. Una fila era Top. Una fila era Newest. Cada fila tenía un `commentId`. `publishedAt` era null. OUTPUT mostró `commentsWritten` con valor 2 y `repliesWritten` con valor 0. `stopReasonCounts` incluía `requested_comment_limit_reached`. No busques un único campo `stopReason`.

Un valor de 2 en `commentsWritten` significa que se guardaron 2 filas de comentarios. Un valor de 0 en `repliesWritten` significa que se guardaron 0 filas de respuestas. Ese 0 es un recuento de esa ejecución. Un valor null en `publishedAt` significa que no se proporcionó la fecha. Un dato desconocido no es 0. No guardes una fecha vacía como 0.

Esa prueba de control no demuestra que funcione la exportación de respuestas. La prueba de aceptación no abarcó las respuestas automáticas. Este método no trata el archivo como un hilo reconstruido. Cuando una respuesta pueda cambiar el significado, abrí la página pública del video y leela. Si una respuesta no está disponible, dejá constancia de que falta. No inventes su texto.

Conservá el [orden de la fuente y el límite](/es/articles/muestreo-de-comentarios-de-youtube/) en tus notas. El límite selecciona una muestra pequeña. No determina cuál es el mayor problema de la lección. Tu video puede devolver una combinación distinta de 1 fila Top y 1 fila Newest.

Cada fila de comentario debe incluir estos campos:

| Campo | Qué significa |
| --- | --- |
| `videoId` | El identificador público del video |
| `videoUrl` | El enlace público del video |
| `commentId` | El identificador público del comentario |
| `sortMode` | Top o Newest para esa fila |
| `text` | El texto del comentario |
| `authorChannelId` | El identificador público del canal del autor, cuando la fuente lo proporciona |
| `publishedTimeText` | El texto que indica cuándo se publicó el comentario, si aparece |
| `publishedAt` | Una fecha y hora. Null significa desconocido, no 0 |
| `scrapedAt` | Cuándo se recopiló la fila |
| `status` | El resultado de la fila |

Si una entrada no estaba disponible, OUTPUT lo indica. Leé `status` antes de evaluar una fila. Si falta el texto, mantené esa fila por separado. No completes el texto. Si falta `authorChannelId`, el autor es desconocido. No inventes una persona. Un autor desconocido no equivale a 0 espectadores.

Un recuento de comentarios no es un recuento de estudiantes. Tampoco es una puntuación de cuánto entendieron las personas. Si no se guarda ningún comentario, `commentsWritten` es 0. Ese 0 significa que no tenés una muestra de comentarios. No significa que los espectadores entendieron la lección. No conviertas la muestra en una puntuación del estado de ánimo.

## Recopilá subtítulos con marcas de tiempo del mismo tutorial

La versión pública 0.1.43 del recopilador de transcripciones acepta `startUrls` conocidas, `preferredLanguages` y `outputFormats`. Usá el mismo tutorial que usaste para los comentarios. Reemplazá toda la lista `startUrls`. No dejes el ejemplo de la canción en la lista. Solicitá `json` cuando necesites segmentos con marcas de tiempo. Un segmento es un fragmento de subtítulos con su tiempo.

```json
{
  "startUrls": ["https://www.youtube.com/watch?v=YOUR_TUTORIAL"],
  "preferredLanguages": ["en"],
  "outputFormats": ["json"]
}
```

Recopilá subtítulos con marcas de tiempo del mismo tutorial

`preferredLanguages` indica una preferencia. El ejemplo usa `en` para inglés. Cambialo si preferís otro idioma para los subtítulos. Este campo no traduce la lección.

Una prueba de control de transcripción para el mismo video educativo tuvo éxito. Devolvió una pista de subtítulos en inglés creada manualmente, con contenido, y segmentos con marcas de tiempo. Una pista manual es un archivo de subtítulos preparado por una persona. La prueba de control muestra que esta versión puede devolver texto de subtítulos y sus tiempos cuando existe una pista. No demuestra que tu video tenga subtítulos. Este artículo no reproduce el texto de los subtítulos reales.

Usá los campos públicos de los segmentos `startSeconds`, `endSeconds`, `durationSeconds` y `text`. Leé `endSeconds` en el segmento. Si aparece `durationSeconds`, sumá `startSeconds` y `durationSeconds`. La suma debería corresponder al mismo intervalo que indica `endSeconds`. Si falta `durationSeconds`, dejalo como desconocido. No escribas 0.

Los subtítulos pueden tener errores. Pueden omitir un diagrama o una acción sin sonido. La ausencia de un subtítulo no demuestra que ese punto no aparezca en las imágenes. Si falta la pista, mirá y escuchá. No inventes texto de subtítulos. El Actor de transcripciones no lee comentarios. No asigna etiquetas de carencias de la lección. No demuestra que un estudiante no haya entendido.

## Hacé la verificación en 8 pasos

1. Definí el resultado de la lección antes de recopilar comentarios. Escribí el concepto en una línea clara. Escribí qué debería poder hacer el estudiante después de la lección. Elegí un tutorial público. Fijá el límite antes de leer los comentarios. Para la primera verificación, el límite es 2. Limitate a lo que dice el espectador. No supongas su edad, su habilidad ni su motivo.
2. Revisá la muestra antes de interpretarla. Confirmá el identificador del video, cada `commentId` y que `text` sea utilizable. Leé OUTPUT, incluidos `commentsWritten`, `repliesWritten` y `stopReasonCounts`. Mantené visibles el orden de la fuente y el límite en tus notas. Marcá como desconocido un autor que falta o un valor null en `publishedAt`. No conviertas un dato desconocido en 0. 2 filas son 2 comentarios en la muestra. No son 2 estudiantes ni una puntuación de la clase.
3. Elegí un comentario que mencione una tarea concreta o una duda concreta. Conservá el enlace a la fuente. Citá solo las palabras que necesites para tus propias notas. Escribí una interpretación clara que no agregue una causa. Una pregunta no es, por sí sola, un error de comprensión. Una broma, un desacuerdo o una expresión repetida tampoco son, por sí solos, un error de comprensión. Antes de evaluar la lección, etiquetá la nota como `stated_confusion`, `possible_gap` o `insufficient_context`. `stated_confusion` significa que el comentario menciona una tarea o pregunta concreta. `possible_gap` significa que el texto podría señalar un problema en la lección, pero todavía no verificaste el pasaje. `insufficient_context` significa que al comentario le falta un dato que necesitás.
4. Leé el hilo público cuando las respuestas puedan cambiar el significado. Abrí la página del video y leé las respuestas debajo de ese comentario. Una respuesta puede indicar la configuración que usa el espectador. Una respuesta puede mostrar que el problema se debió a otro producto. Registrá lo que verificaste. Registrá lo que no pudiste abrir. La pequeña prueba de control no guardó respuestas. No describas la exportación como un hilo completo. Si no podés encontrar una respuesta, indicá que el contexto de las respuestas no está disponible. No escribas una respuesta que no leíste.
5. Buscá el pasaje de la lección en la línea de tiempo del video. Usá los subtítulos con marcas de tiempo para [encontrar un posible intervalo](/es/articles/encontrar-un-concepto-en-una-clase-larga-de-youtube/). Después reproducí ese intervalo. Registrá el tiempo de inicio y el tiempo de fin en segundos del video. Registrá el concepto, la frase anterior que sea relevante y la acción visible. Mirá y escuchá antes de decidir. Una frase que falta en los subtítulos puede estar clara en un diagrama. Una palabra en los subtítulos no demuestra que la frase hablada sea clara o correcta. Usá el reloj del video. No uses la hora de tu reloj de pared.
6. Compará el comentario con la lección que verificaste. Primero hacé 3 preguntas. ¿La lección omitió la explicación? ¿La lección ya explicó ese punto? ¿O todavía falta un dato necesario? Después guardá un estado. La evidencia es el comentario, las respuestas que abriste y el pasaje que miraste. `explanation_missing` significa que el pasaje no enseña el punto sobre el que preguntó el espectador. `explanation_present_question_unresolved` significa que el pasaje explica ese punto y que nada de lo que verificaste muestra que este espectador no lo haya comprendido. Una pregunta posterior no demuestra que no lo haya comprendido. No digas que el docente falló. Usá este estado salvo que una respuesta verificada muestre que el espectador no comprendió ese punto. `possible_wording_gap` significa que la lección muestra ese punto, pero las palabras nunca aclaran la diferencia con el error del espectador. `setup_mismatch` significa que el comentario se refiere a otra configuración, producto o modelo. `unresolved` significa que no se verificó un dato necesario, por lo que no se identifica una causa. Guardá la evidencia junto al estado. Un comentario que expresa una duda no puede mostrar que todos los espectadores tuvieron el mismo problema.
7. Escribí un solo cambio únicamente cuando la evidencia justifique modificar la lección. Podés agregar un conocimiento previo necesario, mostrar un paso resuelto, nombrar la unidad, hacer más lenta una transición brusca o colocar un breve repaso junto a ese pasaje. Un conocimiento previo necesario es un dato que el estudiante necesita saber primero. Indicá qué debería quedar más claro. Indicá la prueba. No prometas que las personas se quedarán más tiempo. No prometas más visualizaciones. Modificá la explicación en ese pasaje. Cambiar un menú o resumir todo el video es otra tarea. Si el estado es `unresolved` o `setup_mismatch`, no fuerces una modificación de esta lección.
8. Guardá una fila de carencias de la lección que otra persona pueda auditar. Incluí la fuente del comentario y del hilo, el contexto que verificaste, el tiempo del pasaje, el concepto que se busca enseñar, el estado, el cambio propuesto y la prueba de aceptación. Una prueba de aceptación es una prueba que muestra que el cambio cumplió su objetivo o que no se justificaba hacer un cambio. Otra persona debería poder abrir las mismas fuentes y seguir el razonamiento de la decisión. Si falta contexto, mantené la fila en `unresolved`. No inventes una causa precisa.

## Estudiá un mapa ficticio de carencias de la lección

La lección de jardinería, los comentarios, las respuestas y los tiempos de esta sección son ficción original. Son un ejemplo didáctico. No son la salida de un Actor ni el resultado de un producto.

La lección ficticia enseña una habilidad. El estudiante mide una bandeja y usa una sola unidad. Los segmentos de subtítulos inventados son:

```json
[
  {
    "startSeconds": 20,
    "endSeconds": 28,
    "durationSeconds": 8,
    "text": "Measure the width inside the tray edges"
  },
  {
    "startSeconds": 28,
    "endSeconds": 33,
    "durationSeconds": 5,
    "text": "Use centimeters for both dimensions."
  }
]
```

Estudiá un mapa ficticio de carencias de la lección

Verificá el primer intervalo con una suma simple. 20 más 8 es igual a 28. Eso coincide con `endSeconds`. Verificá el segundo intervalo. 28 más 5 es igual a 33. Eso coincide con `endSeconds`. Estas sumas solo confirman los tiempos ficticios. No evalúan la lección.

El texto de los subtítulos no menciona una regla. En el relato, reproducís el intervalo de 20–28 segundos y mirás las imágenes. Una regla empieza en el borde interior izquierdo. Solo lo sabés porque miraste. Que los subtítulos no mencionen la regla no significa que la imagen esté vacía. El texto de los subtítulos tampoco demuestra que la frase hablada sea suficiente.

El reborde exterior es el borde de afuera de la bandeja. La lección muestra los bordes interiores. Nunca dice que el reborde exterior queda excluido.

| Comentario | Concepto | Hilo verificado | Pasaje de la lección verificado | Estado | Cambio propuesto | Prueba de aceptación |
| --- | --- | --- | --- | --- | --- | --- |
| C1 en el tutorial ficticio de jardinería. Texto del comentario: "¿Tengo que medir por fuera de la bandeja?" | Medir el ancho entre los bordes interiores. | Abriste el hilo. La respuesta dice que el espectador midió el reborde exterior. | 20–28 segundos. Frase hablada: "Medí el ancho entre los bordes interiores de la bandeja". La regla empieza en el borde interior izquierdo. No se explica verbalmente la diferencia con el reborde exterior. | `possible_wording_gap` | A los 20 segundos, mostrar ambos bordes, marcar el borde interior y decir que el reborde exterior queda excluido. | Una persona que revise puede identificar el borde exacto de inicio y el borde exacto de fin solo a partir del nuevo pasaje, sin el hilo de comentarios. |
| C2 en el tutorial ficticio de jardinería. Texto del comentario: "¿Puedo mezclar pulgadas y centímetros?" | Usar una sola unidad para ambas dimensiones. | Ninguna respuesta verificada dice que este espectador no comprendió la frase sobre la unidad. | 28–33 segundos. Frase hablada: "Usá centímetros para ambas dimensiones". | `explanation_present_question_unresolved` | Solo como opción: agregar una etiqueta visible de la unidad o un breve repaso cerca de los 28 segundos. Conservar la frase original. No reescribir la lección como si faltara la regla. | Una persona que revise todavía puede encontrar la frase original sobre la unidad entre los 28–33 segundos. La pregunta por sí sola no se cuenta como una explicación que el espectador no comprendió. |
| C3 en el tutorial ficticio de jardinería. Texto del comentario: "Falta el botón". | Encontrar un botón. El comentario no indica el dispositivo ni la versión. | No había ninguna respuesta disponible para verificar. El dispositivo y la versión siguen siendo desconocidos. | No disponible. No se conoce el tiempo del pasaje. No inventes uno. | `unresolved` | Sin modificación de la lección. | La fila sigue sin resolver. Quien revise no agrega un dispositivo, una versión, una causa ni un tiempo del pasaje. |
| C4 en el tutorial ficticio de jardinería. El comentario pregunta por un modelo de producto diferente. | Pasos para el modelo que se enseña en este video. | Abriste el hilo. La respuesta confirma que el comentario se refiere a otro modelo. | La lección actual no se considera la causa. No se asigna un tiempo del pasaje. | `setup_mismatch` | Sin modificación de esta lección. Registrar que el comentario menciona otro modelo. | Una persona que revise puede ver el otro modelo en la respuesta verificada y deja sin cambios los pasos de esta lección. |

C1 empieza como `stated_confusion` porque hace una pregunta concreta sobre cómo medir. El pasaje ya dice que hay que medir entre los bordes interiores de la bandeja. La imagen coincide, porque la regla empieza en el borde interior izquierdo. La explicación no está ausente, por lo que el estado no es `explanation_missing`. La respuesta verificada dice que el espectador usó el reborde exterior. La lección nunca explica la diferencia entre ese reborde y el borde interior. El estado que corresponde es `possible_wording_gap`. La respuesta no muestra por qué el espectador eligió el reborde. No inventes un motivo. El cambio consiste en explicar directamente la diferencia a los 20 segundos. La prueba usa solo la imagen nueva y la frase nueva.

C2 también empieza como `stated_confusion`. La frase de los 28–33 segundos ya indica la regla: usar centímetros para ambas dimensiones. Nada en el hilo verificado muestra que este espectador no haya comprendido esa frase. Una pregunta después de una frase clara no demuestra que no la haya comprendido. El estado es `explanation_present_question_unresolved`. Una etiqueta de la unidad puede ayudar a un espectador posterior a ver la regla. Es opcional. No debe reemplazar la frase original ni dar a entender que faltaba la regla.

C3 es `insufficient_context` antes de que busques un pasaje. "Falta el botón" no indica el dispositivo ni la versión. Ninguna respuesta agrega esos datos. No podés elegir un tiempo del video. No podés identificar una causa. El contexto desconocido sigue siendo desconocido. El estado sigue siendo `unresolved`, y la prueba de aceptación prohíbe forzar una modificación.

C4 empieza como una pregunta concreta, por lo que podés marcar `stated_confusion` antes de verificar el hilo. La respuesta verificada dice que el modelo no es el de esta lección. Eso cambia el estado a `setup_mismatch`. No inventes una falla en el pasaje actual. No modifiques esta lección para responder una pregunta sobre otro modelo.

Contá las filas de este relato. 1 fila es `possible_wording_gap`. 1 fila es `explanation_present_question_unresolved`. 1 fila es `unresolved`. 1 fila es `setup_mismatch`. Son 4 filas de comentarios. Una fila no equivale a un recuento comprobado de 1 persona. El relato no dice cuántas personas miraron el video. No dice que todos los espectadores compartieron un problema. Los tiempos de los subtítulos solo te ayudan a encontrar el pasaje. No reemplazan mirar y escuchar.

## Próxima acción

Elegí un comentario que exprese una duda concreta. Reproducí ese momento del video y mirá las imágenes, no solo el texto de los subtítulos. Guardá un cambio propuesto y una prueba que otra persona pueda repetir. Obtené las filas de comentarios con el Actor [YouTube Comments Scraper](https://apify.com/chronometrica/youtube-comments-scraper). Poné tu propio tutorial en la [Task de análisis de comentarios de video](https://apify.com/chronometrica/youtube-comments-scraper/examples/youtube-video-comment-analysis). El Actor solo recopila filas. Vos seguís a cargo de evaluar el pasaje.

## Fuentes y lecturas adicionales

- [Actor YouTube Comments Scraper](https://apify.com/chronometrica/youtube-comments-scraper)
- [Task de análisis de comentarios de video](https://apify.com/chronometrica/youtube-comments-scraper/examples/youtube-video-comment-analysis)
- [Task de transcripción con marcas de tiempo](https://apify.com/chronometrica/youtube-transcript-scraper/examples/youtube-timestamped-transcript-json)
- [Cómo analizar tu audiencia de YouTube](https://www.reddit.com/r/YouTubeCreators/comments/1tdvbvx/how_do_you_analyze_your_youtube_audience_across/)