YouTube MCP

Conecta asistentes de IA a YouTube: búsquedas, transcripciones, metadatos y más.

GitHub

Prueba este MCPPatrocinado

Documentación

YouTube MCP

Conecta asistentes de IA a YouTube: búsquedas, transcripciones, metadatos y más.

Downloads

¿Qué puede hacer?

Una vez conectado, tu IA puede:

Extraer transcripciones de video limpias y palabra por palabra. No se requieren credenciales.
Buscar en YouTube por palabra clave, rango de fechas, duración, calidad y región.
Obtener videos en tendencia para cualquier país y categoría.
Recuperar estadísticas de video, metadatos, comentarios, subtítulos y detalles del canal.
Buscar canales por @handle (p. ej. @MrBeast).
Acceder a tus propias suscripciones, miembros y niveles de membresía mediante OAuth.

Primeros pasos

El servidor admite tres niveles de acceso. Elige el que se adapte a tu caso de uso.

Modo invitado (sin configuración)

Funciona de inmediato. La herramienta get_video_transcript utiliza yt-dlp para extraer transcripciones sin necesidad de credenciales de API.

{
  "mcpServers": {
    "youtube-mcp": {
      "command": "npx",
      "args": ["-y", "@mrsknetwork/ytmcp@latest"]
    }
  }
}

Clave de API (recomendado)

Desbloquea todas las herramientas de datos públicos. Ideal para búsquedas, metadatos, comentarios, videos en tendencia y transcripciones.

1. Obtén una clave de API de Google

Abre la Consola de Google Cloud.
Habilita YouTube Data API v3 para tu proyecto.
Ve a Credenciales y crea una Clave de API.

2. Añádela a la configuración de tu cliente MCP o al archivo .env

Pasa GOOGLE_API_KEY mediante env en la configuración de tu cliente MCP, o coloca GOOGLE_API_KEY=YOUR_KEY dentro de un archivo .env en el directorio del proyecto.

{
  "mcpServers": {
    "youtube-mcp": {
      "command": "npx",
      "args": ["-y", "@mrsknetwork/ytmcp@latest"],
      "env": {
        "GOOGLE_API_KEY": "YOUR_GOOGLE_API_KEY"
      }
    }
  }
}

OAuth 2.0

Requerido para suscripciones privadas, membresías y actividad de la cuenta.

1. Crea un cliente OAuth 2.0

Abre la Consola de Google Cloud.
Habilita YouTube Data API v3 para tu proyecto.
Ve a Credenciales > Crear credenciales > ID de cliente OAuth 2.0.
Establece el tipo de aplicación en Aplicación web.
Añade esta URI de redirección exacta: http://localhost:31415/oauth2callback.
Ve a Pantalla de consentimiento de OAuth > Usuarios de prueba y añade tu dirección de Gmail.

2. Añade a la configuración de tu cliente MCP

Las credenciales se pasan de forma segura mediante variables de entorno en la configuración de MCP. Nunca se almacenan en archivos.

{
  "mcpServers": {
    "youtube-mcp": {
      "command": "npx",
      "args": ["-y", "@mrsknetwork/ytmcp@latest"],
      "env": {
        "GOOGLE_CLIENT_ID": "your-client-id.apps.googleusercontent.com",
        "GOOGLE_CLIENT_SECRET": "your-client-secret"
      }
    }
  }
}

3. Inicio de sesión por primera vez

En tu primera llamada a una herramienta, la IA compartirá un enlace de inicio de sesión. Haz clic en él, autoriza la aplicación en tu navegador y luego dile a la IA que has terminado. Tu sesión se guarda. No necesitarás iniciar sesión de nuevo a menos que revoques el acceso.

4. Cerrar sesión

Pídele a tu IA que llame a revoke_oauth_token para cerrar sesión y eliminar tus credenciales almacenadas en cualquier momento.

Herramientas disponibles

Herramienta	Autenticación	Descripción
`get_video_transcript`	Ninguna	Descarga una transcripción hablada completa usando yt-dlp. Especifica `language_code` (p. ej. `en`, `es`) y si prefieres subtítulos manuales o generados automáticamente. Devuelve metadatos de origen con el texto.
`search_content`	Clave de API	Busca en YouTube videos, canales o listas de reproducción. Filtra por `order`, `published_after`, `published_before`, `video_duration`, `video_definition` y `region_code`. Admite paginación.
`get_video_metadata`	Clave de API	Obtiene título, descripción, etiquetas, duración y estadísticas (vistas, me gusta, comentarios) de uno o más videos por ID.
`get_channel_metadata`	Clave de API	Obtiene el perfil del canal, número de suscriptores, número de videos e ID de la lista de reproducción de subidas. Acepta un ID de canal o `@handle`.
`list_trending_videos`	Clave de API	Obtiene los videos más populares en YouTube para un `region_code` determinado y un `category_id` opcional. Admite paginación.
`list_playlists`	Clave de API	Lista las listas de reproducción de un canal, u obtiene listas específicas por ID. Devuelve título, descripción y número de elementos.
`list_playlist_items`	Clave de API	Lista todos los videos dentro de una lista de reproducción en orden. Devuelve título, posición e ID de video para cada entrada.
`list_video_comments`	Clave de API	Obtiene los hilos de comentarios principales de un video o canal. Filtra por palabra clave con `search_terms`. Admite paginación.
`list_comment_replies`	Clave de API	Obtiene las respuestas a un hilo de comentarios específico por `parent_comment_id`. Admite paginación.
`list_video_captions`	Clave de API	Lista las pistas de subtítulos disponibles para un video, incluidos el código de idioma y el tipo (manual o generado automáticamente).
`list_video_categories`	Clave de API	Lista los nombres e IDs de las categorías de video de YouTube para una región determinada. Usa los IDs con `search_content` o `list_trending_videos`.
`list_channel_activities`	Clave de API	Obtiene el feed de actividad reciente de un canal, incluidas subidas y adiciones a listas de reproducción.
`list_channel_sections`	Clave de API	Lista las secciones de estantería que se muestran en la página de un canal, en orden.
`list_supported_languages`	Clave de API	Lista todos los idiomas compatibles con YouTube, con códigos de idioma y nombres localizados.
`list_supported_regions`	Clave de API	Lista todas las regiones compatibles con YouTube, con códigos y nombres de región.
`list_subscriptions`	Clave de API / OAuth	Lista las suscripciones públicas de un canal por `channel_id` (Clave de API), o tus propias suscripciones con `mine=true` (OAuth).
`list_channel_members`	OAuth	Lista los miembros de pago actuales de tu canal. Requiere un programa de membresías activo.
`list_membership_levels`	OAuth	Lista los nombres y niveles de los niveles de membresía configurados para tu canal.
`revoke_oauth_token`	OAuth	Cierra sesión y elimina permanentemente tus credenciales de Google almacenadas del servidor.

Compilación desde el código fuente

Instrucciones para ejecutar el servidor localmente.

git clone https://github.com/mrsknetwork/ytmcp.git
cd ytmcp
npm install
npm run build
cp .env.example .env # Set GOOGLE_API_KEY inside .env
node build/server/index.js

Licencia

Licenciado bajo la Licencia MIT.