YouTube

Servidor MCP de YouTube

Un servidor de Protocolo de Contexto del Modelo (MCP) que permite a Claude Desktop (y otras aplicaciones) interactuar con YouTube, proporcionando funcionalidad de búsqueda y transcripciones.

Características

• Buscar videos de YouTube: Busca videos con contadores de resultados personalizables
• Obtener transcripciones de videos: Extrae transcripciones de videos de YouTube usando URLs o IDs de video
• Integración lista para IA: Se integra perfectamente con Claude Desktop para el análisis de contenido de YouTube

Herramientas disponibles

1. search_youtube_videos

• Propósito: Busca videos en YouTube según una consulta
• Parámetros:
  • search_term (cadena): La consulta de búsqueda
  • num_videos (entero): Número de videos a devolver (predeterminado: 5, máximo: 50)
• Devuelve: Lista de información de videos, incluidos títulos, canales, descripciones, URLs y metadatos

2. get_youtube_transcript

• Propósito: Extrae la transcripción de un video de YouTube
• Parámetros:
  • video_url_or_title (cadena): URL del video de YouTube o ID del video
• Devuelve: Transcripción completa con marcas de tiempo y metadatos

3. analyze_youtube_content_prompt

• Propósito: Plantilla de prompt de IA para el análisis integral de contenido de YouTube
• Parámetros:
  • search_term (cadena): Tema a analizar
  • num_videos (entero): Número de videos a analizar

Configuración

1. Instalar dependencias

# Create virtual environment
python3 -m venv .venv

# Activate virtual environment
source .venv/bin/activate

# Install dependencies
pip install -r requirements.txt

2. Obtener la clave de API de YouTube

1. Ve a Google Cloud Console
2. Crea un nuevo proyecto o selecciona uno existente
3. Habilita la API de Datos de YouTube v3
4. Crea credenciales (clave de API)
5. Copia la clave de API

3. Configurar el entorno

# Copy example environment file
cp .env.example .env

# Edit .env and add your YouTube API key
YOUTUBE_API_KEY=your_actual_api_key_here

4. Probar el servidor

# Activate virtual environment
source .venv/bin/activate

# Run the server
python youtube_server.py

Integración con Claude Desktop

Agrega esta configuración a la configuración de MCP de tu Claude Desktop:

{
  "mcpServers": {
        "youtube": {
            "command": "local/path/to/uv",
            "args": [
                "run",
                "--directory",
                "/Path/to/your/project",
                "youtube_server.py"
            ],
            "env": {
                "YOUTUBE_API_KEY": "your_key_here"
            }
  }
}

Ejemplos de uso

Una vez integrado con Claude Desktop, puedes:

• "Buscar videos sobre aprendizaje automático y obtener sus transcripciones"
• "Encontrar los videos más recientes sobre cambio climático y analizar su contenido"
• "Obtener la transcripción de este video de YouTube: https://www.youtube.com/watch?v=..."
• "Comparar diferentes perspectivas sobre la ética de la IA a partir de videos de YouTube"

Manejo de errores

• Clave de API faltante: El servidor mostrará una advertencia y la funcionalidad de búsqueda será limitada
• IDs de video inválidos: Mensajes de error claros para solicitudes de transcripción
• Límites de API: Respeta las cuotas y los límites de velocidad de la API de YouTube
• Transcripciones faltantes: Maneja videos sin subtítulos disponibles

Dependencias

• fastmcp: Marco de trabajo del servidor MCP
• google-api-python-client: Acceso a la API de Datos de YouTube
• youtube-transcript-api: Extracción de transcripciones

Licencia

Este proyecto es de código abierto y está disponible bajo términos de licencia estándar.