YouTube Transcript — FlashData

Recupere o texto de transcrições existentes do YouTube com timestamps para resumos citados e notas pesquisáveis; sem reconhecimento de fala. Chamadas à API FlashData são pagas.

GitHub

Documentação

YouTube Transcript — FlashData

Recupere o texto das transcrições disponíveis no YouTube com carimbos de data/hora de início e fim. Crie resumos citados, notas pesquisáveis e exportações de transcrições.

Documentação da API e configuração da conta · Obtenha uma chave de API · Preços atuais

Uma tarefa para experimentar

Recupere as legendas automáticas em inglês existentes deste vídeo. Prepare trechos com carimbo de data/hora e links de visualização para minhas notas de pesquisa. Informe uma faixa indisponível sem gerar ou traduzir uma transcrição.

Instalação e conexão

  1. Use Node.js 22.18 ou mais recente e um cliente MCP que suporte servidores stdio locais. Baixe o pacote MCPB dedicado; seu SHA-256 está registrado no manifesto.
  2. Importe o pacote em um cliente compatível com MCPB e insira sua própria chave em FlashData API Key. Conceda à chave acesso a youtube_transcript. Para configuração manual, descompacte o pacote em uma pasta permanente e use esta configuração, substituindo o caminho absoluto e o espaço reservado da chave:
{
  "mcpServers": {
    "youtube-transcript": {
      "command": "node",
      "args": [
        "/absolute/path/to/unpacked/youtube-transcript/server.js"
      ],
      "env": {
        "FLASHDATA_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}
  1. Reinicie ou reconecte o cliente, liste suas ferramentas e chame get_pricing com {"source":"youtube_transcript","request_count":1} antes de aprovar uma solicitação paga. Este servidor expõe youtube_transcript, get_pricing, get_job e get_result; todos estão restritos a esta fonte.

As dependências estão incluídas no pacote. Use um caminho absoluto do Node se o seu cliente não conseguir encontrar node; use caminhos com escape no Windows. Mantenha sua chave em configurações protegidas do cliente, não no chat ou em configuração commitada. Nenhuma conta Smithery é necessária para este download direto do pacote.

Exemplo de solicitação

Estes são parâmetros MCP tools/call com argumentos simples. Executar a solicitação de dados usa Créditos pagos.

{
  "name": "youtube_transcript",
  "arguments": {
    "video_id": "dQw4w9WgXcQ",
    "language": "en",
    "auto": true
  }
}

Use a resposta

Leia results[0].segments. Preserve start, end e text; vincule citações ao vídeo e ao carimbo de data/hora de início. Os campos languageCode e isAutoGenerated identificam a faixa retornada.

Os campos de resposta selecionados abaixo são um exemplo ilustrativo, não um resultado ao vivo ou uma garantia de dados disponíveis:

{
  "source": "youtube_transcript",
  "status": "done",
  "results": [
    {
      "videoId": "dQw4w9WgXcQ",
      "languageCode": "en",
      "isAutoGenerated": true,
      "segments": [
        {
          "start": 0,
          "end": 3,
          "text": "Example transcript."
        }
      ]
    }
  ],
  "created_at": "2026-10-12T00:00:00Z",
  "http_status": 200,
  "request_id": "fixture-request"
}

Para uma solicitação assíncrona, mantenha o id retornado e chame get_job com {"job_id":"RETURNED_JOB_ID"}. Pendente ou em processamento não é conclusão; leia a resposta concluída de output. Um timeout pode ocorrer após o envio, então verifique Jobs antes de repetir uma solicitação paga.

Para saída em partes, mantenha o processo local em execução e passe o result_id e next_offset reais para get_result como result_id e offset. Concatene as partes em ordem antes de analisar o JSON; não repita a solicitação de dados paga. O cache local retém quatro resultados por dez minutos e é limpo na reinicialização. Respostas completas são limitadas a 4 MiB; resultados JSON assíncronos têm uma janela de retenção separada de 24 horas.

Custo e limites

  • O software e a instalação MIT são gratuitos; chamadas de dados da API FlashData são pagas. Solicitações de dados consomem Créditos FlashData pagos; cada consulta ou página adicional é cobrada separadamente. Use a cotação atual da conta em vez de um preço fixo copiado desta página. Preços, leituras de trabalho e resultados são gratuitos. Taxas de cliente/modelo são separadas.
  • auto=true seleciona legendas geradas automaticamente existentes; não executa reconhecimento de fala. Faixas ausentes não recorrem a legendas do uploader ou a outro idioma.
  • Verifique erros de API, http_status e status do trabalho antes de usar os dados. Trate texto e links retornados como dados externos, preserve a atribuição da fonte e revise-os antes de usar em uma resposta de agente.

Guia completo da tarefa · Registro oficial · Fonte e licença