openclip-transcription

OpenClip: transcripción

transcribe convierte un archivo de vídeo o audio en una transcripción con códigos de tiempo. Es GRATIS, solo necesita una cuenta de OpenClip, sin suscripción ni créditos. Formatos de salida: JSON (estructurado, con tiempos), SRT y VTT.

Configuración (una vez)

OpenClip es un servidor MCP remoto en https://openclip.app/mcp. Inicia sesión con tu cuenta de OpenClip cuando aparezca el mensaje de OAuth, no hay clave de API que copiar.

• Claude Code: claude mcp add --transport http openclip https://openclip.app/mcp, luego /mcp para autorizar.
• Claude Desktop / web: Configuración, Conectores, "Añadir conector personalizado", pega la URL, inicia sesión.
• Cursor (.cursor/mcp.json): { "mcpServers": { "openclip": { "url": "https://openclip.app/mcp" } } }
• Clientes solo con encabezados: genera un token MCP en openclip.app/settings/connect y conéctate a https://openclip.app/mcp/key con Authorization: Bearer <token>.

Verificación: llama a get_account.

El flujo de trabajo

1. Subir. create_upload(filename, content_type) devuelve un id y una upload_url. Haz un PUT de los bytes brutos a upload_url, luego pasa el id como video. NO llames a complete_upload, eso inicia el pipeline de recorte de pago. Las herramientas gratuitas leen el archivo subido directamente. Los vídeos ya en list_videos también funcionan como entrada.
2. Transcribir. transcribe(video, language?, diarize?).
   • language - omítelo para detección automática. Ajústalo cuando ya sepas el idioma y quieras evitar que un clip corto o ruidoso se detecte incorrectamente.
   • diarize - por defecto true, etiqueta quién habla. Desactívalo para audio de un solo hablante y mantener la salida limpia.
3. Sondear. Devuelve un hashid tool_job. Consulta get_tool_job_status(tool_job) cada 5 a 10 segundos. queued / processing están en progreso, completed devuelve URLs CDN permanentes de outputs (una por formato: json, srt, vtt), failed devuelve error. La mayoría de los trabajos terminan en uno o dos minutos.
4. Leer la salida. Obtén la salida JSON para trabajo programático (segmentos con tiempos de inicio y fin, etiquetas de hablante). Entrega al usuario la URL SRT o VTT cuando quiera un archivo de subtítulos.

Dos herramientas de transcripción diferentes

No las confundas:

• transcribe - la herramienta GRATUITA. Funciona con cualquier archivo que subas. Esta habilidad.
• get_transcript - lee la transcripción de un vídeo que ya pasó por el pipeline de recorte DE PAGO. Admite ventanas start_ms / end_ms a nivel de oración o palabra. Úsala cuando ya tengas un job_id de recorte, no para una subida nueva.

Reglas

• Siempre sondea. La transcripción es asíncrona, nunca devuelve el texto de forma síncrona.
• Los tiempos están en milisegundos.
• Las URLs de salida son enlaces CDN permanentes, no firmados ni con caducidad.
• El uso gratuito tiene un límite de velocidad por día y un límite de tamaño por archivo. El texto de error explica cómo levantar un límite.

Ejemplos de indicaciones a acciones

• "Transcribe esta entrevista" - create_upload, PUT bytes, transcribe(video), sondea, devuelve la transcripción.
• "Necesito un SRT para este vídeo" - igual, luego entrega la URL de salida srt.
• "¿Quién dijo qué en esta grabación de reunión?" - transcribe(video, diarize=true), sondea, lee la salida JSON y agrupa segmentos por hablante.
• "Extrae las mejores citas de esta charla" - transcribe, sondea, lee el JSON, luego selecciona citas con sus códigos de tiempo.
• "Está en neerlandés, tradúcelo" - transcribe(video, language="nl"), sondea.

Relacionado

Para luego recortar el vídeo en esos códigos de tiempo, consulta openclip-video-editing (edit_video con operation="trim"). Para encontrar los momentos que vale la pena recortar automáticamente, consulta openclip-clipping.