YouTube Data

YouTube MCP Server

Una implementación de servidor del Model Context Protocol (MCP) que utiliza la API de datos de YouTube. Permite que los modelos de lenguaje de IA interactúen con el contenido de YouTube a través de una interfaz estandarizada.

Características principales

Información de video

• Obtener información detallada del video (título, descripción, duración, estadísticas)
• Buscar videos por palabras clave
• Obtener videos relacionados basados en un video específico
• Calcular y analizar las tasas de interacción de los videos

Gestión de transcripciones/subtítulos

• Obtener subtítulos de video con soporte multilingüe
• Especificar preferencias de idioma para las transcripciones
• Acceder a subtítulos con marca de tiempo para una referencia precisa del contenido

Análisis de canales

• Ver estadísticas detalladas del canal (suscriptores, vistas, número de videos)
• Obtener los videos con mejor rendimiento de un canal
• Analizar el crecimiento del canal y las métricas de interacción

Análisis de tendencias

• Ver videos en tendencia por región y categoría
• Comparar métricas de rendimiento entre múltiples videos
• Descubrir contenido popular en categorías específicas

Herramientas disponibles

El servidor proporciona las siguientes herramientas MCP:

Nombre de la herramienta	Descripción	Parámetros requeridos
getVideoDetails	Obtener información detallada sobre múltiples videos de YouTube, incluidos metadatos, estadísticas y detalles del contenido	videoIds (array)
searchVideos	Buscar videos según una cadena de consulta	query, maxResults (opcional)
getTranscripts	Obtener transcripciones de múltiples videos	videoIds (array), lang (opcional)
getRelatedVideos	Obtener videos relacionados con un video específico según el algoritmo de recomendación de YouTube	videoId, maxResults (opcional)
getChannelStatistics	Obtener métricas detalladas de múltiples canales, incluidos el número de suscriptores, vistas y videos	channelIds (array)
getChannelTopVideos	Obtener los videos más vistos de un canal específico	channelId, maxResults (opcional)
getVideoEngagementRatio	Calcular métricas de interacción para múltiples videos (vistas, me gusta, comentarios y tasa de interacción)	videoIds (array)
getTrendingVideos	Obtener videos populares actualmente por región y categoría	regionCode (opcional), categoryId (opcional), maxResults (opcional)
compareVideos	Comparar estadísticas entre múltiples videos	videoIds (array)

Instalación

Instalación automática mediante Smithery

Instale automáticamente YouTube MCP Server para Claude Desktop mediante Smithery:

npx -y @smithery/cli install @icraft2170/youtube-data-mcp-server --client claude

Instalación manual

# Install from npm
npm install youtube-data-mcp-server

# Or clone repository
git clone https://github.com/icraft2170/youtube-data-mcp-server.git
cd youtube-data-mcp-server
npm install

Configuración del entorno

Establezca las siguientes variables de entorno:

• YOUTUBE_API_KEY: Clave de la API de datos de YouTube (requerida)
• YOUTUBE_TRANSCRIPT_LANG: Idioma de subtítulos predeterminado (opcional, predeterminado: 'ko')

Configuración del cliente MCP

Agregue lo siguiente a su archivo de configuración de Claude Desktop:

{
  "mcpServers": {
    "youtube": {
      "command": "npx",
      "args": ["-y", "youtube-data-mcp-server"],
      "env": {
        "YOUTUBE_API_KEY": "YOUR_API_KEY_HERE",
        "YOUTUBE_TRANSCRIPT_LANG": "ko"
      }
    }
  }
}

Configuración de la API de YouTube

1. Acceda a Google Cloud Console
2. Cree un nuevo proyecto o seleccione uno existente
3. Habilite la API de datos de YouTube v3
4. Cree credenciales de API (clave de API)
5. Use la clave de API generada en su configuración de entorno

Desarrollo

# Install dependencies
npm install

# Run in development mode
npm run dev

# Build
npm run build

Configuración de red

El servidor expone los siguientes puertos para la comunicación:

• HTTP: 3000
• gRPC: 3001

Requisitos del sistema

• Node.js 18.0.0 o superior

Consideraciones de seguridad

• Mantenga siempre su clave de API segura y nunca la envíe a sistemas de control de versiones
• Administre su clave de API mediante variables de entorno o archivos de configuración
• Establezca límites de uso para su clave de API para evitar usos no autorizados

Licencia

Este proyecto está licenciado bajo la Licencia MIT. Consulte el archivo LICENSE para obtener más detalles.