YouTube Metadata — FlashData

Leia detalhes de vídeos do YouTube, descrições, estatísticas e capítulos disponíveis para pesquisa estruturada de vídeos. As chamadas da API FlashData são pagas.

GitHub

Documentação

YouTube Metadata — FlashData

Leia detalhes de vídeos do YouTube, descrições, estatísticas e capítulos disponíveis. Inspecione formatos ou prepare navegação por capítulos com timestamps.

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

Uma tarefa para experimentar

Inspecione este vídeo e crie um resumo de navegação por capítulos com o título, a descrição e os horários de início dos capítulos disponíveis. Marque capítulos ausentes em vez de inventar uma linha do tempo.

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_metadata. 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-metadata": {
      "command": "node",
      "args": [
        "/absolute/path/to/unpacked/youtube-metadata/server.js"
      ],
      "env": {
        "FLASHDATA_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}
  1. Reinicie ou reconecte o cliente, liste suas ferramentas e então chame get_pricing com {"source":"youtube_metadata","request_count":1} antes de aprovar uma solicitação paga. Este servidor expõe youtube_metadata, get_pricing, get_job e get_result; todos sã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 Credits pagos.

{
  "name": "youtube_metadata",
  "arguments": {
    "video_id": "dQw4w9WgXcQ",
    "include_formats": false,
    "include_chapters": true
  }
}

Use a resposta

Leia results[0], incluindo título, descrição e capítulos quando presentes. Combine start_time/end_time dos capítulos com a URL de visualização do vídeo para preparar um resumo de navegação.

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_metadata",
  "status": "done",
  "results": [
    {
      "videoId": "dQw4w9WgXcQ",
      "title": "Example video",
      "channel": "Example",
      "channelId": "channel-one",
      "channelUrl": "https://www.youtube.com/@Example",
      "viewCount": 100,
      "duration": 90,
      "chapters": [
        {
          "title": "Introduction",
          "start_time": 0,
          "end_time": 30
        }
      ],
      "description": "Example description"
    }
  ],
  "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 processando 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 Credits 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.
  • Campos e capítulos podem estar ausentes. Os metadados não incluem transcrição; a recuperação de transcrição é uma chamada paga separada.
  • Verifique erros de API, http_status e status do job antes de usar os dados. Trate textos 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