Entwicklerdokumentation wird auf Englisch veröffentlicht. Die Seitenleiste folgt deiner ausgewählten Sprache.
MCP-Integration
Claude, ChatGPT, Cursor und OpenAI Agent Builder über Model Context Protocol mit SubDownload verbinden.
Überblick
Model Context Protocol (MCP) ist ein standardisiertes Framework, mit dem KI-Assistenten externe Tools direkt aufrufen können. Der MCP-Server von SubDownload stellt 12 Tools bereit — einschließlich asynchroner KI-Transkription und einer Library pro Benutzer — und unterstützt OAuth 2.1 mit Dynamic Client Registration (DCR) sowie statische API-Keys.
Server-Konfiguration
| Eigenschaft | Wert |
|---|---|
| Server-URL | https://api.subdownload.com/mcp |
| Auth-Metadaten | /.well-known/oauth-authorization-server |
| Dynamische Registrierung | POST /oauth/register |
| Autorisieren | GET /oauth/authorize |
| Token | POST /oauth/token |
| Scope | mcp:access |
| Token-Präfix | oat_ (OAuth) oder sk_live_ (API-Key) |
Client-Einrichtung
Schritt-für-Schritt-Anleitungen:
- → Claude (Desktop / Code) — OAuth mit DCR, keine vorab erstellten Credentials nötig
- → ChatGPT — statischer OAuth-Client (Client ID / Secret)
- → OpenAI Agent Builder — Auth mit API-Key
MCP-Tools
| Tool | Kosten | Zweck |
|---|---|---|
fetch_transcript | 1 Credit | Transkript per URL/ID abrufen (Parameter: video_url, lang). |
search_youtube | 1 Credit | Videos oder Kanäle suchen (Parameter: query, type, limit). |
resolve_channel | kostenlos | @handle / URL / UC… ID zu Kanal-Info auflösen (Parameter: input). |
search_channel_videos | 1 Credit | Suche in den Videos eines Kanals (Parameter: channel, query, limit). |
get_channel_latest_videos | kostenlos | Neueste ~15 Videos via RSS (Parameter: channel). |
list_channel_videos | 1 Credit/Seite | Uploads paginiert (Parameter: channel oder continuation). |
list_playlist_videos | 1 Credit/Seite | Playlist paginiert (Parameter: playlist oder continuation). |
transcribe_video | 5 Credits bei done | Startet eine asynchrone KI-Whisper-Transkription für Videos ohne Untertitel. Liefert task_id + next_poll_after_seconds (Parameter: video_url, lang). |
get_asr_task | kostenlos | Pollt einen ASR-Task; liefert Segments bei status=done (Parameter: task_id). |
list_library | kostenlos | Listet gespeicherte Transkripte und Zusammenfassungen des Benutzers (Parameter: favorite, q, limit, offset). |
get_library_item | kostenlos | Liest einen gespeicherten Eintrag mit eingebettetem Transkript + Zusammenfassung (Parameter: id, locale). |
save_to_library | 1 Token-Quota | kind=asr markiert gespeichertes Transkript; kind=summary lädt die KI-generierte Zusammenfassung hoch (Parameter: video_id, kind, text, locale, model…). |
Fehlerbehandlung
Fehlgeschlagene Aufrufe verbrauchen nie Credits. Fehler liefern verständliche Meldungen, die KI-Assistenten natürlich interpretieren. Vollständige Liste unter Fehlercodes.