YouTube Studio MCP

YouTube Studio MCP

Um servidor local de Model Context Protocol (MCP) para gerenciar canais do YouTube a partir de ferramentas de IA como Codex, Claude Desktop, Cursor e outros clientes compatíveis com MCP.

O YouTube Studio MCP permite que seu assistente inspecione o desempenho do canal, revise uploads recentes, atualize metadados de vídeos, envie miniaturas, publique comentários e leia análises por meio das suas próprias credenciais OAuth do Google.

Demonstração

User: Show my YouTube channel overview and summarize the last 10 uploaded videos.

Assistant uses:
- youtube_auth_status
- youtube_channel_overview
- youtube_list_videos

Result:
The assistant can review recent uploads, public stats, metadata, privacy status, and improvement opportunities.

Veja Demonstração para um passo a passo de configuração.

Recursos

• Leia o perfil do canal autenticado, estatísticas, branding e playlist de uploads.
• Liste vídeos recentes com metadados, status de privacidade, detalhes de conteúdo e estatísticas públicas.
• Atualize título, descrição, tags, categoria, idioma padrão e status de privacidade do vídeo.
• Envie miniaturas personalizadas a partir de arquivos de imagem locais.
• Leia relatórios do YouTube Analytics do canal e por vídeo.
• Publique e liste comentários principais dos vídeos.
• Executa localmente via stdio, sem backend hospedado.
• Usa apenas a biblioteca padrão do Python em tempo de execução.

Por que isso existe

Criadores frequentemente querem ajuda de IA com trabalhos repetitivos do YouTube Studio: auditar metadados, melhorar SEO, comparar desempenho de vídeos, preparar descrições e manter miniaturas/títulos consistentes. Este servidor MCP dá ao assistente de IA acesso controlado a esses fluxos de trabalho, mantendo as credenciais na sua própria máquina.

Requisitos

• Python 3.10 ou mais recente.
• Uma conta do Google com acesso ao canal do YouTube.
• Um projeto do Google Cloud com:
  • YouTube Data API v3 habilitada.
  • YouTube Analytics API habilitada.
• Um JSON de cliente de aplicativo desktop do Google OAuth.
• Um cliente compatível com MCP.

Início rápido

Clone o repositório:

git clone https://github.com/i1s-abhishek/youtube-studio-mcp.git
cd youtube-studio-mcp

Crie a pasta local de segredos se ela não existir:

mkdir -p secrets

Baixe o JSON do cliente de desktop OAuth do Google e salve-o como:

secrets/client_secret.json

Autentique-se com o Google:

python3 scripts/auth.py auth

Configure seu cliente MCP para executar:

python3 scripts/server.py

Veja Configuração do OAuth do Google e Configuração do Cliente MCP para etapas detalhadas.

Configuração do MCP

Exemplo de configuração stdio:

{
  "mcpServers": {
    "youtube-studio": {
      "command": "python3",
      "args": ["./scripts/server.py"],
      "cwd": "/absolute/path/to/youtube-studio-mcp",
      "env": {
        "YOUTUBE_CLIENT_SECRETS": "./secrets/client_secret.json",
        "YOUTUBE_TOKEN_FILE": "./secrets/token.json"
      }
    }
  }
}

Substitua /absolute/path/to/youtube-studio-mcp pelo caminho onde você clonou este repositório.

Ferramentas disponíveis

Veja Ferramentas para a lista completa de ferramentas.

As ferramentas principais incluem:

• youtube_channel_overview
• youtube_list_videos
• youtube_get_video
• youtube_update_video
• youtube_upload_thumbnail
• youtube_channel_analytics
• youtube_video_analytics
• youtube_post_comment
• youtube_list_comments

Exemplos de prompts

Show my YouTube channel overview and summarize the last 10 uploads.

Review my last 28 days of analytics and suggest what I should improve next.

Update this video's title, description, tags, and language.

Upload this local thumbnail image to video VIDEO_ID.

Escopos do OAuth

Este servidor solicita:

• https://www.googleapis.com/auth/youtube
• https://www.googleapis.com/auth/youtube.force-ssl
• https://www.googleapis.com/auth/youtube.readonly
• https://www.googleapis.com/auth/yt-analytics.readonly

Esses escopos são amplos porque o servidor suporta ações de leitura e escrita no YouTube Studio. Execute este servidor apenas em máquinas em que você confia.

Notas de segurança

• Não faça commit de secrets/client_secret.json.
• Não faça commit de secrets/token.json.
• Revise as chamadas de ferramentas antes de permitir atualizações de metadados ou comentários.
• Mantenha um backup de títulos, descrições e tags importantes antes de atualizações em massa.

Verificação

Antes da publicação, este repositório foi verificado para confirmar que apenas secrets/.gitkeep é rastreado em secrets/; arquivos OAuth reais, como secrets/client_secret.json e secrets/token.json, são ignorados pelo git.

Tópicos do repositório

Tópicos sugeridos do GitHub:

mcp, model-context-protocol, youtube, youtube-api, youtube-analytics, youtube-studio, ai-tools, creator-tools, python

Publicação

Os mantenedores podem publicar ou atualizar o repositório do GitHub com:

scripts/publish_github.sh i1s-abhishek youtube-studio-mcp

O script cria um repositório público do GitHub se necessário, envia main e aplica tópicos de descoberta relevantes.

Compartilhamento

Use Launch Copy ao enviar este projeto para diretórios de MCP ou publicá-lo em plataformas sociais.

Contribuição

Contribuições são bem-vindas. Veja CONTRIBUTING.md.

Segurança

Leia SECURITY.md antes de usar isto com um canal de produção.

Licença

MIT. Veja LICENSE.