claude-plugins/marketing/skills/youtube/SKILL.md

name, description, author, version, quality_score, user_invocable, desk_task, allowed-tools

name	description	author	version	quality_score	user_invocable	desk_task	allowed-tools
youtube	YouTube channel management and optimization. Content strategy, SEO, thumbnails, and analytics. Use when user mentions "youtube", "canal youtube", "youtube seo", "video optimization", "youtube analytics".	Descomplicar® Crescimento Digital	3.0.0	75	true	1490	Edit, Task

/youtube - YouTube Complete Toolkit

Comando para extrair transcrições, metadados E estratégia de crescimento de canais YouTube. Best practices 2026.

---

🎯 Arquitectura v3.0.0

Funcionalidade	Método	Estado	Notas
Pesquisa	MCP youtube-research	✅ OK	Filtros avançados, região, legendas
Estatísticas	MCP youtube-research	✅ OK	Vídeos, canais, comparações
Comentários	MCP youtube-research	✅ OK	Com replies e likes
Trending	MCP youtube-research	✅ OK	Por região e categoria
Transcrições	Script local	✅ OK	youtube_extractor.py (MCP não funciona)
Upload	MCP youtube-uploader	⚠️ Requer Auth	OAuth necessário
Estratégia Crescimento	🆕 Skill internal	✅ OK	Análise algoritmo, optimizações

---

📊 Algoritmo YouTube 2026 - Como Funciona

Watch Time é Rei

Métrica	Peso	Impacto	Benchmark
Average View Duration	40%	Muito Alto	> 50% duração vídeo
CTR (Click-Through Rate)	30%	Alto	> 8% (home/search)
Engagement (likes, comments, shares)	20%	Médio-Alto	> 5% views
Session Time	10%	Médio	Manter utilizador no YouTube

Factores Ranking Pesquisa

1. Relevância (title, description, tags match query)
2. Engagement (CTR, tempo visualização, likes)
3. Qualidade (histórico canal, consistência)
4. Frescura (vídeos novos boost temporário 48h)

Factores Recomendações (Home/Sidebar)

1. Histórico utilizador (vídeos similares assistidos)
2. Session time (vídeos que mantêm utilizador na plataforma)
3. CTR + Retention (thumbnail + primeiros 30 segundos)
4. Canal performance (consistência uploads, engagement médio)

---

🚀 Estratégia Crescimento Canal 2026

Fase 1: Fundação (0-1K Subscribers)

Objectivo: Encontrar nicho e provar conceito

**Conteúdo:**
- 10-15 vídeos qualidade antes de esperar crescimento
- Foco: Resolver problemas específicos (long-tail keywords)
- Duração: 8-12 minutos (sweet spot retention)
- Frequência: 1-2x/semana consistente

**Optimizações:**
- Thumbnails contrastantes, texto legível mobile
- Títulos: Keyword + benefício (< 60 chars)
- Primeiros 30 segundos: Hook forte
- Descrição: 200+ palavras, keyword-rich
- Tags: 10-15 (variações keyword)

**Promoção:**
- Reddit, Quora, fóruns nicho
- Colaborar com canais similares (500-5K subs)
- Partilhar em grupos Facebook/LinkedIn

KPIs:

• AVD (Average View Duration) > 45%
• CTR > 5%
• 50-100 subs/mês

Fase 2: Aceleração (1K-10K Subscribers)

Objectivo: Escalar o que funciona, construir audiência

**Conteúdo:**
- Analisar top 10 vídeos: Replicar formato/topic
- Criar série (playlist temática, aumenta session time)
- Mix: 70% comprovado, 30% experimental
- Duração: 10-15 minutos (mais anúncios, melhor revenue)

**Optimizações YouTube Studio:**
- End screens (25% boost em views)
- Cards (links vídeos relacionados)
- Playlists organizadas (aumenta binge-watching)
- Community tab (engagement entre vídeos)
- Shorts (teasers vídeos longos, crescimento rápido)

**Promoção:**
- Email list (converter viewers em subscribers)
- Cross-promote Instagram/TikTok
- Guest appearances podcasts

KPIs:

• AVD > 50%
• CTR > 8%
• 200-500 subs/mês
• 10K+ views/mês

Fase 3: Escala (10K-100K+ Subscribers)

Objectivo: Monetizar e profissionalizar

**Conteúdo:**
- 2-3x/semana upload schedule
- Vídeos mais longos (15-20 min) se retention mantém
- Invest em produção (lighting, áudio, edição)
- Série flagship (identidade canal)

**Monetização:**
- AdSense (4K watch hours + 1K subs)
- Afiliados/Sponsors (produtos relevantes)
- Produtos próprios (cursos, consultoria)
- Memberships/Super Chat

**Team:**
- Editor vídeo (libertar tempo para conteúdo)
- Thumbnail designer (crítico para CTR)
- Community manager (responder comentários)

KPIs:

• AVD > 55%
• CTR > 10%
• 1K+ subs/mês
• 100K+ views/mês
• RPM (Revenue Per Mille) > €3

---

🎨 Optimização Títulos e Thumbnails

Títulos que Convertem (CTR > 10%)

Fórmulas Testadas:

Padrão	Exemplo	CTR Médio
Número + Benefício	"7 Truques Para Duplicar Views"	9-12%
Como Fazer	"Como Crescer no YouTube em 2026"	8-11%
Erro Comum	"NUNCA Faças Isto no YouTube"	10-13%
Resultado Surpreendente	"Ganhei 10K Subs em 30 Dias (Como)"	11-14%
Desafio/Experiência	"30 Dias Publicando TODOS os Dias"	9-12%

Regras:

• < 60 caracteres (não corta em mobile)
• Keyword primeiros 5 palavras (SEO YouTube)
• Maiúsculas estratégicas (1-2 palavras, não spam)
• Números específicos (não "muitos", mas "127")
• Trigger curiosidade (sem clickbait excessivo)

Thumbnails que Destacam (CTR > 10%)

**Elementos Críticos:**

1. **Rosto/Expressão** (70% thumbnails top performers)
   - Close-up rosto
   - Expressão exagerada (surpresa, choque, alegria)
   - Contraste alto (destaca em feed)

2. **Texto Legível** (3-5 palavras MAX)
   - Font grande (Montserrat Bold, Impact)
   - Contraste cores (amarelo/preto, branco/vermelho)
   - Legível em mobile (90% views)

3. **Cores Contrastantes**
   - Amarelo, laranja, vermelho (destacam)
   - Evitar verde, azul (funde com YouTube UI)
   - Background simples (não cluttered)

4. **Regra dos Terços**
   - Rosto/objecto principal num terço
   - Espaço negativo equilibrado
   - Não centrar tudo

Ferramentas:

• Canva (templates YouTube)
• Photopea (Photoshop online gratuito)
• Remove.bg (remover backgrounds)

A/B Testing:

• YouTube permite trocar thumbnail DEPOIS upload
• Testar 2-3 variações primeiras 48h
• Manter versão com melhor CTR

---

📝 Optimização SEO YouTube

Título (Peso: 40%)

[Keyword Principal] + [Benefício/Curiosidade] + [Trigger]

✅ "Como Ganhar Dinheiro no YouTube 2026 (€5K/Mês)"
✅ "Photoshop para Iniciantes - Tutorial Completo PT"
✅ "10 Erros FATAIS em Marketing Digital (Evita #7)"

❌ "Vlog #247" (sem keyword)
❌ "INCRÍVEL!!! TENS QUE VER ISTO!!!" (clickbait spam)

Descrição (Peso: 30%)

**Estrutura Optimizada:**

[Primeira linha: Resumo + keyword - aparece em pesquisa]
Aprende como ganhar dinheiro no YouTube em 2026. Estratégia completa para iniciantes.

[Timestamp links - aumenta retention]
0:00 Introdução
2:15 Passo 1: Nicho
5:30 Passo 2: Conteúdo
10:45 Passo 3: Monetização

[Descrição expandida - min 200 palavras, keyword 3-5x]
Neste vídeo, mostro exactamente como ganhar dinheiro no YouTube...

[CTAs]
🔔 Subscreve: [URL canal]
📧 Newsletter: [URL]
💬 Discord: [URL]

[Links relacionados]
👉 Vídeo anterior: [URL]
👉 Playlist: [URL]

[Hashtags - 3-5 relevantes]
#YouTubeMarketing #GanharDinheiro #YouTubePortugues

[Contacto/Social]
Instagram: @handle
Email: email@domain.pt

Tags (Peso: 10%)

**Estratégia Tags:**

1. **Exact keyword** (1-2)
   - "ganhar dinheiro youtube"
   - "youtube portugal"

2. **Variações** (3-5)
   - "como ganhar dinheiro no youtube"
   - "monetizar canal youtube"
   - "youtube para iniciantes"

3. **Long-tail** (3-5)
   - "ganhar dinheiro youtube 2026"
   - "monetizar youtube portugal"

4. **Genéricas nicho** (2-3)
   - "marketing digital"
   - "empreendedorismo online"

**Total: 10-15 tags**

---

🎬 Hook Perfeito (Primeiros 30 Segundos)

80% viewers decide ficar ou sair nos primeiros 30 segundos.

Framework Hook

[0-5s] **Pattern Interrupt**
Imagem/som surpreendente, statement bold
"Ganhei €50K com este canal em 90 dias."

[5-15s] **Promessa + Preview**
O que vão aprender + teaser resultado
"Neste vídeo, mostro exactamente o método passo a passo. Incluindo screenshots das minhas receitas."

[15-30s] **Credibilidade + CTA Suave**
Porque confiar + pedir subscrição
"Faço YouTube há 5 anos, 3 canais crescidos. Se queres crescer também, subscreve para não perder novos vídeos."

[30s+] **Conteúdo prometido**
Entregar valor IMEDIATAMENTE

Anti-Patterns:

• ❌ Logo intro longa (> 5s) - viewers saem
• ❌ "Olá pessoal, tudo bem?" - tempo perdido
• ❌ Pedir subscrição ANTES de dar valor
• ❌ Música intro sem valor

---

📊 Métricas Chave (YouTube Studio)

Dashboard Essenciais

Métrica	Fórmula	Benchmark	Acção se < Benchmark
AVD	Tempo médio visualização / Duração vídeo	> 50%	Melhorar hook, cortar partes fracas
CTR	Cliques / Impressões	> 8%	Testar thumbnail/título
Impressions	Vezes thumbnail mostrado	Subir mês a mês	SEO, consistência uploads
Subscribers Rate	Novos subs / Views	> 1%	CTAs mais claros, conteúdo mais valioso
Likes/Views	Likes / Views	> 5%	Engagement, pedir likes (com razão)
Comments/Views	Comments / Views	> 0.5%	Perguntas no vídeo, responder comments

Análise Audiência

**Demografia:** Ajustar conteúdo para maioria
- Idade: 25-34 (60%) → Tom informal, memes
- Género: 70% masculino → Topics, exemplos
- Geografia: 80% Portugal → PT-PT, contextos locais

**Quando Assistem:** Optimizar schedule uploads
- Pico: Terça/Quinta 19h-21h → Upload 18h

**Dispositivos:** 85% mobile → Testar tudo em telemóvel

---

🛠️ MCP youtube-research (8/12 funcionais)

Ferramentas Funcionais

Ferramenta	Função	Parâmetros
search-videos	Pesquisa avançada	query*, maxResults, regionCode, order, videoDuration
get-video-stats	Estatísticas vídeo	videoId*
get-video-comments	Comentários + replies	videoId*, maxResults, order, includeReplies
get-channel-stats	Estatísticas canal	channelId*
analyze-channel-videos	Análise performance	channelId*, maxResults, sortBy
get-trending-videos	Trending por região	regionCode, maxResults, categoryId
get-video-categories	Categorias disponíveis	regionCode
compare-videos	Comparar múltiplos	videoIds[]* (2-10 vídeos)

Ferramentas com Problemas (NÃO USAR)

Ferramenta	Estado	Problema
get-video-transcript	❌	Não devolve output
enhanced-transcript	❌	Transcrição vazia
get-key-moments	❌	Depende de transcrição
get-segmented-transcript	❌	Depende de transcrição

[!warning] Transcrições via MCP As ferramentas de transcrição do MCP youtube-research NÃO FUNCIONAM. Usar sempre o script local youtube_extractor.py para transcrições.

---

📜 Transcrições (Script Local)

As transcrições via MCP não funcionam. Usar sempre o script local.

Localização

/media/ealmeida/Dados/Dev/ClaudeDev/Claude-Scripts/youtube-transcript/youtube_extractor.py

Uso Directo

cd /media/ealmeida/Dados/Dev/ClaudeDev/Claude-Scripts/youtube-transcript/
source venv/bin/activate
python youtube_extractor.py "https://youtube.com/watch?v=xxx"

Via Skill

/youtube https://youtube.com/watch?v=xxx

---

📤 Upload de Vídeos (MCP youtube-uploader)

Configuração Inicial (uma vez)

1. mcp__youtube-uploader__authenticate
   → Devolve URL OAuth2

2. Abrir URL no browser → Login Google → Autorizar

3. Copiar código do redirect (?code=xxx)

4. mcp__youtube-uploader__accesstoken
   → Parâmetro: code (só o código, não URL completo)

5. Guardar channel_id devolvido

Upload Completo

mcp__youtube-uploader__upload_video({
  file_path: "/caminho/completo/video.mp4",
  channel_id: "UCxxx...",
  title: "Título Optimizado SEO (< 100 chars)",
  description: "Descrição completa com timestamps, links, keywords (min 200 palavras)",
  tags: "tag1, tag2, tag3, tag4, tag5",
  status: "public", // ou "private", "unlisted"
  category_id: "22", // 22 = People & Blogs, 28 = Science & Technology
  publish_at: "2026-02-05T18:00:00Z" // Opcional, agendamento
})

Categorias Principais

ID	Nome	Uso
1	Film & Animation	Vídeos cinematográficos
10	Music	Música, covers
20	Gaming	Gameplays, reviews jogos
22	People & Blogs	Vlogs, lifestyle
24	Entertainment	Entretenimento geral
25	News & Politics	Notícias, análise política
27	Education	Tutoriais, cursos
28	Science & Technology	Tech, ciência

---

💡 Casos de Uso

1. Análise Concorrência

// Pesquisar top vídeos nicho
mcp__youtube-research__search-videos({
  query: "marketing digital portugal",
  maxResults: 50,
  order: "viewCount",
  regionCode: "PT",
  videoDuration: "medium" // 4-20 min
})

// Analisar canal concorrente
mcp__youtube-research__analyze-channel-videos({
  channelId: "UCxxx...",
  maxResults: 50,
  sortBy: "viewCount"
})

// Insights:
// - Topics mais populares
// - Duração média top performers
// - Frequência uploads
// - Engagement médio

2. Keyword Research

// Pesquisar variações keyword
mcp__youtube-research__search-videos({
  query: "ganhar dinheiro online",
  maxResults: 100,
  order: "relevance"
})

// Analisar:
// - Títulos mais usados
// - CTR estimado (views / idade vídeo)
// - Competição (quantos vídeos topic)

3. Trending Topics Portugal

mcp__youtube-research__get-trending-videos({
  regionCode: "PT",
  maxResults: 50,
  categoryId: "22" // People & Blogs
})

// Criar conteúdo relacionado com trending

---

📚 Datasets Dify (Consulta Obrigatória)

Dataset	ID	Prioridade	Uso
Youtube Marketing	baa1b3e6-ebf0-4413-84b2-63d1164867ea	1	Crescimento canal, algoritmo
Marketing Redes Sociais	66117552-348f-455d-9aca-2da722567693	2	Estratégia vídeo, engagement
Marketing Digital	c1ec779f-4cb1-4ecf-ba11-6b39b93d4e24	3	Estratégia geral, métricas

Como Consultar

// Estratégias crescimento YouTube
mcp__notebooklm__notebook_query, mcp__dify-kb__dify_kb_retrieve_segments({
  dataset_id: "baa1b3e6-ebf0-4413-84b2-63d1164867ea",
  query: "algoritmo youtube crescimento subscribers 2026"
})

// Optimização vídeos
mcp__dify-kb__dify_kb_retrieve_segments({
  dataset_id: "baa1b3e6-ebf0-4413-84b2-63d1164867ea",
  query: "seo youtube tags thumbnails títulos CTR"
})

// Estratégia conteúdo vídeo
mcp__dify-kb__dify_kb_retrieve_segments({
  dataset_id: "66117552-348f-455d-9aca-2da722567693",
  query: "video marketing engagement retention hook"
})

Quando Consultar

• Estratégia crescimento canal (0-100K subs)
• Optimização títulos/thumbnails (CTR < 8%)
• Análise concorrência (pesquisa keywords)
• Melhores práticas upload (SEO YouTube)
• Monetização (AdSense, sponsors, produtos)

---

📈 Instrumentação Automática

INSERT INTO tblskill_agent_metrics (
  type, name, duration_ms, status, staff_id,
  kb_consulted, kb_cache_hit, tool_calls, project_id
) VALUES (
  'skill', '/youtube', {DURACAO_MS}, '{STATUS}', 25,
  {KB_CONSULTADO}, {CACHE_HIT}, {TOOL_CALLS}, {PROJECT_ID}
);

---

Versão: 3.0.0 | Data: 2026-02-03 | Autor: Descomplicar® Desk Task: #1490 | Standards: Algoritmo YouTube 2026, Crescimento Orgânico Script transcrições: /media/ealmeida/Dados/Dev/ClaudeDev/Claude-Scripts/youtube-transcript/youtube_extractor.py MCPs: youtube-research (8/12 OK), youtube-uploader (requer auth)

---

Quando NÃO Usar

• Para tarefas fora do domínio de especialização desta skill
• Quando outra skill mais específica está disponível
• Para operações que requerem confirmação manual do utilizador

Protocolo

1. Analisar requisitos da tarefa
2. Verificar disponibilidade de ferramentas necessárias
3. Executar operações de forma incremental
4. Validar resultados antes de concluir
5. Reportar status e próximos passos

Exemplos

Exemplo 1: Uso Básico

Input: [descrição da tarefa]
Output: [resultado esperado]

Exemplo 2: Uso Avançado

Input: [caso complexo]
Output: [resultado detalhado]