openclip-transcrição

OpenClip: transcrição

transcribe converte um arquivo de vídeo ou áudio em uma transcrição com códigos de tempo. É GRATUITO, necessita de uma conta OpenClip, mas sem assinatura e sem créditos. Formatos de saída: JSON (estruturado, com marcações de tempo), SRT e VTT.

Configuração (única vez)

OpenClip é um servidor MCP remoto em https://openclip.app/mcp. Faça login com sua conta OpenClip quando a solicitação OAuth aparecer, não há chave de API para copiar.

• Claude Code: claude mcp add --transport http openclip https://openclip.app/mcp, depois /mcp para autorizar.
• Claude Desktop / web: Configurações, Conectores, "Adicionar conector personalizado", cole a URL, faça login.
• Cursor (.cursor/mcp.json): { "mcpServers": { "openclip": { "url": "https://openclip.app/mcp" } } }
• Clientes somente cabeçalho: gere um token MCP em openclip.app/settings/connect e conecte-se a https://openclip.app/mcp/key com Authorization: Bearer <token>.

Teste: chame get_account.

O fluxo

1. Upload. create_upload(filename, content_type) retorna um id e um upload_url. Faça PUT dos bytes brutos para upload_url, depois passe o id como video. NÃO chame complete_upload, isso inicia o pipeline de clipping pago. As ferramentas gratuitas leem o arquivo enviado diretamente. Vídeos já em list_videos também funcionam como entradas.
2. Transcrever. transcribe(video, language?, diarize?).
   • language - omita para detecção automática. Defina quando você já souber o idioma e quiser evitar que um clipe curto ou ruidoso seja mal detectado.
   • diarize - padrão é true, identifica quem está falando. Desative para áudio de um único falante, mantendo a saída limpa.
3. Polling. Retorna um hashid tool_job. Consulte get_tool_job_status(tool_job) a cada 5 a 10 segundos. queued / processing estão em andamento, completed retorna URLs permanentes de CDN outputs (um por formato: json, srt, vtt), failed retorna error. A maioria dos jobs termina em um ou dois minutos.
4. Ler a saída. Busque a saída JSON para trabalho programático (segmentos com horários de início e fim, rótulos de falantes). Entregue ao usuário a URL SRT ou VTT quando ele quiser um arquivo de legenda.

Duas ferramentas de transcrição diferentes

Não as confunda:

• transcribe - a ferramenta GRATUITA. Funciona em qualquer arquivo que você enviar. Esta skill.
• get_transcript - lê a transcrição de um vídeo que já passou pelo pipeline de clipping PAGO. Suporta janelas start_ms / end_ms no nível de frase ou palavra. Use-a quando você já tiver um job_id de clipping, não para um upload novo.

Regras

• Sempre faça polling. A transcrição é assíncrona, nunca retorna o texto de forma síncrona.
• Os tempos estão em milissegundos.
• As URLs de saída são links permanentes de CDN, não assinados nem expirados.
• O uso gratuito tem limite de taxa por dia com um limite de tamanho por arquivo. O texto de erro explica como remover um limite.

Exemplos de prompts para ações

• "Transcreva esta entrevista" - create_upload, PUT bytes, transcribe(video), poll, retorne a transcrição.
• "Preciso de um SRT para este vídeo" - o mesmo, depois entregue a URL de saída srt.
• "Quem disse o quê nesta gravação de reunião?" - transcribe(video, diarize=true), poll, leia a saída JSON e agrupe segmentos por falante.
• "Extraia as melhores citações desta palestra" - transcreva, faça polling, leia o JSON, depois selecione citações com seus códigos de tempo.
• "Está em holandês, transcreva" - transcribe(video, language="nl"), poll.

Relacionados

Para depois cortar o vídeo nesses códigos de tempo, veja openclip-video-editing (edit_video com operation="trim"). Para encontrar os momentos que valem a pena cortar automaticamente, veja openclip-clipping.