YouTube Studio & Channel Analytics MCP Server

Un servidor de Model Context Protocol (MCP) de nivel de producción para YouTube Studio e inteligencia de canal

Potencia a los asistentes de IA (Claude, Cursor, Antigravity, etc.) para analizar tu canal de YouTube, realizar un seguimiento de las métricas de los vídeos, profundizar en los análisis de YouTube Studio, descubrir las fuentes de tráfico de la audiencia y analizar el sentimiento de la comunidad, todo configurado mediante .env.

🚀 Características y suite de herramientas MCP

YouTube Studio MCP ofrece 8 herramientas especializadas:

Related MCP server: YouTube MCP Server

⚙️ Configuración del entorno (.env)

Todas las credenciales y ajustes se leen directamente de .env:

# Google OAuth 2.0 Credentials (from Google Cloud Console)
YOUTUBE_CLIENT_ID=your_client_id.apps.googleusercontent.com
YOUTUBE_CLIENT_SECRET=your_client_secret

# OAuth Refresh Token (written automatically by run_auth.py)
YOUTUBE_REFRESH_TOKEN=

🛠️ Guía de configuración paso a paso

1. Clona e instala las dependencias con uv

git clone https://github.com/Dhananjayrbiraris/youtube-mcp.git
cd youtube-mcp

uv venv
uv pip install -e .

2. Configura el proyecto de Google Cloud (una sola vez)

1. Abre Google Cloud Console.

2. Crea un nuevo proyecto (por ejemplo, YouTube-Studio-MCP).

3. En APIs y servicios > Biblioteca, habilita:

   • YouTube Data API v3

   • YouTube Analytics API

4. En la pantalla de consentimiento de OAuth:

   • Tipo de usuario: Externo -> completa el nombre de la aplicación y tu correo electrónico.

   • En Usuarios de prueba, añade tu dirección de correo electrónico de Google.

5. En Credenciales:

   • Haz clic en Crear credenciales > ID de cliente de OAuth.

   • Tipo de aplicación: Aplicación de escritorio.

   • Copia el ID de cliente y el secreto del cliente.

6. Pégalos en .env:

   YOUTUBE_CLIENT_ID=123456789-xxxx.apps.googleusercontent.com
   YOUTUBE_CLIENT_SECRET=GOCSPX-xxxx

3. Ejecuta el autenticador de 1 clic

uv run run_auth.py

Esto abre tu navegador para un inicio de sesión de Google OAuth con un solo clic. Escribe automáticamente el YOUTUBE_REFRESH_TOKEN directamente en tu archivo .env.

4. Conecta con tu cliente de IA

Claude Desktop

Añade a tu claude_desktop_config.json:

{
  "mcpServers": {
    "youtube-studio": {
      "command": "uv",
      "args": [
        "--directory",
        "/absolute/path/to/youtube-mcp",
        "run",
        "youtube-studio-mcp"
      ]
    }
  }
}

💡 Ejemplos de indicaciones para IA

• "Dame una visión general del rendimiento de mi canal de YouTube durante los últimos 28 días."

• "¿De dónde proviene la mayor parte de mi tráfico (búsqueda, vídeos sugeridos o funciones de exploración)?"

• "¿Cuál de mis vídeos generó más suscriptores este mes?"

• "Resume los temas y preguntas comunes de los comentarios de mi último vídeo."

• "Muéstrame el desglose de mi audiencia por grupo de edad y país."

🧪 Pruebas

Ejecuta la suite de pruebas:

pytest

📄 Licencia

Este proyecto está licenciado bajo la Licencia MIT.