Pobieraj wideo ze swojego asystenta IA dzięki MCP Hunt API

Model Context Protocol (MCP) pozwala asystentom IA — Claude Code, Cursor, Gemini CLI, OpenAI Developer Mode — wywoływać zewnętrzne usługi jako narzędzia. Serwer MCP Hunt API udostępnia pobieranie wideo i audio jako natywne narzędzia: twój agent IA podaje URL, Hunt API pobiera plik na własnej infrastrukturze i zwraca link.

Żadnego lokalnego yt-dlp. Żadnych ścieżek FFmpeg. Żadnych skoków pasma. Pobieranie odbywa się na serwerach Hunt API, nie twoich.

Dlaczego pobierać zdalnie zamiast lokalnie?

Używanie yt-dlp na własnej maszynie działa przy okazjonalnych pobraniach. Sypie się, gdy potrzebujesz skali, niezawodności lub przetwarzania w tle.

1. Twoja sieć pozostaje wolna

Film YouTube w 4K waży 2–4 GB. Pobieranie go lokalnie blokuje połączenie, spowalnia wszystko inne i zajmuje terminal do końca. Z MCP Hunt API pobieranie działa na zdalnej infrastrukturze. Twoje połączenie przesyła tylko końcowy URL — kilka bajtów.

2. Równoległe pobierania w tle

Endpointy Hunt API są asynchroniczne. Każde wywołanie pobierania natychmiast zwraca job_id. Twój agent IA przechodzi do następnego zadania, gdy pobieranie odbywa się w tle.

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. Webhooki dla pipeline'ów fire-and-forget

Przekaż webhook_url, a Hunt API wyśle wynik POST na twój endpoint po zakończeniu pobierania — do 3 prób z 5-sekundowym opóźnieniem. Twój agent nie musi w ogóle pollować.

4. Brak zależności binarnych

yt-dlp wymaga środowiska Python. FFmpeg wymaga skompilowanych plików binarnych w PATH. Oba wymagają aktualizacji, gdy platformy zmieniają formaty. Hunt API obsługuje to wszystko po stronie serwera.

5. Ograniczenia geograficzne i proxy, już rozwiązane

Infrastruktura Hunt API automatycznie obsługuje treści z blokadą geograficzną i rotujące proxy. Twój asystent po prostu podaje URL i dostaje plik.

6. Kontrola jakości i formatu

Jakość wideo: best, 1080p, 720p, 480p, 360p
Format wyjściowy: mp4, webm, mkv
Typ pobierania: audio_video, audio, video
Maks. czas trwania: automatyczne przycinanie długich filmów
Jakość audio: best, 320kbps, 256kbps, 128kbps
Format audio: mp3, m4a, wav

Konfiguracja MCP Hunt API w kliencie IA

Claude Code

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

Cursor

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

Praktyczne przypadki użycia

Pipeline badawcze i transkrypcyjne

Poproś asystenta o pobranie wykładu lub podcastu jako audio. Po rozwiązaniu job_id przekaż URL do narzędzia transkrypcyjnego — wszystko w tej samej rozmowie, bez opuszczania IDE.

Analiza konkurencji w batch

Daj agentowi listę URL filmów konkurencji. Uruchamia wszystkie pobierania jednocześnie, zbiera wyniki, transkrybuje każdy i zwraca podsumowanie porównawcze.

Automatyczna ekstrakcja klipów

Użyj parametru max_duration, aby wyodrębnić tylko pierwsze N sekund filmu. Przydatne do podglądów lub sprawdzania, czy film warto w pełni przetworzyć.

Jak model asynchroniczny cię chroni

Każde wywołanie pobierania kosztuje 1 kredyt i jest naliczane tylko w przypadku sukcesu. Jeśli film jest prywatny, usunięty lub z ograniczeniem wiekowym, nie jesteś obciążany.