Cómo extraer fotogramas de video con Claude, ChatGPT y otros agentes de IA

Opción 1: Conecta el servidor MCP remoto

El servidor MCP remoto expone la API de fotogramas como herramientas, por ejemplo getvideoframes_create_job y getvideoframes_get_job. Añade la URL a tu cliente, autoriza una vez con una API key gvf_live_ y pide fotogramas en lenguaje natural. En Claude Code es un solo comando:

claude mcp add --transport http getvideoframes https://mcp.getvideoframes.com/mcp

La configuración para Claude, ChatGPT, Cursor, VS Code y otros clientes está en la página del servidor MCP.

Opción 2: Usa el MCP local de GVF para archivos privados

GVF es un servidor MCP y CLI open source (MIT) que corre por stdio en tu equipo. Su herramienta recomendada, gvf_run, muestrea un video local, puntúa escenas y nitidez, puede detectar objetos como personas y exporta solo los fotogramas elegidos a calidad completa. Nunca sube el video, no tiene telemetría y no usa créditos de API. Instálalo desde el código fuente y regístralo:

{
  "mcpServers": {
    "gvf": { "command": "gvf-mcp" }
  }
}

Opción 3: Haz que tu agente llame a la API REST

Cuando el agente está escribiendo software y no conversando, apúntalo a la API REST y a su especificación OpenAPI. Un POST crea el trabajo; wait=true devuelve los fotogramas en la misma respuesta para videos cortos, y webhook_url avisa a tu servidor cuando terminan los trabajos largos.

curl -X POST https://api.getvideoframes.com/v1/jobs \
  -H "Authorization: Bearer $GVF_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://www.youtube.com/shorts/VIDEO_ID","every":2,"wait":true}'

El dashboard de desarrolladores incluye un prompt listo que enseña a un agente de código los endpoints, los headers de rate limit y los tipos de error.

Qué pasa cuando un agente extrae fotogramas

El agente llama a la herramienta de creación con el enlace y las opciones; GetVideoFrames descarga el video, extrae los fotogramas con FFmpeg y devuelve URLs firmadas o un ZIP. Las URLs caducan según la retención del plan (1 día en gratis y paquetes, 7 días en planes de pago). Para que el modelo vea un fotograma, el cliente debe descargar la imagen: algunos clientes muestran las URLs automáticamente y otros necesitan que las abras o adjuntes.