Files
claude-plugins/marketing/skills/youtube/SKILL.md
Emanuel Almeida 6b3a6f2698 feat: refactor 30+ skills to Anthropic progressive disclosure pattern
- All SKILL.md files now <500 lines (avg reduction 69%)
- Detailed content extracted to references/ subdirectories
- Frontmatter standardised: only name + description (Anthropic standard)
- New skills: brand-guidelines, spec-coauthor, report-templates, skill-creator
- Design skills: anti-slop guidelines, premium-proposals reference
- Removed non-standard frontmatter fields (triggers, version, author, category)

Plugins affected: infraestrutura, marketing, dev-tools, crm-ops, gestao,
core-tools, negocio, perfex-dev, wordpress, design-media

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-12 15:05:03 +00:00

230 lines
6.5 KiB
Markdown

---
name: youtube
description: Gestao e optimizacao de canais YouTube. Estrategia de conteudo, SEO, thumbnails e analytics.
---
# /youtube - YouTube Complete Toolkit
Comando para extrair transcricoes, metadados e estrategia de crescimento de canais YouTube. Best practices 2026.
---
## Contexto NotebookLM
ANTES de executar, consultar notebooks para contexto especializado:
| Notebook | ID | Consultar quando |
|----------|-----|-----------------|
| Producao de Video e YouTube | `058a896e` | Sempre |
| YouTube Monetizacao e Compliance | `60a209a7` | Para questoes de monetizacao |
```
mcp__notebooklm__notebook_query({
notebook_id: "058a896e-6c9a-4e51-ae7d-9adb2738bc5f",
query: "<adaptar ao contexto>"
})
mcp__notebooklm__notebook_query({
notebook_id: "60a209a7-e205-4d57-a6f3-fef3de61e87a",
query: "<adaptar ao contexto>"
})
```
---
## Arquitectura v3.0.0
| Funcionalidade | Metodo | Estado | Notas |
|----------------|--------|--------|-------|
| **Pesquisa** | MCP youtube-research | OK | Filtros avancados, regiao, legendas |
| **Estatisticas** | MCP youtube-research | OK | Videos, canais, comparacoes |
| **Comentarios** | MCP youtube-research | OK | Com replies e likes |
| **Trending** | MCP youtube-research | OK | Por regiao e categoria |
| **Transcricoes** | Script local | OK | `youtube_extractor.py` (MCP nao funciona) |
| **Upload** | MCP youtube-uploader | Requer Auth | OAuth necessario |
| **Estrategia Crescimento** | Skill internal | OK | Analise algoritmo, optimizacoes |
---
## MCP youtube-research (8/12 funcionais)
### Ferramentas Funcionais
| Ferramenta | Funcao | Parametros |
|------------|--------|------------|
| `search-videos` | Pesquisa avancada | query*, maxResults, regionCode, order, videoDuration |
| `get-video-stats` | Estatisticas video | videoId* |
| `get-video-comments` | Comentarios + replies | videoId*, maxResults, order, includeReplies |
| `get-channel-stats` | Estatisticas canal | channelId* |
| `analyze-channel-videos` | Analise performance | channelId*, maxResults, sortBy |
| `get-trending-videos` | Trending por regiao | regionCode, maxResults, categoryId |
| `get-video-categories` | Categorias disponiveis | regionCode |
| `compare-videos` | Comparar multiplos | videoIds[]* (2-10 videos) |
### Ferramentas com Problemas (nao usar)
| Ferramenta | Problema |
|------------|----------|
| `get-video-transcript` | Nao devolve output |
| `enhanced-transcript` | Transcricao vazia |
| `get-key-moments` | Depende de transcricao |
| `get-segmented-transcript` | Depende de transcricao |
> **Aviso:** As ferramentas de transcricao do MCP youtube-research nao funcionam. Usar sempre o script local.
---
## Transcricoes (Script Local)
```
/media/ealmeida/Dados/Dev/ClaudeDev/Claude-Scripts/youtube-transcript/youtube_extractor.py
```
### Uso
```bash
cd /media/ealmeida/Dados/Dev/ClaudeDev/Claude-Scripts/youtube-transcript/
source venv/bin/activate
python youtube_extractor.py "https://youtube.com/watch?v=xxx"
```
Ou via skill: `/youtube https://youtube.com/watch?v=xxx`
---
## Casos de Uso
### 1. Analise Concorrencia
```javascript
// Pesquisar top videos nicho
mcp__youtube-research__search-videos({
query: "marketing digital portugal",
maxResults: 50,
order: "viewCount",
regionCode: "PT",
videoDuration: "medium"
})
// Analisar canal concorrente
mcp__youtube-research__analyze-channel-videos({
channelId: "UCxxx...",
maxResults: 50,
sortBy: "viewCount"
})
```
### 2. Keyword Research
```javascript
mcp__youtube-research__search-videos({
query: "ganhar dinheiro online",
maxResults: 100,
order: "relevance"
})
// Analisar: titulos mais usados, CTR estimado, competicao
```
### 3. Trending Topics Portugal
```javascript
mcp__youtube-research__get-trending-videos({
regionCode: "PT",
maxResults: 50,
categoryId: "22"
})
```
---
## Metricas Chave (YouTube Studio)
| Metrica | Benchmark | Accao se < Benchmark |
|---------|-----------|----------------------|
| **AVD** (Average View Duration) | > 50% | Melhorar hook, cortar partes fracas |
| **CTR** (Click-Through Rate) | > 8% | Testar thumbnail/titulo |
| **Impressions** | Subir mes a mes | SEO, consistencia uploads |
| **Subscribers Rate** | > 1% views | CTAs mais claros |
| **Likes/Views** | > 5% | Pedir likes com razao |
| **Comments/Views** | > 0.5% | Perguntas no video |
---
## SEO YouTube Rapido
### Titulo (Peso: 40%)
```
[Keyword Principal] + [Beneficio/Curiosidade] + [Trigger]
BOM: "Como Ganhar Dinheiro no YouTube 2026 (5000EUR/Mes)"
BOM: "10 Erros FATAIS em Marketing Digital (Evita #7)"
MAU: "Vlog #247" (sem keyword)
MAU: "INCRIVEL!!! TENS QUE VER ISTO!!!" (clickbait spam)
```
**Regras:** < 60 caracteres, keyword primeiros 5 palavras, numeros especificos.
### Descricao (Peso: 30%)
Estrutura: Resumo + keyword (1a linha) -> Timestamps -> Descricao expandida (min 200 palavras) -> CTAs -> Links -> Hashtags (3-5) -> Contacto
### Tags (Peso: 10%)
10-15 tags total: 1-2 exact keyword + 3-5 variacoes + 3-5 long-tail + 2-3 genericas nicho.
---
## Upload de Videos (MCP youtube-uploader)
### Configuracao Inicial (uma vez)
1. `mcp__youtube-uploader__authenticate` -> URL OAuth2
2. Abrir URL no browser -> Login Google -> Autorizar
3. Copiar codigo do redirect -> `mcp__youtube-uploader__accesstoken`
### Upload Completo
```javascript
mcp__youtube-uploader__upload_video({
file_path: "/caminho/completo/video.mp4",
channel_id: "UCxxx...",
title: "Titulo Optimizado SEO (< 100 chars)",
description: "Descricao completa com timestamps, links, keywords (min 200 palavras)",
tags: "tag1, tag2, tag3",
status: "public",
category_id: "22",
publish_at: "2026-02-05T18:00:00Z"
})
```
### Categorias Principais
| ID | Nome | Uso |
|----|------|-----|
| 22 | People & Blogs | Vlogs, lifestyle |
| 24 | Entertainment | Entretenimento geral |
| 27 | Education | Tutoriais, cursos |
| 28 | Science & Technology | Tech, ciencia |
---
## Referencias Detalhadas
Para conteudo detalhado, consultar:
- [references/strategy-guide.md](references/strategy-guide.md) - Estrategia crescimento (3 fases: 0-1K, 1K-10K, 10K-100K+), algoritmo YouTube 2026, optimizacao titulos/thumbnails, SEO YouTube completo, hook framework, metricas detalhadas, upload com MCP
---
## Anti-Patterns
- Nao usar para tarefas fora do dominio YouTube
- Nao usar MCPs de transcricao (usar script local)
- Nao prometer uploads sem OAuth configurado
---
**Script transcricoes**: `/media/ealmeida/Dados/Dev/ClaudeDev/Claude-Scripts/youtube-transcript/youtube_extractor.py`
**MCPs**: youtube-research (8/12 OK), youtube-uploader (requer auth)