Orkas Orkas
Início Blog YouTube MCP: legendas, canais e permissões
Produto

YouTube MCP: legendas, canais e permissões

Ler uma transcrição pública, verificar um canal e carregar um vídeo exigem ferramentas e permissões diferentes.

Um servidor MCP do YouTube fornece ferramentas de assistente de IA para um fluxo de trabalho específico do YouTube. Não existe um único recurso definido por trás do nome. Um servidor de transcrição pode ler faixas de legendas públicas, mas não tem login de conta ou ferramenta de upload; um conector de conta pode utilizar OAuth e expor operações totalmente diferentes.

Para criadores e pequenas empresas, comece pelo resultado: um resumo do vídeo original, uma tabela dos envios do seu canal ou um rascunho do pacote de envio. Não escolha um servidor pelo número de ferramentas. Este guia verifica a documentação pública à data de 12 de novembro de 2026; não reivindica uma ligação de conta ativa ou teste de carregamento.

Escolha por dados e permissões

ObjetivoConexão necessáriaLimite para verificar
Resuma um vídeo públicoUm servidor com capacidade de transcriçãoDisponibilidade de legenda e cobertura de timestamp; não há garantia para todos os vídeos públicos
Leia títulos públicos, opiniões e comentáriosAcesso à API de dados do YouTube, geralmente uma chave APICota, paginação e âmbito dos dados públicos
Ler dados privados da conta ou modificar um canalOAuth com os escopos e ferramentas adequadosA conta/canal real e a ação permitida
Estude a retenção de público ou de receitaO serviço de análise relevante ou uma exportação autorizadaAs estatísticas de vídeos públicos não são privadas do YouTube Analytics

Uma opção comunitária concreta para Claude Desktop

Promethic-Labs/youtube-mcp é um servidor comunitário com extensão Desktop. A sua configuração documentada é:

  1. Reveja o repositório e descarregue YouTube.mcpb da sua versão ligada do GitHub.
  2. Abra o ficheiro com o Claude Desktop e reveja os detalhes da instalação.
  3. Para transcrições, a sua implementação não requer uma chave API. Para ferramentas públicas de pesquisa e metadados, adicione uma chave da API de dados do YouTube do projeto da Google nas definições da extensão.
  4. Inicie uma nova conversa com o conector ativado. Primeiro liste as ferramentas disponíveis e leia um vídeo público que conheça.

O mantenedor afirma que a extensão Desktop utiliza o tempo de execução da aplicação; a sua configuração de origem/CLI separada necessita do Node e de uma compilação. Não coloque o ficheiro de extensão num campo URL do conector remoto. O oficial Guia de extensão de desktop explica esta superfície de instalação local.

Este exemplo é uma forma de ler dados públicos, não uma recomendação para conceder acesso de escrita ao canal. A sua lista de ferramentas inclui transcrições, metadados de vídeo/canal, comentários e listas de reprodução; uma ferramenta pública de leitura de listas de reprodução não implica uma ferramenta de edição de listas de reprodução.

A sua primeira tarefa de investigação deve preservar as evidências

Leia estes três URLs de vídeo. Devolver uma tabela com o URL do vídeo, a data de publicação, as reivindicações principais e os carimbos de data/hora da transcrição de suporte. Marque as legendas e as lacunas em falta. Sugira três ângulos originais para o nosso próximo tutorial de produto, separando os factos originais das suas sugestões. Não publique comentários nem carregue nada.

Este é um exemplo de um pedido, não um resultado de teste. Verifique se cada carimbo de data/hora existe e se suporta a reivindicação. Um título e uma descrição não são uma transcrição; se apenas estes estivessem disponíveis, o relatório deveria dizê-lo. Se forem utilizados comentários, preserve o tamanho da amostra e o método de classificação em vez de chamar a alguns comentários principais “o que o público pensa”.

Para comparações de canais, controlo por idade. Um vídeo publicado ontem teve menos tempo para acumular visualizações do que um publicado no ano passado. Mantenha as datas de publicação, as janelas comparáveis ​​e o tempo de recuperação; não conclua que um estilo de título causou desempenho apenas a partir da contagem bruta de visualizações.

Limites de transcrição, API e quota que muitas vezes se confundem

do Google endpoint de download de legenda oficial requer permissão para editar o vídeo. Isto é diferente da recuperação de legendas do leitor público do servidor da comunidade. Este último pode falhar quando uma faixa está em falta, um vídeo é restrito ou o YouTube altera os seus endpoints internos. “Nenhuma chave API para transcrições” não é acesso oficial irrestrito às legendas.

Para a API oficial, uma chave API identifica um projeto para chamadas de dados públicos; OAuth é necessário para dados e alterações privadas do utilizador. Fazer login num canal não cria uma transcrição que não existe.

A orientação das cotas pode envelhecer rapidamente. O README da comunidade contém uma tabela de custos de pesquisa mais antiga; Atual do Google calculadora de quotas separa os buckets de pesquisa e de upload dos outros endpoints. Utilize a documentação atual da Google e da sua consola Cloud, e não a suposição geral de que “todas as chamadas partilham 10.000 unidades”. A paginação também consome chamadas; começar com uma lista limitada em vez de rastrear um canal inteiro.

Utilizar o conector do YouTube no Orkas

O catálogo de conectores do Orkas inclui o YouTube. Abra Connectors, encontre o YouTube, preencha a autorização oferecida e confirme o seu estado. Selecione-o para a tarefa, solicite as operações disponíveis e faça do primeiro pedido uma pequena leitura. As ferramentas reais dependem da autorização e do serviço ligado; a descrição do catálogo não é prova de que todas as legendas, métricas ou uploads funcionarão.

Uma progressão útil é a pesquisa → esboço → guião → rascunho do vídeo → pacote de carregamento revisto. Forneça ao escritor ou ao agente do VideoStudio a pesquisa de origem e os factos do produto aprovado. Mantenha o título final, a descrição, a miniatura e a escolha de visibilidade juntos para revisão. Este artigo não estabelece um fluxo de publicação automático ou uma ligação bem-sucedida do Orkas com o YouTube.

Para a etapa de edição, consulte As competências de edição de vídeo de Claude; para uma tarefa de produção mais ampla, consulte produção de vídeo em Orkas.

Diagnosticar a avaria antes de substituir a ferramenta

SintomaVerificação útil
Sem transcriçãoVerifique as legendas no player e qual a faixa/idioma que a ferramenta solicitou; comunicar evidências indisponíveis.
A pesquisa pública falhaVerifique a ativação da API, as principais restrições e a quota atual do projeto.
Canal erradoConfirme a conta autorizada e a identidade do canal antes de qualquer leitura ou escrita privada.
Os números discordamCompare o mesmo vídeo, definição da métrica, período e tempo de recuperação; permitir atrasos na atualização.
Ferramenta de upload ou edição em faltaInspecione a lista de ferramentas reais e os escopos OAuth do servidor. Não presuma que um conector de leitura inclui gravações.

Perguntas frequentes

Cada servidor MCP do YouTube é um servidor oficial da Google?

Não. O servidor utilizado neste guia é um projeto comunitário. A API de dados da Google é oficial; um invólucro não é automaticamente um produto da Google.

Consegue ler as legendas de todos os vídeos públicos?

Não. As legendas podem estar em falta, restritas ou inacessíveis para este método de recuperação. A API de download oficial também requer permissão de edição.

Uma chave API permite ao agente carregar vídeos?

Não. Os dados privados e as operações de modificação requerem uma autorização OAuth apropriada e uma implementação que expõe a ação.

As contagens de visualizações públicas podem substituir os dados de retenção?

Não. As estatísticas públicas não estabelecem onde os espectadores saem ou como é que um vídeo gerou receitas. Utilize análises autorizadas ou uma exportação para estas questões.

Fontes e âmbito

Servidor da comunidade e lista de ferramentas; do Google baixar legenda, autorização e cota documentos. Verificado em 12 de novembro de 2026. A configuração é documentada, não testada ao vivo com uma conta do YouTube; nenhuma recuperação ou carregamento de transcrição é apresentado como uma experiência aqui.

Reddit MCP →

Da pesquisa a um breve vídeoMantenha os URLs de origem, os carimbos de data/hora e os factos dos produtos aprovados com a tarefa.Reveja o pacote finalizado antes de publicar.
Descarregar Orkas — grátis