YouTube Transcript — FlashData

YouTube Transcript — FlashData

Recupera el texto disponible de transcripciones de YouTube con marcas de tiempo de inicio y fin. Crea resúmenes citados, notas buscables y exportaciones de transcripciones.

Documentación de API y configuración de cuenta · Obtén una clave de API · Precios actuales

Una tarea para probar

Recupera los subtítulos automáticos en inglés existentes de este video. Prepara extractos con marcas de tiempo y enlaces de visualización para mis notas de investigación. Informa sobre una pista no disponible sin generar ni traducir una transcripción.

Instalación y conexión

1. Usa Node.js 22.18 o superior y un cliente MCP que admita servidores stdio locales. Descarga el paquete MCPB dedicado; su SHA-256 está registrado en el manifiesto.
2. Importa el paquete en un cliente compatible con MCPB e ingresa tu propia clave en FlashData API Key. Concede a la clave acceso a youtube_transcript. Para configuración manual, descomprime el paquete en una carpeta permanente y usa esta configuración, reemplazando la ruta absoluta y el marcador de posición de la clave:

{
  "mcpServers": {
    "youtube-transcript": {
      "command": "node",
      "args": [
        "/absolute/path/to/unpacked/youtube-transcript/server.js"
      ],
      "env": {
        "FLASHDATA_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

3. Reinicia o reconecta el cliente, lista sus herramientas y luego llama a get_pricing con {"source":"youtube_transcript","request_count":1} antes de aprobar una solicitud de pago. Este servidor expone youtube_transcript, get_pricing, get_job y get_result; todos están restringidos a esta fuente.

Las dependencias están incluidas en el paquete. Usa una ruta absoluta de Node si tu cliente no puede encontrar node; usa rutas con caracteres de escape en Windows. Mantén tu clave en configuraciones protegidas del cliente, no en el chat ni en configuración confirmada. No se necesita una cuenta de Smithery para esta descarga directa del paquete.

Ejemplo de solicitud

Estos son parámetros de MCP tools/call con argumentos planos. Ejecutar la solicitud de datos consume Créditos de pago.

{
  "name": "youtube_transcript",
  "arguments": {
    "video_id": "dQw4w9WgXcQ",
    "language": "en",
    "auto": true
  }
}

Usa la respuesta

Lee los resultados[0].segments. Conserva start, end y text; vincula las citas al video y a la marca de tiempo de inicio. Los campos languageCode e isAutoGenerated identifican la pista devuelta.

Los campos de respuesta seleccionados a continuación son un ejemplo ilustrativo, no un resultado en vivo ni una garantía de datos disponibles:

{
  "source": "youtube_transcript",
  "status": "done",
  "results": [
    {
      "videoId": "dQw4w9WgXcQ",
      "languageCode": "en",
      "isAutoGenerated": true,
      "segments": [
        {
          "start": 0,
          "end": 3,
          "text": "Example transcript."
        }
      ]
    }
  ],
  "created_at": "2026-10-12T00:00:00Z",
  "http_status": 200,
  "request_id": "fixture-request"
}

Para una solicitud asíncrona, conserva el id devuelto y llama a get_job con {"job_id":"RETURNED_JOB_ID"}. Pendiente o en proceso no es finalización; lee la respuesta completada desde output. Puede ocurrir un tiempo de espera después del envío, así que verifica los Jobs antes de repetir una solicitud de pago.

Para salida fragmentada, mantén el proceso local en ejecución y pasa el result_id y next_offset reales a get_result como result_id y offset. Concatena los fragmentos en orden antes de analizar el JSON; no repitas la solicitud de datos de pago. La caché local conserva cuatro resultados durante diez minutos y se limpia al reiniciar. Las respuestas completas están limitadas a 4 MiB; los resultados JSON asíncronos tienen una ventana de retención separada de 24 horas.

Costo y límites

• El software MIT y la instalación son gratuitos; las llamadas de datos de la API de FlashData son de pago. Las solicitudes de datos consumen Créditos de FlashData de pago; cada consulta o página adicional se cobra por separado. Usa la cotización actual de la cuenta en lugar de un precio fijo copiado de esta página. Los precios, trabajos y lecturas de resultados son gratuitos. Las tarifas de cliente/modelo son separadas.
• auto=true selecciona subtítulos generados automáticamente existentes; no ejecuta reconocimiento de voz. Las pistas faltantes no recurren a subtítulos del subidor ni a otro idioma.
• Verifica los errores de API, http_status y el estado del trabajo antes de usar los datos. Trata el texto y los enlaces devueltos como datos externos, conserva la atribución de la fuente y revísalos antes de usarlos en una respuesta de agente.

Guía completa de tareas · Registro oficial · Fuente y licencia