La documentación para desarrolladores se publica en inglés. La navegación lateral sigue el idioma seleccionado.
Integración MCP
Conecta Claude, ChatGPT, Cursor y OpenAI Agent Builder a SubDownload mediante Model Context Protocol.
Resumen
Model Context Protocol (MCP) es un marco estandarizado que permite a los asistentes de IA llamar herramientas externas directamente. El servidor MCP de SubDownload expone 12 herramientas — incluyendo transcripción IA asíncrona y una Library por usuario — y admite OAuth 2.1 con Dynamic Client Registration (DCR) además de claves API estáticas.
Configuración del servidor
| Propiedad | Valor |
|---|---|
| URL del servidor | https://api.subdownload.com/mcp |
| Metadatos de auth | /.well-known/oauth-authorization-server |
| Registro dinámico | POST /oauth/register |
| Autorizar | GET /oauth/authorize |
| Token | POST /oauth/token |
| Scope | mcp:access |
| Prefijo de token | oat_ (OAuth) o sk_live_ (clave API) |
Configuración del cliente
Consulta las guías paso a paso:
- → Claude (Desktop / Code) — OAuth con DCR, sin credenciales precreadas
- → ChatGPT — cliente OAuth estático (Client ID / Secret)
- → OpenAI Agent Builder — autenticación con clave API
Herramientas MCP
| Herramienta | Coste | Propósito |
|---|---|---|
fetch_transcript | 1 crédito | Obtener transcripción por URL/ID (parámetros: video_url, lang). |
search_youtube | 1 crédito | Buscar vídeos o canales (parámetros: query, type, limit). |
resolve_channel | gratis | Resolver @handle / URL / UC… ID a info de canal (parámetro: input). |
search_channel_videos | 1 crédito | Buscar vídeos en un canal (parámetros: channel, query, limit). |
get_channel_latest_videos | gratis | ~15 vídeos más recientes vía RSS (parámetro: channel). |
list_channel_videos | 1 crédito/pág. | Subidas paginadas (parámetros: channel o continuation). |
list_playlist_videos | 1 crédito/pág. | Playlist paginada (parámetros: playlist o continuation). |
transcribe_video | 5 créditos al done | Inicia una transcripción IA Whisper asíncrona para vídeos sin subtítulos. Devuelve task_id + next_poll_after_seconds (parámetros: video_url, lang). |
get_asr_task | gratis | Consulta una tarea ASR; devuelve segments en status=done (parámetro: task_id). |
list_library | gratis | Lista las transcripciones y resúmenes guardados del usuario (parámetros: favorite, q, limit, offset). |
get_library_item | gratis | Lee un elemento guardado con transcripción + resumen en línea (parámetros: id, locale). |
save_to_library | 1 cuota de token | kind=asr marca transcripción guardada; kind=summary sube el resumen generado por la IA (parámetros: video_id, kind, text, locale, model…). |
Manejo de errores
Las llamadas fallidas nunca consumen créditos. Los errores devuelven mensajes legibles que los asistentes IA interpretan de forma natural. Lista completa en Códigos de error.