YouTube Download to Cloud Storage — FlashData

YouTube Download to Cloud Storage — FlashData

Entrega videos, audio o clips de YouTube a tu propio S3 u otro almacenamiento en la nube compatible. Realiza un seguimiento de la entrega asíncrona y su manifiesto de salida.

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

Una tarea para probar

Entrega los primeros 10 segundos de mi video autorizado a mi destino S3 configurado. Muestra la tasa actual de volumen de bytes antes de enviar; guarda el ID del trabajo y verifica ese mismo trabajo hasta que la entrega se complete. Devuelve el manifiesto de archivos.

Las credenciales de almacenamiento en el ejemplo son marcadores de posición. Ingresa valores reales solo a través de tu configuración protegida de cliente o un archivo de solicitud privado. Se envían a FlashData para subir el contenido multimedia y pueden conservarse en el historial de herramientas de tu cliente MCP. Usa un destino y contenido multimedia que estés autorizado a utilizar.

Instalación y conexión

1. Usa Node.js 22.18 o más reciente 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 Clave de API de FlashData. Otorga a la clave acceso a youtube_download. 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-download": {
      "command": "node",
      "args": [
        "/absolute/path/to/unpacked/youtube-download/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_download"} para leer la tasa actual de volumen de bytes antes de aprobar una descarga. request_count no aplica a descargas. Este servidor expone youtube_download, 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 escape en Windows. Mantén tu clave en la configuración protegida 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.

Ejemplo de solicitud

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

{
  "name": "youtube_download",
  "arguments": {
    "video_id": "jNQXAC9IVRw",
    "mode": "async",
    "download_type": "audio_video",
    "video_quality": "<=720",
    "output_format": "mp4",
    "start_at": "00:00:00",
    "end_at": "00:00:10",
    "storage": {
      "storage_type": "s3",
      "storage_url": "your-media-bucket",
      "access_key": "YOUR_ACCESS_KEY",
      "secret_key": "YOUR_SECRET_KEY",
      "region": "us-east-1",
      "object_prefix": "flashdata-clips"
    }
  }
}

Usa la respuesta

Envía una vez, guarda el id devuelto y llama a get_job con job_id hasta que job.status esté completado. Lee output.results[0] para file_url, file_size, downloaded_bytes y output_format. Pendiente o en procesamiento no es entrega completada.

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

{
  "job": {
    "id": "job_EXAMPLE",
    "source": "youtube_download",
    "status": "completed"
  },
  "output": {
    "results": [
      {
        "file_url": "s3://customer-bucket/clip.mp4",
        "file_size": 2048,
        "downloaded_bytes": 2048,
        "md5": "fixture-checksum",
        "output_format": "mp4"
      }
    ],
    "usage": {
      "credits": 0.001
    }
  },
  "http_status": 200,
  "request_id": "fixture-request"
}

Después del envío, conserva el id devuelto y llama a get_job con {"job_id":"RETURNED_JOB_ID"}. Repite solo esa lectura de estado gratuita mientras esté pendiente o en procesamiento; un trabajo completado contiene el manifiesto de archivos mostrado arriba. Puede ocurrir un tiempo de espera después del envío, así que verifica los Trabajos antes de enviar nuevamente.

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 JSON; no repitas la solicitud de datos pagada. 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 pagadas. Las descargas reservan Créditos y se liquidan según el volumen real de bytes subidos. get_pricing devuelve la tasa actual por TB de bytes, no una cotización de descarga por solicitud; tu proveedor de almacenamiento también puede cobrar por almacenamiento o transferencia. Los precios, trabajos y lecturas de resultados son gratuitos. Las tarifas de cliente/modelo son separadas.
• Solo se admite entrega asíncrona. Proporciona tu propio destino y credenciales; el acceso a contenido multimedia y la retención siguen tu configuración de almacenamiento. Las URL de objetos privados no son enlaces de descarga públicos. Los cargos reservan Créditos y se liquidan por bytes subidos.
• 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