HubTub Pulse · conector
Pulse para assistentes de IA
Conecte o HubTub Pulse ao Claude ou a outro assistente de IA e pergunte sobre seus canais do YouTube com suas próprias palavras. O conector só lê.
O HubTub Pulse é um app gratuito de análises para criadores e agências do YouTube: cada canal que você adiciona mostra os relatórios do YouTube Analytics em uma só tela. O conector permite que o assistente de IA que você usa leia esses relatórios quando você pedir, para perguntar o que cresceu, o que caiu, quais vídeos rendem mais e de onde vêm os espectadores.
Conectar
Você precisa de:
- uma conta HubTub (grátis; entre com o Google em app.hubtub.io) com pelo menos um canal do YouTube adicionado ao Pulse;
- um assistente de IA que aceite conectores MCP remotos com login, como o Claude.
No Claude:
- Abra o HubTub Pulse no diretório de conectores do Claude e conecte. Ou abra Configurações → Conectores, escolha Adicionar conector personalizado e informe
https://app.hubtub.io/api/mcp. - O Claude abre o HubTub: entre com o Google, veja o que o assistente poderá ler e escolha Permitir acesso.
- Pergunte sobre seus canais em uma conversa, por exemplo:
- “Por que o tempo de exibição do meu canal caiu? Veja os últimos 90 dias, dia a dia.”
- “O que meus melhores vídeos dos últimos 28 dias têm em comum?”
- “Compare os últimos 12 meses dos meus canais: quais meses foram os melhores?”
- “Em que ponto os espectadores param de assistir ao meu vídeo mais visto?”
- “Quais dos meus vídeos recebem mais cliques na miniatura?”
Outros assistentes que aceitam servidores MCP remotos com login OAuth se conectam do mesmo jeito, com o mesmo endereço.
Ferramentas
As quatro ferramentas só leem. Cada número é do próprio YouTube e pertence a um canal.
list_channels
Os canais que o assistente pode ler, cada um com seus contadores públicos (inscritos, vídeos, visualizações totais) e os totais do YouTube Analytics dos últimos 7 ou 28 dias ao lado do período anterior. Parâmetro: period (7d ou 28d).
get_channel_report
O relatório de um canal: totais de 7 e 28 dias com os períodos anteriores, os últimos 90 dias dia a dia, os últimos 12 meses, o público (países, idade e gênero), as fontes de tráfego e os tipos de conteúdo de 28 dias, os 50 vídeos mais vistos de 28 dias (visualizações, tempo de exibição, receita, duração média e porcentagem assistida, curtidas, comentários, compartilhamentos, inscritos ganhos, duração e data de publicação) e a situação do canal. Parâmetros: channel e, se quiser, sections para receber só algumas partes.
get_video_retention
A retenção de público de um dos 10 vídeos mais vistos do canal em 28 dias: 100 pontos ao longo do vídeo com a proporção de espectadores (audience watch ratio) e a retenção relativa (relative retention performance) do YouTube. Sem vídeo, os vídeos que têm curva. Parâmetros: channel, video (o id, o link ou o título).
get_thumbnail_impressions
Impressões de miniaturas e a taxa de cliques do YouTube por vídeo e por dia, nos últimos 30 dias no máximo. Sem vídeo, os 50 vídeos com mais impressões. Parâmetros: channel, video.
O que ele lê
- Só os relatórios que o Pulse já guarda: o conector nunca faz pedidos ao YouTube por conta própria, e o Pulse atualiza os relatórios uma vez por dia. Os números do YouTube se consolidam com cerca de dois dias de atraso, então cada relatório informa o último dia que cobre.
- A receita estimada só aparece se o dono do canal deu ao HubTub a permissão de receita, e a situação do canal só com a permissão de auditoria.
- As curvas de retenção e as impressões de miniaturas são buscadas só para canais que um assistente lê: as curvas a partir da próxima atualização noturna, as impressões cerca de dois dias depois (dos relatórios diários do YouTube), com os 30 dias anteriores.
Ele nunca:
- muda nada no Pulse, na sua conta HubTub ou no YouTube;
- recebe sua conta Google, sua senha ou o acesso do Google aos seus canais;
- lê mais nada da sua conta HubTub, como pagamentos ou contratos.
Canais compartilhados
O assistente lê os canais que você mesmo adicionou ao Pulse. Um canal que alguém compartilha com você, diretamente ou por uma equipe do Pulse, só entra se o dono permitiu assistentes de IA: na página do canal no Pulse, ao aceitar um convite ou para todos os canais dele em uma equipe de uma vez. Ser dono de uma equipe não abre os canais de outras pessoas ao seu assistente.
Privacidade e segurança
- Você aprova cada assistente em uma página do HubTub. O login usa OAuth 2.1 com PKCE; os tokens de acesso duram uma hora e o assistente nunca vê sua senha do Google.
- Veja e desconecte seus assistentes quando quiser em Pulse → IA conectada: um assistente desconectado perde o acesso na hora, e um que não é usado por 90 dias é desconectado sozinho.
- Quando seu assistente pede um relatório, o HubTub o envia ao provedor do assistente, que o trata conforme os próprios termos. Confira nas configurações do assistente se suas conversas são usadas para treinar os modelos dele.
- Por segurança, o HubTub guarda um registro de cada conexão e de cada pedido (qual ferramenta, qual canal, quando) por 90 dias.
Mais detalhes: Política de Privacidade e Termos de Serviço (em inglês).
Solução de problemas
- “Ainda não há canais”: adicione um canal no Pulse em app.hubtub.io/dashboard/pulse ou peça ao dono de um canal compartilhado para permitir assistentes de IA.
- “Ainda não foi atualizado”: um canal recém-adicionado recebe o primeiro relatório em até um dia.
- Ainda sem curvas de retenção ou impressões: elas chegam com a próxima atualização noturna e, as impressões, cerca de dois dias depois.
- O assistente não consegue mais se conectar: remova o conector no assistente, adicione de novo e entre.
Dúvidas: creators@hubtub.io. Respondemos em até um dia útil.