Baixe vídeos do seu assistente IA com o MCP da Hunt API

O Model Context Protocol (MCP) permite que assistentes de IA — Claude Code, Cursor, Gemini CLI, OpenAI Developer Mode — chamem serviços externos como ferramentas. O servidor MCP da Hunt API expõe o download de vídeo e áudio como ferramentas nativas: seu agente IA fornece uma URL, a Hunt API baixa o arquivo em sua própria infraestrutura e retorna um link.

Sem yt-dlp local. Sem caminhos de FFmpeg. Sem pico de largura de banda. O download acontece nos servidores da Hunt API, não nos seus.

Por que baixar remotamente em vez de localmente?

Usar yt-dlp na própria máquina funciona para downloads ocasionais. Falha assim que você precisa de escala, confiabilidade ou processamento em segundo plano.

1. Sua rede permanece livre

Um vídeo do YouTube em 4K pesa de 2 a 4 GB. Baixá-lo localmente satura a conexão, deixa tudo mais lento e bloqueia o terminal até o fim. Com o MCP da Hunt API, o download roda em infraestrutura remota. Sua conexão só transfere a URL final hospedada — alguns bytes.

2. Downloads paralelos em segundo plano

Os endpoints da Hunt API são assíncronos. Cada chamada de download retorna um job_id imediatamente. Seu agente IA passa para a próxima tarefa enquanto o download é processado em segundo plano.

GET /v1/video/download?query=https://youtube.com/watch?v=...
→ { "job_id": "0193443f-fb80-9d19-29ba-82bc77c7cd84" }

GET /v1/jobs/0193443f-fb80-9d19-29ba-82bc77c7cd84
→ { "status": "CompletedJob", "result": { "response": "https://s3.huntapi.com/videos/..." } }

3. Webhooks para pipelines fire-and-forget

Passe uma webhook_url e a Hunt API enviará o resultado via POST para seu endpoint quando o download terminar — até 3 tentativas com 5 segundos de intervalo.

4. Sem dependências de binários

yt-dlp requer um runtime Python. FFmpeg requer binários compilados no PATH. Ambos precisam de atualizações quando as plataformas mudam seus formatos. A Hunt API cuida de tudo isso no servidor.

5. Restrições geográficas e proxies, já resolvidos

A infraestrutura da Hunt API lida automaticamente com conteúdo bloqueado geograficamente e proxies rotativos. Seu assistente só passa uma URL e recebe um arquivo.

6. Controle de qualidade e formato

Qualidade de vídeo: best, 1080p, 720p, 480p, 360p
Formato de saída: mp4, webm, mkv
Tipo de download: audio_video, audio, video
Duração máxima: recorte automático de vídeos longos
Qualidade de áudio: best, 320kbps, 256kbps, 128kbps
Formato de áudio: mp3, m4a, wav

Configurar o MCP da Hunt API no seu cliente IA

Claude Code

claude mcp add --transport http huntapi https://mcp.huntapi.com/ \
  --header "x-api-key: SUA_CHAVE_API"

Cursor

{
  "mcpServers": {
    "huntapi": {
      "url": "https://mcp.huntapi.com/",
      "headers": {
        "x-api-key": "SUA_CHAVE_API"
      }
    }
  }
}

Casos de uso práticos

Pipelines de pesquisa e transcrição

Peça ao seu assistente para baixar uma palestra ou podcast como áudio. Depois de resolvido o job_id, passe a URL para uma ferramenta de transcrição — tudo na mesma conversa, sem sair da IDE.

Inteligência competitiva em batch

Dê ao seu agente uma lista de URLs de vídeos de concorrentes. Ele dispara todos os downloads simultaneamente, coleta os resultados, transcreve cada um e retorna um resumo comparativo.

Extração automática de clipes

Use o parâmetro max_duration para extrair apenas os primeiros N segundos de um vídeo. Útil para previsualizações ou para verificar se vale a pena processar um vídeo completo.

Como o modelo assíncrono protege você

Cada chamada de download custa 1 crédito e só é cobrada em caso de sucesso. Se o vídeo for privado, excluído ou com restrição de idade, você não é cobrado.