YouTube Captions — FlashData

YouTube Captions — FlashData

Recupera los subtítulos del subidor de YouTube con segmentos temporizados. Prepara exportaciones de subtítulos e inspecciona el idioma y el tipo de pista de subtítulos.

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

Una tarea para probar

Recupera los subtítulos existentes en inglés del subidor de este video. Conserva los tiempos de inicio/fin y el texto para que mi aplicación pueda exportar SRT. Verifica el idioma devuelto y el tipo de pista antes de usar los segmentos.

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_captions. Para la 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-captions": {
      "command": "node",
      "args": [
        "/absolute/path/to/unpacked/youtube-captions/server.js"
      ],
      "env": {
        "FLASHDATA_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

3. Reinicia o vuelve a conectar el cliente, lista sus herramientas y luego llama a get_pricing con {"source":"youtube_captions","request_count":1} antes de aprobar una solicitud de pago. Este servidor expone youtube_captions, 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 la configuración confirmada. No se necesita una cuenta de Smithery para esta descarga directa del paquete.

Solicitud de ejemplo

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

{
  "name": "youtube_captions",
  "arguments": {
    "video_id": "dQw4w9WgXcQ",
    "language": "en",
    "auto": false
  }
}

Usa la respuesta

Lee results[0].segments. Convierte los segundos de inicio/fin a marcas de tiempo SRT en tu aplicación y conserva el texto. Verifica languageCode e isAutoGenerated antes de exportar.

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_captions",
  "status": "done",
  "results": [
    {
      "videoId": "dQw4w9WgXcQ",
      "languageCode": "en",
      "isAutoGenerated": false,
      "segments": [
        {
          "start": 0,
          "end": 3,
          "text": "Uploader captions."
        }
      ]
    }
  ],
  "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 procesamiento 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 Trabajos antes de repetir una solicitud de pago.

Para la 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 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, lecturas de trabajos y resultados son gratuitos. Las tarifas del cliente/modelo son separadas.
• auto=false selecciona los subtítulos existentes del subidor. Esto no genera, traduce ni sustituye automáticamente una pista faltante.
• Verifica los errores de la 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 la tarea · Registro oficial · Fuente y licencia