YouTube Extended Search — FlashData

Explore conjuntos maiores de resultados de busca no YouTube com até 700 vídeos solicitados; as contagens reais variam. Chamadas de API do FlashData são pagas.

GitHub

Documentação

YouTube Extended Search — FlashData

Pesquise conjuntos maiores de resultados de vídeos do YouTube, com até 700 resultados solicitados. Mapeie canais e tópicos recorrentes a partir de registros estruturados de vídeos.

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

Uma tarefa para experimentar

Pesquise até 100 vídeos do YouTube sobre reciclagem de baterias. Agrupe os vídeos retornados por canal, conte os vídeos observados por canal e mantenha os links de exibição para revisã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_search_extended. 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-extended-search": {
      "command": "node",
      "args": [
        "/absolute/path/to/unpacked/youtube-extended-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_extended","request_count":1} antes de aprovar uma solicitação paga. Este servidor expõe youtube_search_extended, 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_extended",
  "arguments": {
    "query": "battery recycling",
    "max_results": 100
  }
}

Use a resposta

Leia results[0].results e agrupe por channelId ou channelUrl. Mantenha os IDs originais dos vídeos e conte os resultados observados por canal; retenha os rótulos dos canais para revisão.

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_extended",
  "status": "done",
  "results": [
    {
      "results": [
        {
          "videoId": "dQw4w9WgXcQ",
          "title": "battery recycling",
          "channel": "Example",
          "channelId": "channel-one",
          "channelUrl": "https://www.youtube.com/@Example",
          "viewCount": 100,
          "duration": 90
        },
        {
          "videoId": "aqz-KE-bpKQ",
          "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 processando não é conclusão; leia a resposta concluída de output. Um tempo limite 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; as 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 trabalhos e resultados são gratuitos. Taxas de cliente/modelo são separadas.
  • O limite de solicitação é 700, não uma promessa de 700 vídeos retornados ou paginação. A busca estendida tem sua própria taxa, maior que a busca padrão.
  • Verifique erros da API, http_status e o status do trabalho 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