SubDownload

Wrapper público de MCP para SubDownload. Obtén transcripciones de YouTube, busca videos, explora canales y listas de reproducción — datos instantáneos de YouTube para tu flujo de trabajo de IA.

GitHub

Prueba este MCPPatrocinado

Documentación

Servidor MCP de SubDownload

SubDownload expone YouTube como una fuente de datos nativa de MCP. Conéctate una vez mediante OAuth y tu agente de IA obtiene herramientas para resumir videos, obtener transcripciones completas (incluyendo videos sin subtítulos, mediante ASR de IA), buscar canales y listas de reproducción, y guardar todo en una base de conocimiento por usuario para recuperación entre sesiones.

Endpoint alojado: https://api.subdownload.com/mcp
Página principal: https://subdownload.com?utm_source=gthb_awesome_9jqqed&utm_medium=code&utm_campaign=Awesome
Documentación: https://api.subdownload.com/docs/mcp
Glama (conector): https://glama.ai/mcp/connectors/com.subdownload.api/sub-download
Glama (servidor): https://glama.ai/mcp/servers/SubDownload/subdownload-mcp

La configuración recomendada es apuntar tu cliente MCP directamente al endpoint alojado anterior y autenticarte mediante OAuth — consulta "Conexión rápida" más abajo. Este repositorio también incluye un proxy stdio ligero (Node + Docker) para entornos que prefieren un subproceso local.

Autenticación

OAuth 2.1 con registro dinámico de clientes (RFC 7591). Sin client_id ni client_secret precompartidos — tu cliente MCP se registra automáticamente en la primera conexión.

Descubrimiento (RFC 9728):

Enviar un POST a /mcp sin token devuelve 401 más un encabezado WWW-Authenticate que apunta a /.well-known/oauth-protected-resource
Ese documento apunta al servidor de autorización (https://api.subdownload.com)
El cliente MCP sigue el flujo estándar de autorizar → callback → token con PKCE

Alternativa con clave de API: cada cuenta en https://subdownload.com/account expone un token Bearer para clientes que no admiten OAuth.

Herramientas

Herramienta	Qué hace
`search_youtube`	Búsqueda por palabras clave en YouTube
`fetch_video_info`	Metadatos del video (título, canal, duración, número de vistas)
`fetch_transcript`	Transcripción completa con marcas de tiempo
`transcribe_video`	Generar una transcripción con ASR de IA para videos sin subtítulos
`get_asr_task`	Consultar un trabajo de transcripción de IA en curso
`resolve_channel`	Buscar un canal por identificador, URL o ID
`list_channel_videos`	Listar videos de un canal
`get_channel_latest_videos`	Videos más recientes de un canal
`search_channel_videos`	Buscar dentro de un solo canal
`list_playlist_videos`	Listar el contenido de una lista de reproducción
`save_to_library`	Guardar un resumen o transcripción de video en tu base de conocimiento personal
`list_library`	Explorar tu base de conocimiento guardada
`get_library_item`	Obtener un elemento guardado individual

Conexión rápida

Claude Desktop / Cursor / Windsurf / cualquier cliente MCP compatible con OAuth

{
  "mcpServers": {
    "subdownload": {
      "url": "https://api.subdownload.com/mcp"
    }
  }
}

La primera vez que lo uses, el cliente activa OAuth e inicias sesión con Google o LINUX DO. Créditos gratuitos al registrarte — no se requiere tarjeta.

Clientes con token Bearer

{
  "mcpServers": {
    "subdownload": {
      "url": "https://api.subdownload.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Obtén tu clave de API desde tu página de cuenta.

Proxy stdio local (Docker / npm)

Para clientes que prefieren transporte por subproceso, este repositorio incluye un proxy Node ligero que reenvía tools/call al endpoint alojado con tu clave de API.

# Docker
docker build -t subdownload-mcp .
docker run --rm -i -e SUBDOWNLOAD_API_KEY=YOUR_API_KEY subdownload-mcp

# Or via Node directly
npm install
SUBDOWNLOAD_API_KEY=YOUR_API_KEY npm start

Ejemplo de configuración del cliente:

{
  "mcpServers": {
    "subdownload": {
      "command": "docker",
      "args": ["run", "--rm", "-i", "-e", "SUBDOWNLOAD_API_KEY", "subdownload-mcp"],
      "env": { "SUBDOWNLOAD_API_KEY": "YOUR_API_KEY" }
    }
  }
}

Los esquemas de herramientas se declaran en línea para que la introspección (initialize, tools/list) funcione sin credenciales; tools/call requiere SUBDOWNLOAD_API_KEY.

Precios

Créditos gratuitos al registrarte. Pro: 5,000 créditos por mes. Consulta https://subdownload.com/pricing.

Soporte

Correo electrónico: contact@subdownload.com
Estado: https://subdownload.com/status

Licencia

MIT (aplica a este repositorio de documentación; el servicio SubDownload en sí es SaaS alojado — consulta https://subdownload.com/terms).