Download video's vanuit je AI-assistent met de Hunt API MCP

Het Model Context Protocol (MCP) laat AI-assistenten — Claude Code, Cursor, Gemini CLI, OpenAI Developer Mode — externe diensten als tools aanroepen. De Hunt API MCP-server stelt video- en audio-downloads beschikbaar als native tools: jouw AI-agent geeft een URL op, Hunt API downloadt het bestand op zijn eigen infrastructuur en geeft een link terug.

Geen lokale yt-dlp. Geen FFmpeg-paden. Geen bandbreedtepiek. De download vindt plaats op de servers van Hunt API, niet op de jouwe.

Waarom remote downloaden in plaats van lokaal?

yt-dlp op je eigen machine gebruiken werkt voor incidentele downloads. Het valt uiteen zodra je schaal, betrouwbaarheid of achtergrondverwerking nodig hebt.

1. Je netwerk blijft vrij

Een YouTube-video in 4K is 2–4 GB groot. Lokaal downloaden bezet je verbinding, vertraagt alles en blokkeert je terminal. Met de Hunt API MCP draait de download op externe infrastructuur. Jouw verbinding verplaatst alleen de finale URL — een paar bytes.

2. Parallelle downloads op de achtergrond

Hunt API's endpoints zijn asynchroon. Elke downloadaanroep geeft direct een job_id terug. Je AI-agent gaat verder met de volgende taak terwijl de download op de achtergrond verloopt.

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 voor fire-and-forget pipelines

Geef een webhook_url mee en Hunt API stuurt het resultaat via POST naar jouw endpoint zodra de download klaar is — tot 3 pogingen met 5 seconden interval. Je agent hoeft helemaal niet te pollen.

4. Geen binaire afhankelijkheden

yt-dlp vereist een Python-runtime. FFmpeg vereist gecompileerde binaries in je PATH. Beide vereisen updates als platforms hun formaten wijzigen. Hunt API regelt dit allemaal server-side.

5. Geo-restricties en proxies, al opgelost

De Hunt API-infrastructuur verwerkt geo-geblokkeerde content en roterende proxies automatisch. Je assistent geeft gewoon een URL door en krijgt een bestand terug.

6. Kwaliteits- en formaatcontrole

Videokwaliteit: best, 1080p, 720p, 480p, 360p
Uitvoerformaat: mp4, webm, mkv
Downloadtype: audio_video, audio, video
Max. duur: lange video's automatisch inkorten
Audiokwaliteit: best, 320kbps, 256kbps, 128kbps
Audioformaat: mp3, m4a, wav

Hunt API MCP instellen in je AI-client

Claude Code

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

Cursor

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

Praktische gebruiksscenario's

Onderzoeks- en transcriptiepipelines

Vraag je assistent een lezing of podcast als audio te downloaden. Zodra de job_id is opgelost, geef je de URL door aan een transcriptietool — alles in hetzelfde gesprek, zonder de IDE te verlaten.

Batch-concurrentie-intelligence

Geef je agent een lijst met video-URL's van concurrenten. Start alle downloads tegelijk, verzamel de resultaten, transcribeer ze en geef een vergelijkende samenvatting terug.

Automatische clip-extractie

Gebruik de parameter max_duration om alleen de eerste N seconden van een video te extraheren. Handig voor previews of om te controleren of een video de moeite waard is om volledig te verwerken.

Hoe het asynchrone model je beschermt

Elke downloadaanroep kost 1 credit en wordt alleen in rekening gebracht bij succes. Als de video privé, verwijderd of leeftijdgebonden is, betaal je niets.