Saltar al contenido principal
GetVideoFrames
Abrir navegación

MCP remoto · Disponible

Servidor MCP para extraer fotogramas con agentes de IA

Dale a Claude, ChatGPT, Cursor, VS Code o Claude Code una herramienta que convierte un enlace de YouTube, TikTok, Instagram, Facebook, X, Vimeo o un video directo en fotogramas. Añade la URL del servidor, autoriza una vez con tu API key gvf_live_ y pide fotogramas en lenguaje natural. Los trabajos usan los mismos créditos que la API REST, con 60 créditos gratis cada mes.

URL del servidor (Streamable HTTP, OAuth)

https://mcp.getvideoframes.com/mcp
Obtener una API key gratisVer precios por créditos

Remoto o local

¿Qué MCP de GetVideoFrames debo usar?

MCP remoto — para enlaces

Usa el servidor alojado cuando el video es un enlace público. GetVideoFrames descarga el video en sus servidores, extrae los fotogramas y devuelve URLs firmadas o un ZIP. No hay nada que instalar.

  • YouTube, Shorts, TikTok, Instagram Reels, Facebook, X, Vimeo, Google Drive, MP4/MOV/WebM directos
  • Funciona en Claude, ChatGPT, Cursor, VS Code y Claude Code
  • Se cobra en créditos de API; los trabajos fallidos no se cobran

MCP local de GVF — para archivos privados

Usa el MCP open source de GVF cuando el video es un archivo en tu equipo que no debe salir de él. Corre por stdio, usa FFmpeg en local y añade selección por escenas, nitidez y objetos.

  • Licencia MIT, sin telemetría, sin subidas
  • Herramienta recomendada gvf_run: muestrea, analiza, selecciona y exporta
  • Instalación desde el código fuente; requiere Node.js 22+ y FFmpeg

Configuración

Conecta tu cliente de IA

Todos los clientes usan la misma URL. La primera llamada abre una página de autorización donde pegas una key gvf_live_ del dashboard de desarrolladores.

Claude (claude.ai y Claude Desktop)

Abre Settings → Connectors → Add custom connector. Ponle de nombre GetVideoFrames, pega la URL del servidor y pulsa Connect. Los conectores personalizados están disponibles en los planes de Claude que los admiten.

Claude Code

Añade el servidor desde la terminal y luego ejecuta /mcp dentro de Claude Code para autorizar.

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

Cursor

Añade el servidor a ~/.cursor/mcp.json (todos los proyectos) o .cursor/mcp.json (un proyecto). Cursor abre la página de autorización al conectar.

{
  "mcpServers": {
    "getvideoframes": {
      "url": "https://mcp.getvideoframes.com/mcp"
    }
  }
}

VS Code (modo agente de GitHub Copilot)

Añade el servidor a .vscode/mcp.json y arráncalo desde la vista MCP.

{
  "servers": {
    "getvideoframes": {
      "type": "http",
      "url": "https://mcp.getvideoframes.com/mcp"
    }
  }
}

ChatGPT

En los planes de ChatGPT con modo desarrollador, abre Settings → Apps & Connectors → Advanced settings, activa el modo desarrollador y crea un conector con la URL del servidor y autenticación OAuth.

Otros clientes MCP

Cualquier cliente compatible con Streamable HTTP y OAuth 2.1 con registro dinámico de clientes puede conectarse directamente. Para clientes solo stdio, usa mcp-remote como puente.

npx -y mcp-remote https://mcp.getvideoframes.com/mcp

Autorización

Cómo se conecta el MCP a tu cuenta

  1. 01

    Crea una API key

    Entra al dashboard de desarrolladores con tu email y crea una key gvf_live_. Las cuentas nuevas reciben los créditos gratis del mes automáticamente.

  2. 02

    Añade el servidor a tu cliente

    Pega la URL del servidor en Claude, ChatGPT, Cursor, VS Code o Claude Code con la configuración de arriba.

  3. 03

    Autoriza una vez

    Tu cliente abre la página de autorización de GetVideoFrames. Pega la key; el servidor la verifica y entrega un token OAuth a tu cliente.

  4. 04

    Pide fotogramas

    Pega un enlace y describe los fotogramas que quieres. Revoca la key en el dashboard cuando quieras para desconectar todos los clientes que la usan.

Herramientas

Qué expone el servidor MCP

Siete herramientas replican la API REST. El agente crea el trabajo y lo consulta hasta que termina; wait=true espera hasta 50 segundos.

getvideoframes_create_jobUsa créditos
Crea una extracción por intervalo, cantidad espaciada o timestamps exactos. JPG, PNG o WebP; URLs firmadas o ZIP.
getvideoframes_get_jobSolo lectura
Estado y URLs de los fotogramas de un trabajo.
getvideoframes_list_jobsSolo lectura
Lista los trabajos recientes, del más nuevo al más antiguo.
getvideoframes_get_usageSolo lectura
Plan, saldo de créditos y límites.
getvideoframes_get_pricingSolo lectura
Planes públicos y precio de los créditos.
getvideoframes_create_demoVista previa gratis
Vista previa de seis fotogramas sin gastar créditos.
getvideoframes_get_demoVista previa gratis
Consulta una vista previa.

Ejemplos

Prompts que funcionan bien

Pega el enlace en el mismo mensaje. El agente elige el modo y el formato según lo que pidas.

  • Saca un fotograma cada 2 segundos de https://www.youtube.com/shorts/… en JPG.
  • Extrae 12 fotogramas espaciados de este TikTok y sugiere la mejor portada: https://www.tiktok.com/@…/video/…
  • Toma fotogramas PNG en 0:05, 0:42 y 1:30 de este video y ponlos en un ZIP.
  • ¿Cuántos créditos de API me quedan este mes?

Créditos y límites

Cuánto cuestan los trabajos MCP

Los trabajos MCP son trabajos de API. Un crédito cubre un minuto de video procesado (hasta 100 fotogramas) o 10 fotogramas por timestamp, y los trabajos fallidos no se cobran. El plan gratis incluye 60 créditos al mes, videos de hasta 10 minutos, 300 fotogramas por trabajo y fotogramas a 720p. Un paquete de 500 créditos cuesta $10 y no caduca.

Open source

Ejecuta el MCP de GVF en local para archivos privados

Clona y compila el repositorio de GVF, enlaza los binarios y registra gvf-mcp como servidor stdio. El MCP local nunca sube el video y no usa créditos de API.

Herramientas: gvf_run (recomendada), gvf_probe, gvf_extract, gvf_analyze, gvf_detect, gvf_select, gvf_export, gvf_runtime_status.

GVF en GitHub
git clone https://github.com/GetVideoFrames/gvf.git
cd gvf
npm install
npm run build
npm link -w @gvf/cli -w @gvf/mcp

Config del cliente MCP tras npm link

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

FAQ

Preguntas frecuentes

¿Claude o ChatGPT pueden extraer fotogramas de un video de YouTube por sí solos?
La mayoría de los asistentes de chat no pueden descargar y decodificar un enlace de video por su cuenta. Conectar el servidor MCP de GetVideoFrames les da una herramienta que sí lo hace: el asistente envía el enlace, GetVideoFrames extrae los fotogramas y el asistente recibe URLs de imagen que puede mostrar o analizar.
¿El servidor MCP de GetVideoFrames es gratis?
Conectarlo es gratis y cada cuenta recibe 60 créditos de API al mes. Un crédito es un minuto de video procesado. La herramienta create_demo devuelve una vista previa de seis fotogramas sin gastar créditos. El MCP local open source de GVF es gratis y corre en tu equipo.
¿Qué sitios de video admite el servidor MCP?
Videos públicos y Shorts de YouTube, TikTok, Reels y publicaciones de video de Instagram, videos y Reels de Facebook, X, Vimeo, Google Drive y enlaces directos .mp4, .mov o .webm. Los videos privados o que requieren login devuelven PrivateContent y no se cobran.
¿El MCP remoto sube mis archivos locales?
El MCP remoto solo acepta enlaces; no lee archivos de tu equipo. Para material local o confidencial, usa el MCP local de GVF, que procesa el archivo en tu máquina.
¿Cómo desconecto un cliente?
Revoca la API key en el dashboard de desarrolladores. Todos los clientes autorizados con esa key pierden el acceso en su siguiente llamada.

Relacionado

Sigue construyendo