- Início
- Documentação
- transcribe_video
transcribe_video
Ferramenta transcribe_video do MCPTube: transcreva vídeos do YouTube em SRT e texto pela legenda do YouTube ou com IA no plano Pro, direto no seu assistente.
Transcrever vídeo do YouTube · REST: POST /v1/transcribe
Devolve a transcrição em SRT e em texto corrido, direto na resposta. Usa a legenda do YouTube quando existe, a manual antes da automática. Sem legenda, transcreve o áudio com IA, só no plano Pro (até 30 horas de áudio por mês); nos outros planos, a chamada é recusada e conta na cota.
| Parâmetro | Tipo | Descrição |
|---|---|---|
urlobrigatório | string | URL ou ID de um vídeo do YouTube. |
languageopcional | string (ISO) | Idioma da legenda, como "pt" ou "en". Sem valor, usa a legenda original do vídeo. |
forceAiTranscriptionpadrão: false | boolean | Ignora as legendas e transcreve o áudio com IA. Exclusivo do Pro. |
formatpadrão: both | "srt" | "text" | "both" | O que devolver: SRT, texto corrido ou os dois. |
Exemplo
Transcreva este vídeo e resuma em 3 tópicos: youtu.be/dQw4w9WgXcQ
O assistente chama transcribe_video, lê a transcrição e responde.
curl https://mcp.mcptube.com/v1/transcribe \ -H "Authorization: Bearer mct_SUA_CHAVE" \ -H "Content-Type: application/json" \ -d '{"url": "youtu.be/dQw4w9WgXcQ", "language": "en", "format": "text"}'
Resposta
{
"videoId": "dQw4w9WgXcQ",
"title": "Rick Astley - Never Gonna Give You Up (Official Video) (4K Remaster)",
"author": "Rick Astley",
"durationSeconds": 213,
"source": "youtube-captions",
"language": "en",
"languageName": "English",
"cueCount": 61,
"aiTranscriptionSeconds": null
}A resposta também traz o SRT e o texto corrido, nos campos srt e text, conforme format. No MCP, o assistente recebe os mesmos dados.
source indica a origem: youtube-captions (legenda manual), youtube-auto-captions (automática) ou ai-transcription (transcrição por IA). Nesse caso, a resposta traz aiTranscriptionSeconds e, no Pro, aiTranscriptionUsedSeconds e aiTranscriptionLimitSeconds do mês.