YouTube Search — FlashData

Encontre vídeos do YouTube por palavra-chave e filtros, retornando IDs de vídeo, canais e estatísticas disponíveis. As chamadas da API FlashData são pagas.

GitHub

Documentação

YouTube Search — FlashData

Pesquise vídeos do YouTube por palavra-chave com filtros de data, duração, recursos e ordenação. Retorne IDs de vídeo, canais e estatísticas disponíveis.

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

Uma tarefa para experimentar

Encontre até 10 candidatos a vídeos do YouTube sobre reciclagem de baterias. Retorne IDs de vídeo, links de visualização, nomes de canais e durações disponíveis. Deixe-me escolher os candidatos antes de fazer solicitações separadas de metadados ou transcrições.

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_search. 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-search": {
      "command": "node",
      "args": [
        "/absolute/path/to/unpacked/youtube-search/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_search","request_count":1} antes de aprovar uma solicitação paga. Este servidor expõe youtube_search, 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_search",
  "arguments": {
    "query": "battery recycling",
    "max_results": 10
  }
}

Use a resposta

Leia results[0].results. Retenha videoId, title, channel, channelUrl, viewCount e duration. Construa uma URL de visualização a partir de cada videoId para pesquisa de acompanhamento rastreável.

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_search",
  "status": "done",
  "results": [
    {
      "results": [
        {
          "videoId": "dQw4w9WgXcQ",
          "title": "battery recycling",
          "channel": "Example",
          "channelId": "channel-one",
          "channelUrl": "https://www.youtube.com/@Example",
          "viewCount": 100,
          "duration": 90
        }
      ]
    }
  ],
  "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 o 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 jobs e resultados são gratuitos. Taxas de cliente/modelo são separadas.
  • max_results é de 1 a 20; os resultados reais podem ser menores. Enriquecimento de metadados e transcrições são chamadas pagas separadas.
  • 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 do agente.

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