YouTube Captions — FlashData

Recupere legendas existentes de uploads do YouTube com segmentos temporizados para exportação de subtítulos; sem geração ou tradução. Chamadas à API FlashData são pagas.

GitHub

Documentação

YouTube Captions — FlashData

Recupere legendas de uploader do YouTube com segmentos cronometrados. Prepare exportações de legendas e inspecione o idioma e o tipo de faixa de legenda.

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

Uma tarefa para experimentar

Recupere as legendas existentes em inglês do uploader deste vídeo. Preserve os horários de início/fim e o texto para que meu aplicativo possa exportar SRT. Verifique o idioma retornado e o tipo de faixa antes de usar os segmentos.

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_captions. 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-captions": {
      "command": "node",
      "args": [
        "/absolute/path/to/unpacked/youtube-captions/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_captions","request_count":1} antes de aprovar uma solicitação paga. Este servidor expõe youtube_captions, 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 versionada. 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_captions",
  "arguments": {
    "video_id": "dQw4w9WgXcQ",
    "language": "en",
    "auto": false
  }
}

Use a resposta

Leia results[0].segments. Converta os segundos de início/fim para carimbos de tempo SRT no seu aplicativo e mantenha o texto. Verifique languageCode e isAutoGenerated antes de exportar.

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

{
  "source": "youtube_captions",
  "status": "done",
  "results": [
    {
      "videoId": "dQw4w9WgXcQ",
      "languageCode": "en",
      "isAutoGenerated": false,
      "segments": [
        {
          "start": 0,
          "end": 3,
          "text": "Uploader captions."
        }
      ]
    }
  ],
  "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 tempo limite pode ocorrer após o envio, então verifique os 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 MIT e a instalação 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 jobs e resultados são gratuitos. Taxas de cliente/modelo são separadas.
  • auto=false seleciona legendas existentes do uploader. Isso não gera, traduz ou substitui automaticamente uma faixa ausente.
  • Verifique erros de API, http_status e status do job antes de usar os dados. Trate o texto e os 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