Descarga vídeos desde tu asistente IA con el MCP de Hunt API

El Model Context Protocol (MCP) permite a los asistentes de IA — Claude Code, Cursor, Gemini CLI, OpenAI Developer Mode — llamar a servicios externos como herramientas. El servidor MCP de Hunt API expone la descarga de vídeo y audio como herramientas nativas: tu agente IA proporciona una URL, Hunt API descarga el archivo en su propia infraestructura y devuelve un enlace.

Sin yt-dlp local. Sin rutas de FFmpeg. Sin pico de ancho de banda. La descarga ocurre en los servidores de Hunt API, no en los tuyos.

¿Por qué descargar de forma remota en lugar de localmente?

Usar yt-dlp en tu propia máquina funciona para descargas ocasionales. Se rompe en cuanto necesitas escala, fiabilidad o procesamiento en segundo plano.

1. Tu red se mantiene libre

Un vídeo de YouTube en 4K pesa entre 2 y 4 GB. Descargarlo localmente satura tu conexión, ralentiza todo lo demás y bloquea tu terminal hasta que termina. Con el MCP de Hunt API, la descarga corre en infraestructura remota. Tu conexión solo transfiere la URL final alojada — unos pocos bytes.

2. Descargas paralelas en segundo plano

Los endpoints de Hunt API son asíncronos. Cada llamada de descarga devuelve un job_id de forma inmediata. Tu agente IA pasa a la siguiente tarea mientras la descarga se procesa en segundo plano. Puedes lanzar diez descargas en segundos y consultar los resultados cuando quieras.

// Lanzar una descarga
GET /v1/video/download?query=https://youtube.com/watch?v=...
→ { "job_id": "0193443f-fb80-9d19-29ba-82bc77c7cd84" }

// 30 segundos después, consultar el resultado
GET /v1/jobs/0193443f-fb80-9d19-29ba-82bc77c7cd84
→ { "status": "CompletedJob", "result": { "response": "https://s3.huntapi.com/videos/..." } }

3. Webhooks para pipelines fire-and-forget

Pasa una webhook_url y Hunt API enviará el resultado vía POST a tu endpoint cuando termine la descarga — hasta 3 reintentos con 5 segundos de intervalo. Tu agente no necesita hacer polling en absoluto.

4. Sin dependencias de binarios

yt-dlp requiere un runtime de Python. FFmpeg requiere binarios compilados en tu PATH. Ambos necesitan actualizaciones cuando las plataformas cambian sus formatos. Hunt API gestiona todo eso en el servidor.

5. Restricciones geográficas y proxies, ya resueltos

La infraestructura de Hunt API maneja automáticamente el contenido con restricción geográfica y los proxies rotativos. Tu asistente IA solo pasa una URL y recibe un archivo.

6. Control de calidad y formato

Calidad de vídeo: best, 1080p, 720p, 480p, 360p
Formato de salida: mp4, webm, mkv
Tipo de descarga: audio_video, audio, video
Duración máxima: recorte automático de vídeos largos
Calidad de audio: best, 320kbps, 256kbps, 128kbps
Formato de audio: mp3, m4a, wav

Configurar el MCP de Hunt API en tu cliente IA

Claude Code

claude mcp add --transport http huntapi https://mcp.huntapi.com/ \
  --header "x-api-key: TU_CLAVE_API"

Cursor

{
  "mcpServers": {
    "huntapi": {
      "url": "https://mcp.huntapi.com/",
      "headers": {
        "x-api-key": "TU_CLAVE_API"
      }
    }
  }
}

Casos de uso prácticos

Pipelines de investigación y transcripción

Pide a tu asistente que descargue una conferencia o podcast como audio. Una vez resuelto el job_id, pasa la URL a una herramienta de transcripción — todo en la misma conversación, sin salir del IDE.

Inteligencia competitiva en batch

Da a tu agente una lista de URLs de vídeos de la competencia. Lanza todas las descargas simultáneamente, recoge los resultados, transcribe cada uno y devuelve un resumen comparativo.

Extracción automática de clips

Usa el parámetro max_duration para extraer solo los primeros N segundos de un vídeo. Útil para previsualizaciones o para comprobar si un vídeo merece procesarse por completo.

Cómo el modelo asíncrono te protege

Cada llamada de descarga cuesta 1 crédito y solo se factura en caso de éxito. Si el vídeo es privado, eliminado o tiene restricción de edad, no se te cobra.