Scarica video dal tuo assistente IA con il MCP di Hunt API

Il Model Context Protocol (MCP) permette agli assistenti IA — Claude Code, Cursor, Gemini CLI, OpenAI Developer Mode — di chiamare servizi esterni come strumenti. Il server MCP di Hunt API espone il download di video e audio come strumenti nativi: il tuo agente IA fornisce un URL, Hunt API scarica il file sulla propria infrastruttura e restituisce un link.

Nessun yt-dlp locale. Nessun percorso FFmpeg. Nessun picco di banda. Il download avviene sui server di Hunt API, non sui tuoi.

Perché scaricare in remoto invece che in locale?

Usare yt-dlp sulla propria macchina funziona per download occasionali. Si rompe non appena hai bisogno di scala, affidabilità o elaborazione in background.

1. La tua rete rimane libera

Un video YouTube in 4K pesa 2–4 GB. Scaricarlo in locale monopolizza la connessione, rallenta tutto il resto e blocca il terminale fino alla fine. Con il MCP di Hunt API, il download gira su infrastruttura remota. La tua connessione trasferisce solo l'URL finale — pochi byte.

2. Download paralleli in background

Gli endpoint di Hunt API sono asincroni. Ogni chiamata di download restituisce immediatamente un job_id. Il tuo agente IA passa al task successivo mentre il download viene elaborato in background. Puoi avviare dieci download in pochi secondi.

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. Webhook per pipeline fire-and-forget

Passa un webhook_url e Hunt API invierà il risultato via POST al tuo endpoint quando il download è completato — fino a 3 tentativi con 5 secondi di intervallo. Il tuo agente non deve fare polling.

4. Nessuna dipendenza da binari

yt-dlp richiede un runtime Python. FFmpeg richiede binari compilati nel PATH. Entrambi richiedono aggiornamenti quando le piattaforme cambiano i loro formati. Hunt API gestisce tutto lato server.

5. Restrizioni geografiche e proxy, già risolti

L'infrastruttura di Hunt API gestisce automaticamente i contenuti geo-bloccati e i proxy rotativi. Il tuo assistente passa solo un URL e riceve un file.

6. Controllo di qualità e formato

Qualità video: best, 1080p, 720p, 480p, 360p
Formato di output: mp4, webm, mkv
Tipo di download: audio_video, audio, video
Durata massima: ritaglio automatico dei video lunghi
Qualità audio: best, 320kbps, 256kbps, 128kbps
Formato audio: mp3, m4a, wav

Configurare il MCP di Hunt API nel tuo client IA

Claude Code

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

Cursor

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

Casi d'uso pratici

Pipeline di ricerca e trascrizione

Chiedi al tuo assistente di scaricare una conferenza o podcast come audio. Una volta risolto il job_id, passa l'URL a uno strumento di trascrizione — tutto nella stessa conversazione, senza uscire dall'IDE.

Intelligence competitiva in batch

Dai al tuo agente una lista di URL di video dei concorrenti. Avvia tutti i download contemporaneamente, raccoglie i risultati, trascrive ognuno e restituisce un riepilogo comparativo.

Estrazione automatica di clip

Usa il parametro max_duration per estrarre solo i primi N secondi di un video. Utile per anteprime o per verificare se un video vale la pena di essere elaborato completamente.

Come il modello asincrono ti protegge

Ogni chiamata di download costa 1 credito e viene addebitata solo in caso di successo. Se il video è privato, eliminato o soggetto a restrizioni di età, non vieni addebitato.