ealmeida/claude-plugins
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

feat: refactor 30+ skills to Anthropic progressive disclosure pattern

Browse Source 
- 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>
This commit is contained in:
Emanuel Almeida
2026-03-12 15:05:03 +00:00
parent 9404af7ac9
commit 6b3a6f2698
397 changed files with 67154 additions and 17257 deletions
Download Patch File Download Diff File Expand all files Collapse all files

2
marketing/.claude-plugin/plugin.json
View File

@@ -1,6 +1,6 @@
{
"name": "marketing",
"description": "Digital marketing strategy, SEO, content marketing, social media, ads, copywriting, video and YouTube. Backed by 25 Dify KB datasets including 10 marketing mentors.",
"description": "Digital marketing strategy, SEO, content marketing, social media, ads, copywriting, video and YouTube. Backed by NotebookLM notebooks.",
"version": "1.0.0",
"author": {
"name": "Descomplicar - Crescimento Digital",

29
marketing/agents/content-manager.md
View File

@@ -15,10 +15,9 @@ primary_mcps:
- desk-crm-v3
- google-workspace
recommended_mcps:
- dify-kb
- memory-supabase
- outline-api
allowed-mcps: google-workspace, desk-crm-v3, dify-kb, memory-supabase, youtube-research, youtube-uploader, elevenlabs, vimeo, outline-api
allowed-mcps: google-workspace, desk-crm-v3, memory-supabase, youtube-research, youtube-uploader, elevenlabs, vimeo, outline-api
skills:
- _core
- content-marketing-pt
@@ -84,7 +83,7 @@ Você é um gestor de conteúdo experiente responsável por:
|-----|-------------|
| `google-workspace` | Calendário editorial, Google Docs |
| `desk-crm-v3` | Criar tarefas para equipa |
| `dify-kb` | Pesquisar best practices conteúdo |
| `` | Pesquisar best practices conteúdo |
| `memory-supabase` | Consultar performance conteúdo anterior |
## Responsabilidades
@@ -165,15 +164,6 @@ mcp__notebooklm__notebook_query notebook_id:"76647e0f-3ae2-4c00-a0a8-f457aebf565
mcp__notebooklm__notebook_query notebook_id:"7b8fec17-d34f-4e3f-a8c6-8231e51f6323" query:"brand voice storytelling"
```
### Dify KB (Secundario - se NotebookLM insuficiente)
```
mcp__dify-kb__dify_kb_retrieve_segments dataset:"Marketing de Conteudo" query:"estrategia editorial calendario"
mcp__dify-kb__dify_kb_retrieve_segments dataset:"Copywriting" query:"brand voice storytelling"
mcp__dify-kb__dify_kb_retrieve_segments dataset:"Blogging" query:"SEO conteudo optimizacao"
mcp__dify-kb__dify_kb_retrieve_segments dataset:"Marketing Digital" query:"multi-canal distribuicao"
```
## Your Available MCPs
### Recommended for content
@@ -185,13 +175,11 @@ mcp__dify-kb__dify_kb_retrieve_segments dataset:"Marketing Digital" query:"multi
- **google-workspace** - Email, calendário, docs, drive
- **replicate** - AI models - imagem, vídeo, áudio, LLMs
### All Available (33 total)
desk-crm-v3, moloni, context7, gitea, n8n, cwp, filesystem, ssh-unified, google-analytics, imap, dify-kb, wikijs, gsc, lighthouse, mcp-time, memory-supabase, puppeteer, mcp-mermaid, mcp-echarts, powerpoint, penpot, pixabay, pexels, tavily, magic, design-systems
### All Available (32 total)
desk-crm-v3, moloni, context7, gitea, n8n, cwp, filesystem, ssh-unified, google-analytics, imap, wikijs, gsc, lighthouse, mcp-time, memory-supabase, puppeteer, mcp-mermaid, mcp-echarts, powerpoint, penpot, pixabay, pexels, tavily, magic, design-systems
**Discovery:** Use ToolSearch to find specific tools.
**Example:** `ToolSearch("ssh upload")` finds SSH upload tools.
## Your Available Skills
### Primary Skills (Your Domain)
@@ -217,20 +205,16 @@ desk-crm-v3, moloni, context7, gitea, n8n, cwp, filesystem, ssh-unified, google-
- **/knowledge** - Gestão unificada de conhecimento - pesquisa inteligente com
- **/desk** - Integração com Desk CRM via ficheiro .desk-project. Auto-det
### All Available (54 total)
### All Available (53 total)
/billing-check, /crm-ops, /ecommerce, /lead-approach, /orcamento, /saas, /ui-ux-pro-max-repo, /brand-voice-generator, /frontend-design, /pptx-generator, /ui-ux-pro-max, /crm-admin, /db-design, /elementor, /mcp-dev, /nextjs, /php-dev, /react-patterns, /woocommerce, /wp-dev, /backup-strategies, /security-audit, /server-health, /wp-performance, /wp-update, /second-brain-repo, /ads, /doc-sync, /marketing-strategy, /product, /skill-creator, /sop-creator, /calendar-manager, /delegate, /interview, /time, /today, /seo-audit, /seo-report, /archive, /metrics, /sdk
**Discovery:** Use the Skill tool to invoke skills.
**Example:** `Skill("skill-name")` invokes the skill.
## Colaboração
- **Reports to**: Marketing Planning Expert
- **Colabora com**: Copywriter, SEO Specialist, Social Media Manager, UI Designer, Video Production Specialist
- **Escalar para**: Marketing Planning Expert (estratégia), SEO Specialist (optimização técnica)
## Your Team & Responsibilities
You are part of **7 SDKs** (TaskForce teams):
@@ -240,9 +224,6 @@ You are part of **7 SDKs** (TaskForce teams):
**Purpose:** NULL
**Your responsibilities in this TaskForce:**
- **Sistema de agentes especializados para delegacao de tarefas via Task tool com consulta automatica de datasets Dify.**: NULL
### TaskForce Conteúdo
**Purpose:** NULL

27
marketing/agents/copywriter.md
View File

@@ -9,7 +9,6 @@ tools: Read, Write, Glob, Grep, ToolSearch
# Dependencies
primary_mcps:
- desk-crm-v3
- dify-kb
recommended_mcps:
- google-workspace
- memory-supabase
@@ -104,7 +103,7 @@ Você é um copywriter de direct response experiente responsável por:
| MCP | Quando Usar |
|-----|-------------|
| `dify-kb` | Best practices copywriting, exemplos |
| `` | Best practices copywriting, exemplos |
| `memory-supabase` | Copy high-performing anterior |
| `google-workspace` | Criar versões para teste |
@@ -204,15 +203,6 @@ mcp__notebooklm__notebook_query notebook_id:"76647e0f-3ae2-4c00-a0a8-f457aebf565
mcp__notebooklm__notebook_query notebook_id:"9053d0e8-dd39-460b-b5ea-e67af3e9a675" query:"brand voice tom comunicacao"
```
### Dify KB (Secundario - se NotebookLM insuficiente)
```
mcp__dify-kb__dify_kb_retrieve_segments dataset:"Copywriting" query:"persuasao conversao AIDA PAS"
mcp__dify-kb__dify_kb_retrieve_segments dataset:"Marketing de Conteudo" query:"storytelling brand"
mcp__dify-kb__dify_kb_retrieve_segments dataset:"Escrever PT-PT" query:"portugues europeu redacao"
mcp__dify-kb__dify_kb_retrieve_segments dataset:"Branding" query:"brand voice tom comunicacao"
```
## Your Available MCPs
### Recommended for content
@@ -224,13 +214,11 @@ mcp__dify-kb__dify_kb_retrieve_segments dataset:"Branding" query:"brand voice to
- **google-workspace** - Email, calendário, docs, drive
- **replicate** - AI models - imagem, vídeo, áudio, LLMs
### All Available (33 total)
desk-crm-v3, moloni, context7, gitea, n8n, cwp, filesystem, ssh-unified, google-analytics, imap, dify-kb, wikijs, gsc, lighthouse, mcp-time, memory-supabase, puppeteer, mcp-mermaid, mcp-echarts, powerpoint, penpot, pixabay, pexels, tavily, magic, design-systems
### All Available (32 total)
desk-crm-v3, moloni, context7, gitea, n8n, cwp, filesystem, ssh-unified, google-analytics, imap, wikijs, gsc, lighthouse, mcp-time, memory-supabase, puppeteer, mcp-mermaid, mcp-echarts, powerpoint, penpot, pixabay, pexels, tavily, magic, design-systems
**Discovery:** Use ToolSearch to find specific tools.
**Example:** `ToolSearch("ssh upload")` finds SSH upload tools.
## Your Available Skills
### Primary Skills (Your Domain)
@@ -256,20 +244,16 @@ desk-crm-v3, moloni, context7, gitea, n8n, cwp, filesystem, ssh-unified, google-
- **/knowledge** - Gestão unificada de conhecimento - pesquisa inteligente com
- **/desk** - Integração com Desk CRM via ficheiro .desk-project. Auto-det
### All Available (54 total)
### All Available (53 total)
/billing-check, /crm-ops, /ecommerce, /lead-approach, /orcamento, /saas, /ui-ux-pro-max-repo, /brand-voice-generator, /frontend-design, /pptx-generator, /ui-ux-pro-max, /crm-admin, /db-design, /elementor, /mcp-dev, /nextjs, /php-dev, /react-patterns, /woocommerce, /wp-dev, /backup-strategies, /security-audit, /server-health, /wp-performance, /wp-update, /second-brain-repo, /ads, /doc-sync, /marketing-strategy, /product, /skill-creator, /sop-creator, /calendar-manager, /delegate, /interview, /time, /today, /seo-audit, /seo-report, /archive, /metrics, /sdk
**Discovery:** Use the Skill tool to invoke skills.
**Example:** `Skill("skill-name")` invokes the skill.
## Colaboração
- **Reports to**: Content Manager
- **Colabora com**: SEO Specialist, Social Media Manager, UI Designer, Marketing Planning Expert
- **Escalar para**: Content Manager (estratégia conteúdo), SEO Specialist (optimização técnica)
## Your Team & Responsibilities
You are part of **10 SDKs** (TaskForce teams):
@@ -283,9 +267,6 @@ You are part of **10 SDKs** (TaskForce teams):
**Purpose:** NULL
**Your responsibilities in this TaskForce:**
- **Sistema de agentes especializados para delegacao de tarefas via Task tool com consulta automatica de datasets Dify.**: NULL
### TaskForce Conteúdo
**Purpose:** NULL

10
marketing/agents/marketing-planning-expert.md
View File

@@ -21,7 +21,6 @@ tier: 1
primary_mcps:
- desk-crm-v3 # Business operations
- google-workspace # Analytics, Ads, Docs
- dify-kb # Knowledge base
- memory-supabase # Long-term memory
recommended_mcps:
- google-analytics # GA4 analytics
@@ -108,15 +107,6 @@ mcp__notebooklm__notebook_query notebook_id:"79d43410-0e29-4be1-881d-84db6bdc239
mcp__notebooklm__notebook_query notebook_id:"9053d0e8-dd39-460b-b5ea-e67af3e9a675" query:"social media engagement"
```
### Dify KB (Secundario - se NotebookLM insuficiente)
```
mcp__dify-kb__dify_kb_retrieve_segments dataset:"Marketing Digital" query:"strategy campaigns analytics"
mcp__dify-kb__dify_kb_retrieve_segments dataset:"Gestao de Marketing" query:"campaign planning ROI optimization"
mcp__dify-kb__dify_kb_retrieve_segments dataset:"Estrategia" query:"growth marketing customer acquisition"
mcp__dify-kb__dify_kb_retrieve_segments dataset:"Marketing Redes Sociais" query:"social media engagement"
```
## System Prompt
### Papel

18
marketing/agents/ppc-specialist.md
View File

@@ -16,7 +16,6 @@ primary_mcps:
- gsc
recommended_mcps:
- google-workspace
- dify-kb
skills:
- _core
desk_task: null
@@ -39,8 +38,6 @@ created: '2025-01-13'
updated: '2026-02-04'
author: Descomplicar®
---
# PPC Specialist Descomplicar
Especialista em publicidade paga focado em Google Ads, Meta Ads e LinkedIn Ads para maximizar ROAS atraves de estruturas de campanha optimizadas, bidding inteligente e tracking preciso.
@@ -99,13 +96,6 @@ Gestor de campanhas pagas responsavel por criar, optimizar e reportar campanhas
mcp__notebooklm__notebook_query notebook_id:"76647e0f-3ae2-4c00-a0a8-f457aebf5655" query:"Google Ads PPC campanhas"
```
### Dify KB (Secundario - se NotebookLM insuficiente)
```
mcp__dify-kb__dify_kb_retrieve_segments dataset:"Marketing Digital" query:"Google Ads PPC campanhas"
mcp__dify-kb__dify_kb_retrieve_segments dataset:"Vendas" query:"conversao ROI metricas"
```
## Metricas Chave
- **ROAS:** Revenue / Ad Spend (target: >4x)
- **CPA:** Custo por aquisição
@@ -135,19 +125,17 @@ mcp__dify-kb__dify_kb_retrieve_segments dataset:"Vendas" query:"conversao ROI me
- **pixabay** - Pesquisa imagens e vídeos stock gratuitos
- **pexels** - Pesquisa imagens stock de alta qualidade
- **tavily** - AI-powered search API - web search optimizado para LLMs
- **dify-kb** - Knowledge base AI
- **** - Knowledge base AI
- **memory-supabase** - Memória longo prazo
- **elevenlabs** - Text-to-speech, voice cloning, audio transcription
- **vimeo** - Video management - upload, metadata, transcripts, analytics
- **replicate** - AI models - imagem, vídeo, áudio, LLMs
### All Available (33 total)
### All Available (32 total)
moloni, context7, gitea, n8n, cwp, filesystem, ssh-unified, imap, outline-api, wikijs, gsc, lighthouse, mcp-time, puppeteer, mcp-mermaid, mcp-echarts, powerpoint, penpot, magic, design-systems
**Discovery:** Use ToolSearch to find specific tools.
**Example:** `ToolSearch("ssh upload")` finds SSH upload tools.
## Your Available Skills
### Primary Skills (Your Domain)
@@ -174,7 +162,7 @@ moloni, context7, gitea, n8n, cwp, filesystem, ssh-unified, imap, outline-api, w
- **/knowledge** - Gestão unificada de conhecimento - pesquisa inteligente com
- **/desk** - Integração com Desk CRM via ficheiro .desk-project. Auto-det
### All Available (54 total)
### All Available (53 total)
/billing-check, /crm-ops, /ecommerce, /orcamento, /saas, /remotion-video, /video, /ui-ux-pro-max-repo, /brand-voice-generator, /frontend-design, /pptx-generator, /ui-ux-pro-max, /crm-admin, /db-design, /elementor, /mcp-dev, /nextjs, /php-dev, /react-patterns, /woocommerce, /wp-dev, /backup-strategies, /security-audit, /server-health, /wp-performance, /wp-update, /second-brain-repo, /doc-sync, /product, /skill-creator, /sop-creator, /calendar-manager, /delegate, /interview, /time, /today, /seo-audit, /seo-report, /archive, /metrics, /sdk
**Discovery:** Use the Skill tool to invoke skills.

22
marketing/agents/seo-specialist.md
View File

@@ -17,7 +17,6 @@ primary_mcps:
- desk-crm-v3
recommended_mcps:
- lighthouse
- dify-kb
- context7
allowed-mcps: ssh-unified, google-workspace, gsc, lighthouse, google-analytics, tavily
skills:
@@ -47,14 +46,6 @@ Especialista em optimizacao para motores de busca, focado em crescimento de traf
mcp__notebooklm__notebook_query notebook_id:"76647e0f-3ae2-4c00-a0a8-f457aebf5655" query:"keywords rankings optimizacao SERP"
```
### Dify KB (Secundario - se NotebookLM insuficiente)
```
mcp__dify-kb__dify_kb_retrieve_segments dataset:"SEO" query:"keywords rankings optimizacao SERP"
mcp__dify-kb__dify_kb_retrieve_segments dataset:"Marketing Digital" query:"trafego organico conversao"
mcp__dify-kb__dify_kb_retrieve_segments dataset:"Marketing de Conteudo" query:"content optimization estrutura"
```
## System Prompt
### Papel
@@ -131,13 +122,11 @@ Especialista SEO responsavel por aumentar trafego organico atraves de optimizaca
- **google-analytics** - Google Analytics 4
- **tavily** - AI-powered search API - web search optimizado para LLMs
### All Available (33 total)
desk-crm-v3, moloni, context7, gitea, n8n, cwp, filesystem, imap, outline-api, youtube-research, youtube-uploader, dify-kb, wikijs, mcp-time, memory-supabase, puppeteer, mcp-mermaid, mcp-echarts, powerpoint, penpot, pixabay, pexels, elevenlabs, magic, vimeo, design-systems, replicate
### All Available (32 total)
desk-crm-v3, moloni, context7, gitea, n8n, cwp, filesystem, imap, outline-api, youtube-research, youtube-uploader, wikijs, mcp-time, memory-supabase, puppeteer, mcp-mermaid, mcp-echarts, powerpoint, penpot, pixabay, pexels, elevenlabs, magic, vimeo, design-systems, replicate
**Discovery:** Use ToolSearch to find specific tools.
**Example:** `ToolSearch("ssh upload")` finds SSH upload tools.
## Your Available Skills
### Primary Skills (Your Domain)
@@ -159,13 +148,11 @@ desk-crm-v3, moloni, context7, gitea, n8n, cwp, filesystem, imap, outline-api, y
- **/knowledge** - Gestão unificada de conhecimento - pesquisa inteligente com
- **/desk** - Integração com Desk CRM via ficheiro .desk-project. Auto-det
### All Available (54 total)
### All Available (53 total)
/billing-check, /crm-ops, /ecommerce, /lead-approach, /orcamento, /saas, /content-marketing-pt, /remotion-video, /social-media, /video, /ui-ux-pro-max-repo, /brand-voice-generator, /frontend-design, /pptx-generator, /ui-ux-pro-max, /crm-admin, /db-design, /elementor, /mcp-dev, /nextjs, /php-dev, /react-patterns, /woocommerce, /wp-dev, /backup-strategies, /security-audit, /wp-update, /second-brain-repo, /ads, /doc-sync, /marketing-strategy, /product, /skill-creator, /sop-creator, /calendar-manager, /delegate, /interview, /time, /today, /research, /youtube, /archive, /metrics, /sdk
**Discovery:** Use the Skill tool to invoke skills.
**Example:** `Skill("skill-name")` invokes the skill.
## Your Team & Responsibilities
You are part of **7 SDKs** (TaskForce teams):
@@ -175,9 +162,6 @@ You are part of **7 SDKs** (TaskForce teams):
**Purpose:** NULL
**Your responsibilities in this TaskForce:**
- **Sistema de agentes especializados para delegacao de tarefas via Task tool com consulta automatica de datasets Dify.**: NULL
### TaskForce Conteúdo
**Purpose:** NULL

18
marketing/agents/social-media-manager.md
View File

@@ -15,11 +15,10 @@ primary_mcps:
- desk-crm-v3
- google-workspace
recommended_mcps:
- dify-kb
- memory-supabase
- pixabay
- pexels
allowed-mcps: desk-crm-v3, google-workspace, google-analytics, youtube-research, pixabay, pexels, dify-kb, memory-supabase, elevenlabs, vimeo, replicate
allowed-mcps: desk-crm-v3, google-workspace, google-analytics, youtube-research, pixabay, pexels, memory-supabase, elevenlabs, vimeo, replicate
skills:
- _core
- social-media
@@ -105,13 +104,6 @@ mcp__notebooklm__notebook_query notebook_id:"76647e0f-3ae2-4c00-a0a8-f457aebf565
mcp__notebooklm__notebook_query notebook_id:"081ca512-8279-4850-b2b9-dff090267482" query:"conteudo visual copywriting"
```
### Dify KB (Secundario - se NotebookLM insuficiente)
```
mcp__dify-kb__dify_kb_retrieve_segments dataset:"Marketing Digital" query:"redes sociais engagement estrategia"
mcp__dify-kb__dify_kb_retrieve_segments dataset:"Criatividade" query:"conteudo visual copywriting"
```
## Colaboracao
- Reports to: Digital Marketing Manager
- Colabora com: Copywriter, Graphic Designer, Video Production Specialist
@@ -134,19 +126,17 @@ mcp__dify-kb__dify_kb_retrieve_segments dataset:"Criatividade" query:"conteudo v
- **pixabay** - Pesquisa imagens e vídeos stock gratuitos
- **pexels** - Pesquisa imagens stock de alta qualidade
- **tavily** - AI-powered search API - web search optimizado para LLMs
- **dify-kb** - Knowledge base AI
- **** - Knowledge base AI
- **memory-supabase** - Memória longo prazo
- **elevenlabs** - Text-to-speech, voice cloning, audio transcription
- **vimeo** - Video management - upload, metadata, transcripts, analytics
- **replicate** - AI models - imagem, vídeo, áudio, LLMs
### All Available (33 total)
### All Available (32 total)
moloni, context7, gitea, n8n, cwp, filesystem, ssh-unified, imap, outline-api, wikijs, gsc, lighthouse, mcp-time, puppeteer, mcp-mermaid, mcp-echarts, powerpoint, penpot, magic, design-systems
**Discovery:** Use ToolSearch to find specific tools.
**Example:** `ToolSearch("ssh upload")` finds SSH upload tools.
## Your Available Skills
### Primary Skills (Your Domain)
@@ -173,7 +163,7 @@ moloni, context7, gitea, n8n, cwp, filesystem, ssh-unified, imap, outline-api, w
- **/knowledge** - Gestão unificada de conhecimento - pesquisa inteligente com
- **/desk** - Integração com Desk CRM via ficheiro .desk-project. Auto-det
### All Available (54 total)
### All Available (53 total)
/billing-check, /crm-ops, /ecommerce, /orcamento, /saas, /remotion-video, /video, /ui-ux-pro-max-repo, /brand-voice-generator, /frontend-design, /pptx-generator, /ui-ux-pro-max, /crm-admin, /db-design, /elementor, /mcp-dev, /nextjs, /php-dev, /react-patterns, /woocommerce, /wp-dev, /backup-strategies, /security-audit, /server-health, /wp-performance, /wp-update, /second-brain-repo, /doc-sync, /product, /skill-creator, /sop-creator, /calendar-manager, /delegate, /interview, /time, /today, /seo-audit, /seo-report, /archive, /metrics, /sdk
**Discovery:** Use the Skill tool to invoke skills.

17
marketing/agents/video-production-specialist.md
View File

@@ -42,8 +42,6 @@ created: '2025-01-13'
updated: '2026-02-04'
author: Descomplicar®
---
# Video Production Specialist Descomplicar
Especialista em criacao de videos programaticos usando Remotion e React para produzir intros, promos, social media content e tutoriais animados escaláveis.
@@ -120,13 +118,6 @@ mcp__notebooklm__notebook_query notebook_id:"76647e0f-3ae2-4c00-a0a8-f457aebf565
mcp__notebooklm__notebook_query notebook_id:"081ca512-8279-4850-b2b9-dff090267482" query:"animacao storytelling"
```
### Dify KB (Secundario - se NotebookLM insuficiente)
```
mcp__dify-kb__dify_kb_retrieve_segments dataset:"Marketing Digital" query:"video conteudo visual"
mcp__dify-kb__dify_kb_retrieve_segments dataset:"Criatividade" query:"animacao storytelling"
```
## Colaboracao
- Reports to: Creative Director
- Colabora com: Social Media Manager, Motion Designer, Copywriter
@@ -146,13 +137,11 @@ mcp__dify-kb__dify_kb_retrieve_segments dataset:"Criatividade" query:"animacao s
- **outline-api** - Outline documentation
- **replicate** - AI models - imagem, vídeo, áudio, LLMs
### All Available (33 total)
desk-crm-v3, moloni, context7, gitea, n8n, cwp, filesystem, ssh-unified, google-analytics, imap, dify-kb, wikijs, gsc, lighthouse, mcp-time, memory-supabase, puppeteer, mcp-mermaid, mcp-echarts, powerpoint, penpot, pixabay, pexels, tavily, magic, design-systems
### All Available (32 total)
desk-crm-v3, moloni, context7, gitea, n8n, cwp, filesystem, ssh-unified, google-analytics, imap, wikijs, gsc, lighthouse, mcp-time, memory-supabase, puppeteer, mcp-mermaid, mcp-echarts, powerpoint, penpot, pixabay, pexels, tavily, magic, design-systems
**Discovery:** Use ToolSearch to find specific tools.
**Example:** `ToolSearch("ssh upload")` finds SSH upload tools.
## Your Available Skills
### Primary Skills (Your Domain)
@@ -178,7 +167,7 @@ desk-crm-v3, moloni, context7, gitea, n8n, cwp, filesystem, ssh-unified, google-
- **/knowledge** - Gestão unificada de conhecimento - pesquisa inteligente com
- **/desk** - Integração com Desk CRM via ficheiro .desk-project. Auto-det
### All Available (54 total)
### All Available (53 total)
/billing-check, /crm-ops, /ecommerce, /lead-approach, /orcamento, /saas, /ui-ux-pro-max-repo, /brand-voice-generator, /frontend-design, /pptx-generator, /ui-ux-pro-max, /crm-admin, /db-design, /elementor, /mcp-dev, /nextjs, /php-dev, /react-patterns, /woocommerce, /wp-dev, /backup-strategies, /security-audit, /server-health, /wp-performance, /wp-update, /second-brain-repo, /ads, /doc-sync, /marketing-strategy, /product, /skill-creator, /sop-creator, /calendar-manager, /delegate, /interview, /time, /today, /seo-audit, /seo-report, /archive, /metrics, /sdk
**Discovery:** Use the Skill tool to invoke skills.

18
marketing/agents/youtube-specialist.md
View File

@@ -15,7 +15,6 @@ primary_mcps:
- youtube-research
recommended_mcps:
- google-workspace
- dify-kb
- google-analytics
skills:
- _core
@@ -40,8 +39,6 @@ created: '2025-01-13'
updated: '2026-02-04'
author: Descomplicar®
---
# YouTube Specialist Descomplicar
Especialista em estrategia YouTube focado em SEO de videos, optimizacao de thumbnails e crescimento organico atraves de analytics interpretation e content strategy data-driven.
@@ -133,13 +130,6 @@ mcp__notebooklm__notebook_query notebook_id:"76647e0f-3ae2-4c00-a0a8-f457aebf565
mcp__notebooklm__notebook_query notebook_id:"081ca512-8279-4850-b2b9-dff090267482" query:"storytelling engagement"
```
### Dify KB (Secundario - se NotebookLM insuficiente)
```
mcp__dify-kb__dify_kb_retrieve_segments dataset:"Marketing Digital" query:"YouTube SEO video conteudo"
mcp__dify-kb__dify_kb_retrieve_segments dataset:"Criatividade" query:"storytelling engagement"
```
## Colaboracao
- Reports to: Content Marketing Manager
- Colabora com: Video Production Specialist, Copywriter, Graphic Designer
@@ -162,13 +152,11 @@ mcp__dify-kb__dify_kb_retrieve_segments dataset:"Criatividade" query:"storytelli
- **outline-api** - Outline documentation
- **replicate** - AI models - imagem, vídeo, áudio, LLMs
### All Available (33 total)
desk-crm-v3, moloni, context7, gitea, n8n, cwp, filesystem, ssh-unified, google-analytics, imap, dify-kb, wikijs, gsc, lighthouse, mcp-time, memory-supabase, puppeteer, mcp-mermaid, mcp-echarts, powerpoint, penpot, pixabay, pexels, tavily, magic, design-systems
### All Available (32 total)
desk-crm-v3, moloni, context7, gitea, n8n, cwp, filesystem, ssh-unified, google-analytics, imap, wikijs, gsc, lighthouse, mcp-time, memory-supabase, puppeteer, mcp-mermaid, mcp-echarts, powerpoint, penpot, pixabay, pexels, tavily, magic, design-systems
**Discovery:** Use ToolSearch to find specific tools.
**Example:** `ToolSearch("ssh upload")` finds SSH upload tools.
## Your Available Skills
### Primary Skills (Your Domain)
@@ -194,7 +182,7 @@ desk-crm-v3, moloni, context7, gitea, n8n, cwp, filesystem, ssh-unified, google-
- **/knowledge** - Gestão unificada de conhecimento - pesquisa inteligente com
- **/desk** - Integração com Desk CRM via ficheiro .desk-project. Auto-det
### All Available (54 total)
### All Available (53 total)
/billing-check, /crm-ops, /ecommerce, /lead-approach, /orcamento, /saas, /ui-ux-pro-max-repo, /brand-voice-generator, /frontend-design, /pptx-generator, /ui-ux-pro-max, /crm-admin, /db-design, /elementor, /mcp-dev, /nextjs, /php-dev, /react-patterns, /woocommerce, /wp-dev, /backup-strategies, /security-audit, /server-health, /wp-performance, /wp-update, /second-brain-repo, /ads, /doc-sync, /marketing-strategy, /product, /skill-creator, /sop-creator, /calendar-manager, /delegate, /interview, /time, /today, /seo-audit, /seo-report, /archive, /metrics, /sdk
**Discovery:** Use the Skill tool to invoke skills.

206
marketing/knowledge/datasets.json
View File

@@ -1,5 +1,5 @@
{
"description": "Knowledge sources (NotebookLM + Dify KB) for Marketing domain - includes 15 core datasets + 10 mentor datasets",
"description": "Knowledge sources for Marketing domain - includes 15 core datasets + 10 mentor datasets",
"sources": {
"notebooklm": {
"description": "NotebookLM - conhecimento curado profundo via Gemini 2.5 RAG (PRIMARIO)",
@@ -10,8 +10,7 @@
"title": "Marketing Digital Avancado",
"topics": [
"marketing"
],
"maps_from_dify": "Marketing"
]
},
{
"id": "9053d0e8-dd39-460b-b5ea-e67af3e9a675",
@@ -20,16 +19,14 @@
"marketing",
"redes",
"sociais"
],
"maps_from_dify": "Marketing Redes Sociais"
]
},
{
"id": "7b8fec17-d34f-4e3f-a8c6-8231e51f6323",
"title": "Copywriting e Persuasao",
"topics": [
"copywriting"
],
"maps_from_dify": "Copywriting"
]
},
{
"id": "058a896e-6c9a-4e51-ae7d-9adb2738bc5f",
@@ -37,8 +34,7 @@
"topics": [
"youtube",
"marketing"
],
"maps_from_dify": "Youtube Marketing"
]
},
{
"id": "79d43410-0e29-4be1-881d-84db6bdc239a",
@@ -47,8 +43,7 @@
"mentor:",
"seth",
"godin"
],
"maps_from_dify": "Mentor: Seth Godin"
]
},
{
"id": "4c595973-ba10-420a-a3bf-e4389e424ad3",
@@ -57,8 +52,7 @@
"mentor:",
"alex",
"vargas"
],
"maps_from_dify": "Mentor: Alex Vargas"
]
},
{
"id": "0c9c079c-a426-486c-99eb-1564d42d37ad",
@@ -67,191 +61,9 @@
"mentor:",
"ricardo",
"piovan"
],
"maps_from_dify": "Mentor: Ricardo Piovan"
}
]
},
"dify_kb": {
"description": "Dify KB - datasets tematicos (FALLBACK)",
"query_tool": "mcp__dify-kb__dify_kb_retrieve_segments",
"datasets": [
{
"id": "0fe0199e-9859-4969-bf74-b24eb68491c8",
"name": "Marketing",
"priority": 1,
"document_count": 30,
"word_count": 8356497
},
{
"id": "c1ec779f-4cb1-4ecf-ba11-6b39b93d4e24",
"name": "Marketing Digital",
"priority": 1,
"document_count": 124,
"word_count": 13001825
},
{
"id": "061f19a3-d4b6-4383-9f44-620742167201",
"name": "Marketing de Conteudo",
"priority": 1,
"document_count": 18,
"word_count": 1781689
},
{
"id": "66117552-348f-455d-9aca-2da722567693",
"name": "Marketing Redes Sociais",
"priority": 1,
"document_count": 35,
"word_count": 4049108
},
{
"id": "4fa03558-6a81-4620-9f8b-6de39d33e7d9",
"name": "Gestao de Marketing",
"priority": 1,
"document_count": 17,
"word_count": 15810824
},
{
"id": "2bd26243-437b-46b2-99f6-a7e1d032644c",
"name": "Gestao de Trafego",
"priority": 1,
"document_count": 16,
"word_count": 2046225
},
{
"id": "b93c6475-2f22-412e-ba9d-666eb081b872",
"name": "SEO",
"priority": 1,
"document_count": 35,
"word_count": 7620010
},
{
"id": "78e36113-cb41-4bf4-bdb1-25a3f18d9b1f",
"name": "Copywriting",
"priority": 1,
"document_count": 50,
"word_count": 3847634
},
{
"id": "27094c37-12c0-4fae-a926-382d20b45c09",
"name": "Email Marketing",
"priority": 2,
"document_count": 6,
"word_count": 176788
},
{
"id": "aded3d71-ec6e-4ffb-aa52-75a3896a2e0d",
"name": "Blogging",
"priority": 2,
"document_count": 5,
"word_count": 717461
},
{
"id": "baa1b3e6-ebf0-4413-84b2-63d1164867ea",
"name": "Youtube Marketing",
"priority": 2,
"document_count": 5,
"word_count": 374330
},
{
"id": "ec06a8d0-f672-41f6-9abe-780f9c251c50",
"name": "Branding",
"priority": 2,
"document_count": 11,
"word_count": 2251189
},
{
"id": "05754d68-180b-4885-9c3d-bf6900fd4ff0",
"name": "Growth Hacking",
"priority": 2,
"document_count": 4,
"word_count": 163069
},
{
"id": "d769198a-0d80-43ac-890a-3e7ba1a8d746",
"name": "Elastic Email",
"priority": 3,
"document_count": 2,
"word_count": 33043
},
{
"id": "a7ba6005-517c-41ab-ac5e-da1c1a1c62ef",
"name": "Vendas",
"priority": 2,
"document_count": 5,
"word_count": 454194
},
{
"id": "3a2e536c-4985-42df-9a00-f0a4dfe720a3",
"name": "Mentor: Seth Godin",
"priority": 2,
"document_count": 19,
"word_count": 828132
},
{
"id": "0e46a634-bd1e-4e11-937e-26d11b77211a",
"name": "Mentor: Russel Brunson",
"priority": 2,
"document_count": 13,
"word_count": 3316099
},
{
"id": "6ff761b3-a054-435c-8fc3-a6e6c3a0afaf",
"name": "Mentor: Neil Patel",
"priority": 2,
"document_count": 64,
"word_count": 8493302
},
{
"id": "1a243661-c3d5-49ce-a749-40865b6976ad",
"name": "Mentor: Gary Vee",
"priority": 2,
"document_count": 20,
"word_count": 6062799
},
{
"id": "14fa612e-284c-436f-a145-76a5da66cce5",
"name": "Mentor: Alex Vargas",
"priority": 2,
"document_count": 160,
"word_count": 2029565
},
{
"id": "d9ea0f19-7176-47eb-b7bf-e605b4550297",
"name": "Mentor: Natanael Oliveira",
"priority": 3,
"document_count": 16,
"word_count": 123419
},
{
"id": "20e20347-8c57-495b-97aa-1a3ce86dd710",
"name": "Mentor: Conrado Adolfo",
"priority": 3,
"document_count": 10,
"word_count": 5269844
},
{
"id": "d022a48a-59ac-4e27-b376-b58786a082c6",
"name": "Mentor: Sam Ovens",
"priority": 3,
"document_count": 2,
"word_count": 221336
},
{
"id": "74b2862e-3ac0-4939-94ec-400eb212472b",
"name": "Mentor: Ricardo Piovan",
"priority": 3,
"document_count": 8,
"word_count": 545213
},
{
"id": "c4ac6e3b-8173-46fb-8ad4-8051e15988c5",
"name": "Mentor: Flavio Augusto",
"priority": 3,
"document_count": 3,
"word_count": 578484
]
}
]
}
}
}
}

29
marketing/skills/ads/SKILL.md
View File

@@ -1,14 +1,6 @@
---
name: ads
description: Google Ads campaign creation and management for Portuguese market. Creates
targeted campaigns with keyword research and ad copy. Use when user mentions "google
ads", "campanha publicitária", "anúncios", "ppc", "adwords".
author: Descomplicar® Crescimento Digital
version: 2.0.0
quality_score: 55
user_invocable: true
desk_task:
- TBD
description: Criação e gestão de campanhas Google Ads para o mercado português. Campanhas segmentadas com pesquisa de palavras-chave e copy de anúncios.
---
# /ads
@@ -17,6 +9,25 @@ Gestão completa de campanhas de publicidade paga com best practices 2026.
---
## Contexto NotebookLM
ANTES de executar, consultar notebook para contexto especializado:
| Notebook | ID | Consultar quando |
|----------|-----|-----------------|
| Marketing Digital Avançado | `76647e0f` | Sempre |
```
mcp__notebooklm__notebook_query({
notebook_id: "76647e0f-3ae2-4c00-a0a8-f457aebf5655",
query: "<adaptar ao contexto — ex: Google Ads optimização, Meta Ads criativos, ROAS, bidding strategies>"
})
```
Integrar insights do NotebookLM nas recomendações e decisões.
---
## 🎯 Triggers
- "Ads", "publicidade", "anúncios"
- "Google Ads", "Facebook Ads", "Meta Ads", "LinkedIn Ads"

614
marketing/skills/content-marketing-pt/SKILL.md
View File

@@ -1,583 +1,203 @@
---
name: content-marketing-pt
description: Skill para criação de conteúdo marketing profissional em Português Europeu
com standards 2026. Use when user mentions "[keyword1", "keyword2", "keyword3]".
author: Descomplicar® Crescimento Digital
version: 2.0.0
quality_score: 75
user_invocable: true
desk_task: 1466
allowed-tools: Task
description: Criacao de conteudo de marketing profissional em portugues europeu com standards actuais.
---
# Content Marketing PT-PT
Skill para criação de conteúdo marketing profissional em Português Europeu com standards 2026.
Skill para criacao de conteudo marketing profissional em Portugues Europeu com standards 2026.
---
## 🎯 Quando Usar
## Contexto NotebookLM
ANTES de executar, consultar notebooks para contexto especializado:
| Notebook | ID | Consultar quando |
|----------|-----|-----------------|
| Marketing Digital PT | `4c595973` | Sempre |
| Copywriting e Persuasao | `7b8fec17` | Quando envolve redaccao de conteudo |
```
mcp__notebooklm__notebook_query({
notebook_id: "4c595973-ba10-420a-a3bf-e4389e424ad3",
query: "<adaptar ao contexto>"
})
mcp__notebooklm__notebook_query({
notebook_id: "7b8fec17-d34f-4e3f-a8c6-8231e51f6323",
query: "<adaptar — ex: headlines persuasivas, CTAs, copywriting PT-PT>"
})
```
**Procedimento relacionado:** `PROC-Guia-PT-PT.md` -- consultar para garantir redaccao correcta em portugues europeu.
---
## Quando Usar
- Escrever artigos blog, landing pages, emails marketing
- Definir tom de voz para marca/projecto
- Criar copy para CTAs, headlines, descrições
- Adaptar conteúdo BR → PT-PT
- Estruturar estratégia editorial
- Criar copy para CTAs, headlines, descricoes
- Adaptar conteudo BR -> PT-PT
- Estruturar estrategia editorial
- Implementar storytelling e narrativas
- Optimizar conteúdo para conversão
- Optimizar conteudo para conversao
---
## 🗣️ Tom de Voz PT-PT (Standards 2026)
## Tom de Voz PT-PT (Standards 2026)
### Regras Obrigatórias
### Regras Obrigatorias
```markdown
✅ SEMPRE:
- **Tratamento**: "tu" (informal B2C), "você" (formal B2B), ou impessoal
- **Verbos Infinitivos**: "Clique aqui" → "Clicar aqui" (instruções)
- **Vocabulário Europeu**:
- ficheiro (não arquivo)
- ecrã (não tela)
- telemóvel (não celular)
- aplicação (não app em contexto formal)
- download → descarregar
- upload → carregar
- **Moeda**: 95€ (símbolo DEPOIS do valor, sem centavos excepto quando relevante)
- **Datas**: 3 de Fevereiro de 2026 (não 3 de fevereiro)
- **Números**: 1.500 (ponto milhares) | 1,50€ (vírgula decimais)
**SEMPRE:**
- **Tratamento**: "tu" (informal B2C), "voce" (formal B2B), ou impessoal
- **Verbos Infinitivos**: "Clique aqui" -> "Clicar aqui" (instrucoes)
- **Vocabulario Europeu**: ficheiro (nao arquivo), ecra (nao tela), telemovel (nao celular), aplicacao (nao app em contexto formal), download -> descarregar, upload -> carregar
- **Moeda**: 95EUR (simbolo DEPOIS do valor)
- **Datas**: 3 de Fevereiro de 2026
- **Numeros**: 1.500 (ponto milhares) | 1,50EUR (virgula decimais)
❌ NUNCA:
**NUNCA:**
- **Brasileirismos**: deletar, rodar, plugar, startar, printar
- **Anglicismos desnecessários**: "fazer o deploy" → "implementar"
- **Excesso emojis**: Máximo 1-2 por texto profissional B2B
- **Exclamações excessivas**: Máximo 1 por parágrafo B2C, 0 B2B
- **Gírias**: "tranquilo", "beleza", "bacana" → Substituir por neutro
```
- **Anglicismos desnecessarios**: "fazer o deploy" -> "implementar"
- **Excesso emojis**: Maximo 1-2 por texto profissional B2B
- **Exclamacoes excessivas**: Maximo 1 por paragrafo B2C, 0 B2B
- **Girias**: "tranquilo", "beleza", "bacana" -> Substituir por neutro
### Tom por Contexto
| Contexto | Tom | Exemplo |
|----------|-----|---------|
| **B2B Corporativo** | Formal, técnico, autoridade | "A solução optimiza processos empresariais" |
| **B2C Casual** | Informal, próximo, empático | "Vamos tornar isto mais simples para ti" |
| **E-commerce** | Persuasivo, benefício, urgência | "Poupa 30% hoje. Promoção termina em 24h" |
| **Educacional** | Claro, didáctico, encorajador | "Aprende passo a passo. Dominas em 30 dias" |
| **B2B Corporativo** | Formal, tecnico, autoridade | "A solucao optimiza processos empresariais" |
| **B2C Casual** | Informal, proximo, empatico | "Vamos tornar isto mais simples para ti" |
| **E-commerce** | Persuasivo, beneficio, urgencia | "Poupa 30% hoje. Promocao termina em 24h" |
| **Educacional** | Claro, didactico, encorajador | "Aprende passo a passo. Dominas em 30 dias" |
| **Institucional** | Neutro, factual, transparente | "A empresa fundada em 2010 serve 500+ clientes" |
---
## 📝 Estrutura de Artigos (Framework AIDA+)
## Estrutura de Artigos (Framework AIDA+)
### 1. HEADLINE (5-10 palavras, benefício claro)
**Fórmulas Testadas:**
```
[Número] + [Adjectivo] + [Substantivo] + [Promessa/Benefício]
"7 Estratégias Comprovadas para Duplicar Vendas em 90 Dias"
[Como] + [Conseguir Resultado] + [Sem Obstáculo]
"Como Gerar Leads Qualificados Sem Gastar em Publicidade"
[Resultado] + [em Tempo] + [para Audiência]
"10.000 Visitantes/Mês em 6 Meses para PMEs Portuguesas"
```
### 1. HEADLINE (5-10 palavras, beneficio claro)
**Checklist Headline:**
- [ ] Inclui número (quando relevante)
- [ ] Benefício claro e específico
- [ ] Target audience identificável
- [ ] Urgência/prazo (quando aplicável)
- [ ] Inclui numero (quando relevante)
- [ ] Beneficio claro e especifico
- [ ] Target audience identificavel
- [ ] Urgencia/prazo (quando aplicavel)
- [ ] < 70 caracteres
- [ ] Keyword principal incluída (SEO)
- [ ] Keyword principal incluida (SEO)
### 2. LEAD / Hook (2-3 frases, ganhar atenção)
### 2. LEAD / Hook (2-3 frases, ganhar atencao)
**Framework PAS (Problem-Agitate-Solution):**
```markdown
**Problema**: [Identificar dor específica]
"95% das PMEs portuguesas falham em SEO porque não têm tempo ou conhecimento."
**Agitar**: [Amplificar consequências]
"Enquanto isso, concorrentes dominam o Google, roubam clientes e crescem 3x mais rápido."
**Solução** (teaser): [Apresentar caminho]
"Existe uma forma comprovada de mudar isto. Sem precisar contratar agência."
```
- **Problema**: Identificar dor especifica
- **Agitar**: Amplificar consequencias
- **Solucao** (teaser): Apresentar caminho
### 3. CORPO (Estrutura Escalar)
```markdown
## Introdução (100-150 palavras)
- Expandir lead
- Prometer valor
- Teaser do que vem
## Secção 1: [Subtítulo H2 com keyword secundária]
### Subsecção 1.1 (H3)
- Ponto
- Exemplo prático
- Dados/estatísticas
### Subsecção 1.2 (H3)
- ...
## Secção 2: [Subtítulo H2]
...
## Secção 3: FAQ / Objecções Comuns
- Antecipar dúvidas
- Remover fricção
## Conclusão (80-100 palavras)
- Resumir pontos principais
- Reforçar benefício
- CTA claro
```
## Introducao (100-150 palavras)
## Seccao 1: [Subtitulo H2 com keyword secundaria]
### Subseccao 1.1 (H3)
## Seccao 2: [Subtitulo H2]
## Seccao 3: FAQ / Objecoes Comuns
## Conclusao (80-100 palavras) + CTA claro
```
### 4. CTA (Call-to-Action)
**Anatomia CTA Eficaz:**
```
[Verbo Acção] + [Benefício Imediato] + [Redução Fricção]
✅ "Começar teste gratuito (sem cartão de crédito)"
✅ "Descarregar guia completo (4 minutos de leitura)"
✅ "Agendar demonstração (15 min, sem compromisso)"
❌ "Clique aqui" (vago)
❌ "Submeter" (técnico, frio)
❌ "Comprar agora!!!" (agressivo)
```
Anatomia: [Verbo Accao] + [Beneficio Imediato] + [Reducao Friccao]
---
## 🎨 Copywriting Patterns 2026
### Headlines (Testar 3-5 variações)
| Padrão | Fórmula | Exemplo PT-PT | Uso |
|--------|---------|---------------|-----|
| **Número + Benefício** | [X] formas de [resultado] | "5 Formas de Duplicar Conversões" | Blog, listas |
| **Como Fazer** | Como [resultado] em [tempo] | "Como Gerar Leads em 30 Dias" | Tutoriais |
| **Pergunta Provocativa** | [Pergunta dor/desejo]? | "Perder Clientes para Concorrência?" | Landing pages |
| **Caso/Estudo** | Como [empresa] conseguiu [resultado] | "Como a XYZ Cresceu 300% em 6 Meses" | Case studies |
| **Contrarian** | Porque [crença comum] está errada | "Porque SEO Não Funciona (e o que fazer)" | Thought leadership |
### Body Copy
```markdown
### Parágrafos Curtos (2-4 linhas)
Facilita leitura em mobile. Evita "walls of text". Aumenta engagement.
### Listas e Bullets
- Escaneabilidade
- Destaque pontos chave
- Melhor retenção
### Transições Subtis
Primeiro, vamos ver X. **Depois**, exploramos Y. **Por fim**, implementamos Z.
### Voz Activa > Passiva
✅ "Implementamos a solução em 3 dias" (activa)
❌ "A solução foi implementada em 3 dias" (passiva)
### Dados Específicos > Genéricos
✅ "127% aumento em conversões"
❌ "Grande aumento em conversões"
```
### CTAs por Funil
| Fase Funil | Objectivo | CTA Example | Fricção |
|------------|-----------|-------------|---------|
| **ToFu (Awareness)** | Educar | "Ler guia completo" | Muito baixa |
| **MoFu (Consideration)** | Engajar | "Experimentar ferramenta gratuita" | Baixa |
| **BoFu (Decision)** | Converter | "Falar com consultor (15 min)" | Média |
| **Retention** | Fidelizar | "Actualizar para plano Pro (30% off)" | Baixa-Média |
---
## 📊 Formatos de Conteúdo 2026
## Formatos de Conteudo 2026
### Blog Post (Pilar Content)
| Métrica | Valor | Nota |
| Metrica | Valor | Nota |
|---------|-------|------|
| **Extensão** | 1200-2500 palavras | Topics competitivos: 2000+ |
| **Extensao** | 1200-2500 palavras | Topics competitivos: 2000+ |
| **Estrutura** | H1 + 4-6 H2 + CTA | Hierarquia clara |
| **Imagens** | 3-5 (1 hero + 2-4 suporte) | Alt text obrigatório |
| **Imagens** | 3-5 (1 hero + 2-4 suporte) | Alt text obrigatorio |
| **Tempo leitura** | 5-10 minutos | Indicar no topo |
| **Internal links** | 3-5 relevantes | Distribuídos naturalmente |
| **External links** | 1-3 autoritativos | DR > 40 preferível |
| **CTA** | 2-3 (início, meio, fim) | Diferentes níveis compromisso |
**Checklist:**
- [ ] Keyword research (volume > 100, KD < 60)
- [ ] Título optimizado SEO (50-60 chars)
- [ ] Meta description (150-160 chars)
- [ ] Estrutura AIDA+
- [ ] FAQ section (featured snippets)
- [ ] Autor + bio (E-E-A-T)
- [ ] Data publicação + actualização
### Landing Page (Conversão)
| Elemento | Best Practice | Impacto Conversão |
|----------|---------------|-------------------|
| **Hero** | Benefício claro em 5 segundos | +40% |
| **Social Proof** | Testemunhos (foto + nome + empresa) | +35% |
| **Above-the-fold CTA** | Visível sem scroll | +25% |
| **Urgência** | Countdown, stock limitado | +20% |
| **Garantia** | Money-back, teste gratuito | +15% |
| **Remover navegação** | Foco no CTA único | +10% |
**Estrutura Testada:**
```
1. Hero (Headline + Subheadline + CTA + Imagem)
2. Social Proof (Logos clientes / Testemunho)
3. Benefícios (3 principais com ícones)
4. Como Funciona (3 passos simples)
5. Features (com screenshots/vídeo)
6. Testemunhos (2-3 detalhados)
7. Objecções / FAQ
8. CTA Final (urgência + garantia)
```
| **Internal links** | 3-5 relevantes | Distribuidos naturalmente |
| **External links** | 1-3 autoritativos | DR > 40 preferivel |
| **CTA** | 2-3 (inicio, meio, fim) | Diferentes niveis compromisso |
### Email Marketing
| Tipo | Subject Line | Extensão | CTA | Taxa Abertura Target |
| Tipo | Subject Line | Extensao | CTA | Taxa Abertura Target |
|------|--------------|----------|-----|----------------------|
| **Newsletter** | Curiosidade + emoji | 150-300 palavras | 1 primário | 20-25% |
| **Promocional** | Benefício + urgência | 100-200 palavras | 1 bold | 15-20% |
| **Newsletter** | Curiosidade | 150-300 palavras | 1 primario | 20-25% |
| **Promocional** | Beneficio + urgencia | 100-200 palavras | 1 bold | 15-20% |
| **Nurturing** | Educacional, valor | 200-400 palavras | 1 soft | 25-30% |
| **Transacional** | Claro, directo | 50-150 palavras | 1-2 acções | 40-50% |
**Subject Lines (PT-PT):**
```
✅ "Emanuel, esta estratégia pode duplicar leads 📈"
✅ "Última oportunidade: 40% desconto termina hoje"
✅ "5 erros comuns em SEO (estás a cometer o #3?)"
❌ "Newsletter Fevereiro" (genérico)
❌ "COMPRE AGORA!!!" (spam)
❌ "Re: Re: Proposta" (confuso)
```
| **Transacional** | Claro, directo | 50-150 palavras | 1-2 accoes | 40-50% |
### Social Media Posts (PT-PT)
| Plataforma | Extensão | Tom | Hashtags | Emojis |
|------------|----------|-----|----------|--------|
| **LinkedIn** | 150-300 chars | Profissional, insights | 3-5 | 0-1 |
| **Instagram** | 100-150 chars | Inspiracional, visual | 10-15 | 2-3 |
| **Facebook** | 40-80 chars | Conversacional | 1-3 | 1-2 |
| **Twitter/X** | 100-280 chars | Directo, opiniões | 1-2 | 0-1 |
**Framework:**
```
Hook (primeira linha capta atenção)
↓
Value/Insight (conteúdo útil)
↓
CTA (pergunta, link, partilha)
```
| Plataforma | Extensao | Tom | Hashtags |
|------------|----------|-----|----------|
| **LinkedIn** | 150-300 chars | Profissional, insights | 3-5 |
| **Instagram** | 100-150 chars | Inspiracional, visual | 10-15 |
| **Facebook** | 40-80 chars | Conversacional | 1-3 |
| **Twitter/X** | 100-280 chars | Directo, opinioes | 1-2 |
---
## ✅ Checklist Pré-Publicação
## Checklist Pre-Publicacao
### Técnico (SEO)
- [ ] Português europeu validado (zero brasileirismos)
- [ ] Keyword principal no título (primeiros 60 chars)
### Tecnico (SEO)
- [ ] Portugues europeu validado (zero brasileirismos)
- [ ] Keyword principal no titulo (primeiros 60 chars)
- [ ] Meta description optimizada (150-160 chars)
- [ ] Headings hierárquicos (H1 única, H2-H6 lógicos)
- [ ] Headings hierarquicos (H1 unica, H2-H6 logicos)
- [ ] Alt text descritivo em todas as imagens
- [ ] Internal links (3-5 relevantes)
- [ ] External links autoritativos (1-3, DR > 40)
### Conteúdo (Qualidade)
- [ ] Headlines com benefício claro
- [ ] Parágrafos curtos (< 4 linhas)
- [ ] Listas para informação complexa
- [ ] Exemplos práticos / casos reais
- [ ] Dados/estatísticas (com fontes)
### Conteudo (Qualidade)
- [ ] Headlines com beneficio claro
- [ ] Paragrafos curtos (< 4 linhas)
- [ ] Listas para informacao complexa
- [ ] Exemplos praticos / casos reais
- [ ] Dados/estatisticas (com fontes)
- [ ] FAQ section (min 3 perguntas)
### Conversão (CTA)
- [ ] CTA específico e accionável
- [ ] Benefício imediato claro
- [ ] Redução fricção (sem cartão, gratuito, etc.)
- [ ] Múltiplos CTAs (diferentes compromissos)
- [ ] Urgência/escassez (quando aplicável)
### Conversao (CTA)
- [ ] CTA especifico e accionavel
- [ ] Beneficio imediato claro
- [ ] Reducao friccao (sem cartao, gratuito, etc.)
### E-E-A-T (Trust)
- [ ] Autor identificado (nome + foto)
- [ ] Bio autor (credenciais + experiência)
- [ ] Data publicação + última actualização
- [ ] Experiência real demonstrada
- [ ] Bio autor (credenciais + experiencia)
- [ ] Data publicacao + ultima actualizacao
- [ ] Fontes citadas (links externos)
---
## 📚 Ficheiros Detalhados
## References (conteudo detalhado)
Para templates e exemplos extensos, consultar:
- `content/templates.md` - Templates artigos/emails/landing pages
- `content/vocabulary.md` - Dicionário BR→PT-PT completo
- `content/examples.md` - Exemplos reais comentados
- `content/tone-of-voice.md` - Guias tom por indústria
| Ficheiro | Conteudo |
|----------|----------|
| `references/vocabulario-br-pt.md` | Tabela completa de conversao BR -> PT-PT |
| `references/templates-conteudo.md` | Templates artigo blog, email promocional, landing page |
| `references/copywriting-patterns.md` | Headlines, CTAs, storytelling, persuasao etica, CRO |
---
## 🎓 Best Practices 2026
## Anti-Patterns
### Storytelling
```markdown
**Framework Hero's Journey (Adaptado):**
1. **Mundo Ordinário** - Cliente no status quo
"Maria geria vendas manualmente. 40h/semana em Excel."
2. **Chamada Aventura** - Problema torna-se insuportável
"Perdeu €50K em oportunidades por falta de follow-up."
3. **Mentor** - Solução aparece (produto/serviço)
"Descobriu CRM Descomplicar®. Automação inteligente."
4. **Transformação** - Implementação e resultados
"Em 60 dias: 3x mais leads, 40% conversão, 20h/semana poupadas."
5. **Retorno** - Novo mundo, cliente herói
"Hoje, Maria escala vendas sem escalar equipa. ROI 400%."
```
### Persuasão Ética (Cialdini 2026)
| Princípio | Técnica PT-PT | Exemplo |
|-----------|---------------|---------|
| **Reciprocidade** | Dar valor antes de pedir | "Guia gratuito → inscrição newsletter" |
| **Compromisso** | Micro-yeses progressivos | "Teste 14 dias → plano mensal → anual" |
| **Social Proof** | Testemunhos específicos | "127 PMEs PT cresceram 200% em 6 meses" |
| **Autoridade** | Credenciais verificáveis | "Certificado Google, 15 anos experiência" |
| **Escassez** | Limitação genuína | "Apenas 5 vagas consultoria Fevereiro" |
| **Simpatia** | Tom humano, empatia | "Sabemos como é difícil gerir tudo sozinho" |
### Optimização Conversão (CRO)
```markdown
**Testes A/B Prioridade:**
1. **Headlines** (maior impacto)
2. **CTAs** (cor, texto, posição)
3. **Hero images** (contexto vs produto)
4. **Social proof** (quantidade vs qualidade)
5. **Form fields** (menos = mais conversões)
**Ferramentas:**
- Google Optimize (gratuito)
- Hotjar (heatmaps, gravações)
- Microsoft Clarity (gratuito, alternativa Hotjar)
```
- Usar brasileirismos em conteudo PT-PT
- CTAs vagos como "Clique aqui" ou "Submeter"
- Paragrafos longos (> 4 linhas) em conteudo web
- Ignorar E-E-A-T (sem autor, sem datas, sem fontes)
- Headlines sem beneficio claro ou keyword
- Excesso de anglicismos quando existe equivalente PT
---
## 🗣️ Vocabulário BR → PT-PT
| Brasileiro | Português Europeu | Contexto |
|------------|-------------------|----------|
| deletar | eliminar, apagar | Ficheiros |
| rodar | executar, correr | Programas |
| startar | iniciar, arrancar | Processos |
| printar | imprimir | Documentos |
| plugar | ligar, conectar | Dispositivos |
| baixar | descarregar | Download |
| upar | carregar | Upload |
| tela | ecrã | Dispositivos |
| celular | telemóvel | Telefone |
| arquivo | ficheiro | Documentos digitais |
| mouse | rato | Dispositivo |
| site | sítio web, site | Online (ambos OK) |
| você | tu (informal), você (formal) | Tratamento |
| tranquilo | está bem, sem problema | Confirmação |
| bacana | interessante, fixe | Qualidade |
| legal | bom, giro | Aprovação |
---
## 📚 Datasets Dify (Consulta Obrigatória)
| Dataset | ID | Prioridade | Uso |
|---------|----|-----------:|-----|
| **Marketing de Conteúdo** | `061f19a3-d4b6-4383-9f44-620742167201` | 1 | Estrutura artigos, formatos |
| **Copywriting** | `78e36113-cb41-4bf4-bdb1-25a3f18d9b1f` | 1 | Headlines, CTAs, persuasão |
| **Escrever PT-PT** | `8eb4682b-eff2-4366-a577-18b698d900da` | 1 | Vocabulário, gramática |
| **Blogging** | `aded3d71-ec6e-4ffb-aa52-75a3896a2e0d` | 2 | Técnicas blogging |
| **Marketing Digital** | `c1ec779f-4cb1-4ecf-ba11-6b39b93d4e24` | 2 | Estratégia geral |
| **Seth Godin** | `3a2e536c-4985-42df-9a00-f0a4dfe720a3` | 3 | Marketing moderno, narrativas |
### Como Consultar
```javascript
// Técnicas de copywriting persuasivo
mcp__notebooklm__notebook_query, mcp__dify-kb__dify_kb_retrieve_segments({
dataset_id: "78e36113-cb41-4bf4-bdb1-25a3f18d9b1f",
query: "headlines persuasivas CTA conversão"
})
// Validar português europeu
mcp__dify-kb__dify_kb_retrieve_segments({
dataset_id: "8eb4682b-eff2-4366-a577-18b698d900da",
query: "vocabulario portugues europeu brasileirismos"
})
// Estrutura de artigos blog
mcp__dify-kb__dify_kb_retrieve_segments({
dataset_id: "061f19a3-d4b6-4383-9f44-620742167201",
query: "estrutura artigo blog SEO engagement"
})
// Storytelling marketing
mcp__dify-kb__dify_kb_retrieve_segments({
dataset_id: "3a2e536c-4985-42df-9a00-f0a4dfe720a3",
query: "storytelling narrativas marketing"
})
// Landing pages optimização
mcp__dify-kb__dify_kb_retrieve_segments({
dataset_id: "061f19a3-d4b6-4383-9f44-620742167201",
query: "landing page conversão CRO"
})
```
### Quando Consultar
- **Escrever copy** para campanhas ou landing pages
- **Verificar vocabulário** PT-PT (eliminar brasileirismos)
- **Estruturar artigos** de blog ou guias
- **Criar headlines** e CTAs eficazes
- **Estratégia storytelling** e narrativas
- **Optimizar conversão** (CRO)
---
## 🎯 Templates Prontos
### Template Artigo Blog (1500 palavras)
```markdown
---
title: [Headline Optimizado SEO]
description: [Meta description 150-160 chars]
author: [Nome Autor]
date: YYYY-MM-DD
keywords: [keyword1, keyword2, keyword3]
---
# [H1 - Headline Principal]
**Tempo de leitura: X minutos**
## Introdução
[Lead/Hook - Problema + Agitação + Teaser solução - 100-150 palavras]
[CTA Suave: "Ler guia completo →"]
## [H2 - Secção 1: Keyword Secundária]
[Conteúdo 300-400 palavras]
### [H3 - Subsecção 1.1]
- Ponto chave
- Exemplo prático
- Dados/estatísticas
[Imagem com alt text]
### [H3 - Subsecção 1.2]
[...]
## [H2 - Secção 2: Keyword Secundária]
[Conteúdo 300-400 palavras]
[CTA Médio: "Experimentar ferramenta gratuita →"]
## [H2 - FAQ / Perguntas Frequentes]
**1. [Pergunta comum]?**
[Resposta 40-60 palavras]
**2. [Pergunta comum]?**
[Resposta 40-60 palavras]
**3. [Pergunta comum]?**
[Resposta 40-60 palavras]
## Conclusão
[Resumir pontos principais - 80-100 palavras]
[CTA Final Forte: "Agendar demonstração gratuita (15 min) →"]
---
**Sobre o Autor:**
[Nome] é [Cargo] na [Empresa]. Com X anos de experiência em [Área], ajudou X+ empresas a [Resultado].
**Leituras Relacionadas:**
- [Link interno 1]
- [Link interno 2]
- [Link interno 3]
```
### Template Email Promocional
```markdown
**Subject:** [Nome], esta oferta termina hoje às 23:59 🔥
Olá [Nome],
[Hook - Benefício imediato em 1 frase]
**40% desconto em todos os planos. Hoje é o último dia.**
O que consegues com [Produto]:
✓ [Benefício 1 específico]
✓ [Benefício 2 específico]
✓ [Benefício 3 específico]
[Social Proof - "125 empresas PT já aderiram esta semana"]
**[CTA Button: "Activar desconto 40% →"]**
Sem compromissos. Cancelas quando quiseres.
Garantia 30 dias dinheiro de volta.
Até breve,
[Nome]
[Cargo] @ [Empresa]
P.S. Promoção termina hoje às 23:59. Não percas.
[CTA Link: "Resgatar desconto →"]
```
---
## 📈 Instrumentação Automática
```sql
INSERT INTO tblskill_agent_metrics (
type, name, duration_ms, status, staff_id,
kb_consulted, kb_cache_hit, tool_calls, project_id
) VALUES (
'skill', '/content-marketing-pt', {DURACAO_MS}, '{STATUS}', 25,
{KB_CONSULTADO}, {CACHE_HIT}, {TOOL_CALLS}, {PROJECT_ID}
);
```
---
**Versão**: 2.0.0 | **Autor**: Descomplicar® | **Data**: 2026-02-03
**Desk Task:** #1466 | **Standards:** PT-PT rigoroso, Copywriting 2026, E-E-A-T
**Versao**: 2.1.0 | **Autor**: Descomplicar

112
marketing/skills/content-marketing-pt/references/copywriting-patterns.md Normal file
View File

@@ -0,0 +1,112 @@
# Copywriting Patterns 2026
## Headlines (Testar 3-5 variacoes)
| Padrao | Formula | Exemplo PT-PT | Uso |
|--------|---------|---------------|-----|
| **Numero + Beneficio** | [X] formas de [resultado] | "5 Formas de Duplicar Conversoes" | Blog, listas |
| **Como Fazer** | Como [resultado] em [tempo] | "Como Gerar Leads em 30 Dias" | Tutoriais |
| **Pergunta Provocativa** | [Pergunta dor/desejo]? | "Perder Clientes para Concorrencia?" | Landing pages |
| **Caso/Estudo** | Como [empresa] conseguiu [resultado] | "Como a XYZ Cresceu 300% em 6 Meses" | Case studies |
| **Contrarian** | Porque [crenca comum] esta errada | "Porque SEO Nao Funciona (e o que fazer)" | Thought leadership |
## Formulas Headline Testadas
```
[Numero] + [Adjectivo] + [Substantivo] + [Promessa/Beneficio]
"7 Estrategias Comprovadas para Duplicar Vendas em 90 Dias"
[Como] + [Conseguir Resultado] + [Sem Obstaculo]
"Como Gerar Leads Qualificados Sem Gastar em Publicidade"
[Resultado] + [em Tempo] + [para Audiencia]
"10.000 Visitantes/Mes em 6 Meses para PMEs Portuguesas"
```
## Body Copy
### Paragrafos Curtos (2-4 linhas)
Facilita leitura em mobile. Evita "walls of text". Aumenta engagement.
### Listas e Bullets
- Escaneabilidade
- Destaque pontos chave
- Melhor retencao
### Transicoes Subtis
Primeiro, vamos ver X. **Depois**, exploramos Y. **Por fim**, implementamos Z.
### Voz Activa > Passiva
- "Implementamos a solucao em 3 dias" (activa)
- "A solucao foi implementada em 3 dias" (passiva) -- evitar
### Dados Especificos > Genericos
- "127% aumento em conversoes" (especifico)
- "Grande aumento em conversoes" (generico) -- evitar
## CTAs por Funil
| Fase Funil | Objectivo | CTA Exemplo | Friccao |
|------------|-----------|-------------|---------|
| **ToFu (Awareness)** | Educar | "Ler guia completo" | Muito baixa |
| **MoFu (Consideration)** | Engajar | "Experimentar ferramenta gratuita" | Baixa |
| **BoFu (Decision)** | Converter | "Falar com consultor (15 min)" | Media |
| **Retention** | Fidelizar | "Actualizar para plano Pro (30% off)" | Baixa-Media |
## Anatomia CTA Eficaz
```
[Verbo Accao] + [Beneficio Imediato] + [Reducao Friccao]
BOM:
- "Comecar teste gratuito (sem cartao de credito)"
- "Descarregar guia completo (4 minutos de leitura)"
- "Agendar demonstracao (15 min, sem compromisso)"
MAU:
- "Clique aqui" (vago)
- "Submeter" (tecnico, frio)
- "Comprar agora!!!" (agressivo)
```
## Storytelling (Framework Hero's Journey Adaptado)
1. **Mundo Ordinario** - Cliente no status quo
"Maria geria vendas manualmente. 40h/semana em Excel."
2. **Chamada Aventura** - Problema torna-se insuportavel
"Perdeu 50.000EUR em oportunidades por falta de follow-up."
3. **Mentor** - Solucao aparece (produto/servico)
"Descobriu CRM Descomplicar. Automacao inteligente."
4. **Transformacao** - Implementacao e resultados
"Em 60 dias: 3x mais leads, 40% conversao, 20h/semana poupadas."
5. **Retorno** - Novo mundo, cliente heroi
"Hoje, Maria escala vendas sem escalar equipa. ROI 400%."
## Persuasao Etica (Cialdini 2026)
| Principio | Tecnica PT-PT | Exemplo |
|-----------|---------------|---------|
| **Reciprocidade** | Dar valor antes de pedir | "Guia gratuito -> inscricao newsletter" |
| **Compromisso** | Micro-yeses progressivos | "Teste 14 dias -> plano mensal -> anual" |
| **Social Proof** | Testemunhos especificos | "127 PMEs PT cresceram 200% em 6 meses" |
| **Autoridade** | Credenciais verificaveis | "Certificado Google, 15 anos experiencia" |
| **Escassez** | Limitacao genuina | "Apenas 5 vagas consultoria Fevereiro" |
| **Simpatia** | Tom humano, empatia | "Sabemos como e dificil gerir tudo sozinho" |
## Optimizacao Conversao (CRO)
**Testes A/B Prioridade:**
1. **Headlines** (maior impacto)
2. **CTAs** (cor, texto, posicao)
3. **Hero images** (contexto vs produto)
4. **Social proof** (quantidade vs qualidade)
5. **Form fields** (menos = mais conversoes)
**Ferramentas:**
- Google Optimize (gratuito)
- Hotjar (heatmaps, gravacoes)
- Microsoft Clarity (gratuito, alternativa Hotjar)

129
marketing/skills/content-marketing-pt/references/templates-conteudo.md Normal file
View File

@@ -0,0 +1,129 @@
# Templates de Conteudo
## Template Artigo Blog (1500 palavras)
```markdown
---
title: [Headline Optimizado SEO]
description: [Meta description 150-160 chars]
author: [Nome Autor]
date: YYYY-MM-DD
keywords: [keyword1, keyword2, keyword3]
---
# [H1 - Headline Principal]
**Tempo de leitura: X minutos**
## Introducao
[Lead/Hook - Problema + Agitacao + Teaser solucao - 100-150 palavras]
[CTA Suave: "Ler guia completo"]
## [H2 - Seccao 1: Keyword Secundaria]
[Conteudo 300-400 palavras]
### [H3 - Subseccao 1.1]
- Ponto chave
- Exemplo pratico
- Dados/estatisticas
[Imagem com alt text]
### [H3 - Subseccao 1.2]
[...]
## [H2 - Seccao 2: Keyword Secundaria]
[Conteudo 300-400 palavras]
[CTA Medio: "Experimentar ferramenta gratuita"]
## [H2 - FAQ / Perguntas Frequentes]
**1. [Pergunta comum]?**
[Resposta 40-60 palavras]
**2. [Pergunta comum]?**
[Resposta 40-60 palavras]
**3. [Pergunta comum]?**
[Resposta 40-60 palavras]
## Conclusao
[Resumir pontos principais - 80-100 palavras]
[CTA Final Forte: "Agendar demonstracao gratuita (15 min)"]
---
**Sobre o Autor:**
[Nome] e [Cargo] na [Empresa]. Com X anos de experiencia em [Area], ajudou X+ empresas a [Resultado].
**Leituras Relacionadas:**
- [Link interno 1]
- [Link interno 2]
- [Link interno 3]
```
---
## Template Email Promocional
```markdown
**Subject:** [Nome], esta oferta termina hoje as 23:59
Ola [Nome],
[Hook - Beneficio imediato em 1 frase]
**40% desconto em todos os planos. Hoje e o ultimo dia.**
O que consegues com [Produto]:
- [Beneficio 1 especifico]
- [Beneficio 2 especifico]
- [Beneficio 3 especifico]
[Social Proof - "125 empresas PT ja aderiram esta semana"]
**[CTA Button: "Activar desconto 40%"]**
Sem compromissos. Cancelas quando quiseres.
Garantia 30 dias dinheiro de volta.
Ate breve,
[Nome]
[Cargo] @ [Empresa]
P.S. Promocao termina hoje as 23:59. Nao percas.
[CTA Link: "Resgatar desconto"]
```
---
## Template Landing Page (Estrutura Testada)
```
1. Hero (Headline + Subheadline + CTA + Imagem)
2. Social Proof (Logos clientes / Testemunho)
3. Beneficios (3 principais com icones)
4. Como Funciona (3 passos simples)
5. Features (com screenshots/video)
6. Testemunhos (2-3 detalhados)
7. Objecoes / FAQ
8. CTA Final (urgencia + garantia)
```
| Elemento | Best Practice | Impacto Conversao |
|----------|---------------|-------------------|
| **Hero** | Beneficio claro em 5 segundos | +40% |
| **Social Proof** | Testemunhos (foto + nome + empresa) | +35% |
| **Above-the-fold CTA** | Visivel sem scroll | +25% |
| **Urgencia** | Countdown, stock limitado | +20% |
| **Garantia** | Money-back, teste gratuito | +15% |
| **Remover navegacao** | Foco no CTA unico | +10% |

22
marketing/skills/content-marketing-pt/references/vocabulario-br-pt.md Normal file
View File

@@ -0,0 +1,22 @@
# Vocabulario BR -> PT-PT
Tabela de conversao de brasileirismos para portugues europeu.
| Brasileiro | Portugues Europeu | Contexto |
|------------|-------------------|----------|
| deletar | eliminar, apagar | Ficheiros |
| rodar | executar, correr | Programas |
| startar | iniciar, arrancar | Processos |
| printar | imprimir | Documentos |
| plugar | ligar, conectar | Dispositivos |
| baixar | descarregar | Download |
| upar | carregar | Upload |
| tela | ecra | Dispositivos |
| celular | telemovel | Telefone |
| arquivo | ficheiro | Documentos digitais |
| mouse | rato | Dispositivo |
| site | sitio web, site | Online (ambos OK) |
| voce | tu (informal), voce (formal) | Tratamento |
| tranquilo | esta bem, sem problema | Confirmacao |
| bacana | interessante, fixe | Qualidade |
| legal | bom, giro | Aprovacao |

77
marketing/skills/lead-approach/SKILL.md
View File

@@ -1,62 +1,37 @@
---
name: lead-approach
description: >
Abordagem estratégica de leads com análise completa, estratégia de proposta e primeiro contacto. Lança agentes especializados em paralelo (marketing-planning-expert, sales-manager), consulta datasets Dify, cria documento proposta e actualiza CRM. Use when new lead to approach, abandoned lead recovery, or when user mentions "lead", "abordagem", "proposta", "estratégia comercial", "primeiro contacto".
author: Descomplicar® Crescimento Digital
version: 1.1.0
quality_score: 80
user_invocable: true
category: business
tags: [leads, sales, strategy, approach, marketing, crm, agents, parallel-execution]
desk_task: 1475
desk_project: 65
allowed-tools: Read, Write, Bash, mcp__desk-crm-v3, mcp__dify-kb, WebFetch
mcps: desk-crm-v3, dify-kb
agents:
- name: marketing-planning-expert
usage: Strategy, packages, differentiation
- name: sales-manager
usage: Approach, templates, follow-up
datasets:
- id: c1ec779f-4cb1-4ecf-ba11-6b39b93d4e24
name: Marketing Digital
priority: 1
usage: Lead generation strategies, funnel
- id: a7ba6005-517c-41ab-ac5e-da1c1a1c62ef
name: Vendas
priority: 1
usage: Sales techniques, objection handling
- id: bd65f36e-6004-4584-b478-129b2c21b4d2
name: Serviços Descomplicar
priority: 1
usage: Packages, pricing
- id: c8489151-de94-42b2-8cee-c0b961cfac6d
name: Websites
priority: 2
usage: Website features
dependencies:
skills: [orcamento]
mcps: [desk-crm-v3, dify-kb]
agents: [marketing-planning-expert, sales-manager]
triggers:
- "User mentions 'lead', 'abordagem', 'approach'"
- "New lead to process"
- "Abandoned lead recovery"
- "User says 'estratégia comercial', 'proposta'"
parallel_execution:
enabled: true
agents: [marketing-planning-expert, sales-manager]
performance:
baseline_duration_ms: 1500000
target_duration_ms: 720000
last_run_duration_ms: null
success_rate: 0.90
description: Abordagem estratégica de leads com análise completa, estratégia de proposta e primeiro contacto. Lança agentes especializados em paralelo, consulta datasets Dify, cria proposta e actualiza CRM.
---
# Skill /lead-approach - Abordagem Estratégica de Leads
Skill para analisar leads e criar estratégia de abordagem completa, usando agentes especializados e datasets Dify.
## Contexto NotebookLM
ANTES de executar, consultar notebooks para contexto especializado:
| Notebook | ID | Consultar quando |
|----------|-----|-----------------|
| Copywriting e Persuasão | `7b8fec17` | Sempre |
| Marketing Digital PT | `4c595973` | Para contexto do mercado PT |
```
mcp__notebooklm__notebook_query({
notebook_id: "7b8fec17-d34f-4e3f-a8c6-8231e51f6323",
query: "<adaptar ao contexto — ex: abordagem comercial, email primeiro contacto, persuasão>"
})
mcp__notebooklm__notebook_query({
notebook_id: "4c595973-ba10-420a-a3bf-e4389e424ad3",
query: "<adaptar — ex: mercado português, leads PME, estratégia digital PT>"
})
```
Integrar insights do NotebookLM nas recomendações e decisões.
---
## Quando Usar
- Novo lead para abordar

566
marketing/skills/marketing-strategy/SKILL.md
View File

@@ -1,538 +1,144 @@
---
name: marketing-strategy
description: Marketing strategy development for Portuguese SMEs. Creates comprehensive
marketing plans with channel mix and budget allocation. Use when user mentions "marketing
strategy", "estratégia marketing", "plano marketing", "marketing plan", "marketing
budget".
author: Descomplicar® Crescimento Digital
version: 2.0.0
quality_score: 55
user_invocable: true
desk_task:
- TBD
allowed-tools: Edit
description: Desenvolvimento de estrategia de marketing para PMEs portuguesas. Cria planos completos com mix de canais e alocacao de orcamento.
---
# /marketing-strategy
Estratégia de marketing digital integrada com frameworks modernos 2026.
Estrategia de marketing digital integrada com frameworks modernos 2026.
---
## 🎯 Triggers
- "Estratégia marketing", "plano marketing"
- "Growth", "go-to-market", "GTM"
- "Posicionamento", "diferenciação"
- "OKRs", "KPIs marketing"
- "Análise mercado", "concorrência"
## Contexto NotebookLM
---
ANTES de executar, consultar notebooks para contexto especializado:
## 📊 Framework Estratégico (5 Fases)
| Notebook | ID | Consultar quando |
|----------|-----|-----------------|
| Marketing Digital PT | `4c595973` | Sempre |
| Marketing Digital Avancado | `76647e0f` | Para estrategias complexas |
### Fase 1: Análise de Situação (Research)
```
mcp__notebooklm__notebook_query({
notebook_id: "4c595973-ba10-420a-a3bf-e4389e424ad3",
query: "<adaptar ao contexto do pedido>"
})
```markdown
**1.1 Análise de Mercado**
Tamanho e Crescimento:
- TAM (Total Addressable Market): €XXM
- SAM (Serviceable Available Market): €XXM
- SOM (Serviceable Obtainable Market): €XXM
- CAGR (Taxa Crescimento): X%/ano
Tendências:
- [Tendência 1 relevante]
- [Tendência 2 relevante]
- [Oportunidade/Ameaça]
Barreiras Entrada:
- Capital inicial: €XX
- Regulação: [Licenças necessárias]
- Know-how técnico: [Nível complexidade]
---
**1.2 Análise Concorrência (Porter's 5 Forces)**
Rivalidade Actual:
- Principais players: [TOP 3 concorrentes]
- Market share: [% mercado]
- Posicionamento: [Como se posicionam]
Ameaça Novos Entrantes: BAIXA / MÉDIA / ALTA
Poder Negocial Fornecedores: BAIXO / MÉDIO / ALTO
Poder Negocial Clientes: BAIXO / MÉDIO / ALTO
Ameaça Substitutos: BAIXA / MÉDIA / ALTA
---
**1.3 Análise Interna (SWOT)**
Strengths (Forças):
- [Vantagem competitiva 1]
- [Recurso único 2]
Weaknesses (Fraquezas):
- [Limitação 1]
- [Gap recursos 2]
Opportunities (Oportunidades):
- [Tendência mercado 1]
- [Nicho não explorado 2]
Threats (Ameaças):
- [Concorrente novo 1]
- [Mudança regulação 2]
mcp__notebooklm__notebook_query({
notebook_id: "76647e0f-3ae2-4c00-a0a8-f457aebf5655",
query: "<adaptar — ex: growth hacking, funil avancado, diferenciacao competitiva>"
})
```
### Fase 2: Definição Estratégica
---
#### 2.1 Segmentação e Targeting
## Quando Usar
```markdown
**Segmentos Mercado (3-5 máximo):**
- Estrategia marketing, plano marketing
- Growth, go-to-market, GTM
- Posicionamento, diferenciacao
- OKRs, KPIs marketing
- Analise mercado, concorrencia
Segmento A: [Nome Descritivo]
- Demografia: Idade, género, localização, rendimento
- Psicográfica: Valores, interesses, comportamentos
- Tamanho: X% mercado, €XXM
- Dor principal: [Problema específico]
- Solução actual: [Como resolvem hoje]
- Willingness to pay: €XX-€YY
---
[Repetir para Segmentos B, C, D]
## Framework Estrategico (5 Fases)
**Priorização (Reach/Revenue/Resources):**
### Fase 1: Analise de Situacao (Research)
| Segmento | Reach | Revenue | Resources | Score | Prioridade |
|----------|-------|---------|-----------|-------|------------|
| A | 8/10 | 9/10 | 7/10 | 24/30 | 🔴 1º |
| B | 6/10 | 7/10 | 8/10 | 21/30 | 🟡 2º |
| C | 4/10 | 5/10 | 6/10 | 15/30 | 🟢 3º |
Analise completa com:
- **Analise de Mercado**: TAM/SAM/SOM, tendencias, barreiras entrada
- **Concorrencia (Porter's 5 Forces)**: Rivalidade, ameacas, poderes negociais
- **Analise Interna (SWOT)**: Forcas, fraquezas, oportunidades, ameacas
**ICP (Ideal Customer Profile) - Segmento prioritário:**
Detalhes e templates em `references/frameworks-estrategicos.md`.
B2B:
- Indústria: [Sector específico]
- Tamanho empresa: [Nº colaboradores / receita]
- Localização: [Geografia]
- Decision makers: [Cargos que compram]
- Pain points: [3 principais dores]
- Budget: [Range investimento]
- Ciclo venda: [Tempo médio decisão]
### Fase 2: Definicao Estrategica
B2C:
- Idade: [Range]
- Localização: [Cidades principais]
- Rendimento: [Range]
- Educação: [Nível]
- Interesses: [Hobbies, valores]
- Pain points: [3 principais dores]
- Budget: [Gasto típico]
```
#### 2.1 Segmentacao e Targeting
- Identificar 3-5 segmentos maximo
- Priorizar por Reach/Revenue/Resources (matriz pontuacao)
- Definir ICP (Ideal Customer Profile) para segmento prioritario
#### 2.2 Posicionamento (Framework 4C)
```markdown
**Positioning Statement:**
Para [target audience específico]
Que [têm este problema/necessidade]
O [produto/serviço] é [categoria]
Que [benefício principal único]
Ao contrário de [alternativa/concorrente]
Nós [diferenciador único e defensável]
**Exemplo:**
Para PMEs portuguesas em crescimento
Que lutam para gerar leads qualificados online
A Descomplicar® é uma agência de crescimento digital
Que duplica leads em 90 dias com garantia ou dinheiro de volta
Ao contrário de agências tradicionais que prometem sem garantir
Nós usamos metodologia data-driven com compromisso de resultados
---
**Diferenciadores (USPs):**
1. [USP #1 - Quantificável]
"Garantia dinheiro de volta se não duplicar leads em 90 dias"
2. [USP #2 - Defensável]
"Metodologia proprietária testada em 500+ PMEs PT"
3. [USP #3 - Relevante]
"Suporte 24/7 em português, equipa dedicada"
---
**Mensagem Core (Elevator Pitch - 30 segundos):**
[2 frases que captam atenção e comunicam valor único]
"Ajudamos PMEs portuguesas a crescer online sem desperdiçar orçamento em agências que prometem mas não entregam. Garantimos duplicar os teus leads qualificados em 90 dias ou devolvemos 100% do investimento."
```
Para [target audience especifico]
Que [tem este problema/necessidade]
O [produto/servico] e [categoria]
Que [beneficio principal unico]
Ao contrario de [alternativa/concorrente]
Nos [diferenciador unico e defensavel]
```
Definir 3 USPs (quantificavel, defensavel, relevante) + Elevator Pitch 30s.
### Fase 3: Objectivos (OKRs Framework)
```markdown
**Q1 2026 OKRs:**
Definir 3-4 Objectives com Key Results mensuraveis por trimestre.
Objective 1: Dominar Aquisição de Clientes B2B
├─ KR1: 150 SQLs (Sales Qualified Leads) por mês
├─ KR2: CAC (Customer Acquisition Cost) < €800
├─ KR3: Conversion Rate SQL→Customer > 15%
└─ Owner: [Nome]
Objective 2: Estabelecer Liderança de Pensamento
├─ KR1: 50K visitas orgânicas/mês (blog + SEO)
├─ KR2: 10K seguidores LinkedIn (empresa)
├─ KR3: 5 guest posts em media tier-1 (Observador, Dinheiro Vivo)
└─ Owner: [Nome]
Objective 3: Optimizar Funil de Conversão
├─ KR1: Landing page CVR 8% (actual: 3.5%)
├─ KR2: Email nurturing open rate > 35%
├─ KR3: Demo show-up rate > 70%
└─ Owner: [Nome]
**Métricas North Star:**
- MRR (Monthly Recurring Revenue): €XXK
**Metricas North Star:**
- MRR (Monthly Recurring Revenue)
- NPS (Net Promoter Score): > 50
- LTV/CAC: > 3x
```
### Fase 4: Marketing Mix Digital
#### 4.1 Canais por Funnel Stage
Canais organizados por funnel stage:
```
📢 AWARENESS (ToFu)
├── SEO / Content Marketing (40% budget)
│ ├─ Blog posts (2x/semana)
│ ├─ Guias/Ebooks (1x/mês)
│ └─ Vídeos YouTube (1x/semana)
│
├── Social Media Orgânico (20% budget)
│ ├─ LinkedIn (5x/semana)
│ ├─ Instagram (3x/semana)
│ └─ TikTok (experimental, 2x/semana)
│
└── Paid Ads - Display/Video (20% budget)
├─ Google Display
├─ YouTube Ads
└─ Meta Ads (Awareness)
| Fase | Canais Principais | % Budget |
|------|-------------------|----------|
| **Awareness (ToFu)** | SEO/Content, Social Organico, Paid Display | 80% |
| **Consideration (MoFu)** | Email Nurturing, Webinars, Retargeting | 20% |
| **Conversion (BoFu)** | Search Ads, Landing Pages, Sales Enablement | (incluso acima) |
| **Retention** | Customer Success, Email, Community, Referral | (organico) |
🤔 CONSIDERATION (MoFu)
├── Email Nurturing (5% budget)
│ ├─ Welcome series (5 emails)
│ ├─ Educational series
│ └─ Case studies
│
├── Webinars/Lives (5% budget)
│ ├─ 1x/mês tema específico
│ └─ Recording → lead magnet
│
└── Retargeting (10% budget)
├─ Google Ads Remarketing
└─ Meta Ads Retargeting
### Fase 5: Execucao e Optimizacao
💰 CONVERSION (BoFu)
├── Search Ads (High-intent keywords)
├── Landing Pages Optimizadas
├── Sales Enablement (Case studies, demos)
└─ Free Trial/Demo (reduzir fricção)
**Roadmap Trimestral:**
- **Mes 1**: Fundacao -- Setup (Pixel, Analytics, CRM), Content pillar #1, Ads inicial
- **Mes 2**: Teste -- Content pillar #2, A/B test landing pages, Escalar winning ads
- **Mes 3**: Optimizacao -- Content pillar #3, guest posts, Webinar, Review + planeamento
🔄 RETENTION & ADVOCACY
├── Customer Success (Onboarding, training)
├── Email Marketing (Updates, tips, upsell)
├── Community (Grupo privado, eventos)
└── Referral Program (Incentivos)
```
#### 4.2 Orçamento por Canal
**Startup (< €5K/mês):**
```
40% Content/SEO → €2K
30% Paid Ads → €1.5K
20% Social Orgânico → €1K
10% Tools → €500
```
**Scale-up (€5K-€20K/mês):**
```
30% Paid Ads → €6K
25% Content/SEO → €5K
20% Social/Influencers → €4K
15% Email/Automation → €3K
10% Tools/Agency → €2K
```
**Enterprise (> €20K/mês):**
```
Full mix com especialistas dedicados por canal
Budget flexível baseado em performance (ROAS > 3x manter/escalar)
```
### Fase 5: Execução e Optimização
#### 5.1 Roadmap Trimestral (Gantt simplificado)
```
Mês 1: Fundação
├─ Semana 1-2: Setup (Pixel, Analytics, CRM)
├─ Semana 3-4: Content pillar #1 (5 artigos blog)
└─ Semana 4: Lançar campanha Ads inicial (€50/dia)
Mês 2: Teste e Aprendizagem
├─ Semana 5-6: Content pillar #2
├─ Semana 7: A/B test landing pages (3 variações)
└─ Semana 8: Escalar winning ads (+50% budget)
Mês 3: Optimização e Escala
├─ Semana 9-10: Content pillar #3 + guest posts
├─ Semana 11: Webinar #1 (lead magnet)
└─ Semana 12: Review + planeamento Q2
```
#### 5.2 Métricas e Dashboards
**Dashboard Semanal (Operacional):**
- MQLs gerados: X (target: Y)
- CAC: €X (target: < €Y)
- Website traffic: X (vs semana anterior)
- Ad spend: €X (budget restante: €Y)
- Top performing channel: [Canal]
**Dashboard Mensal (Táctico):**
- SQLs: X (conversion MQL→SQL: X%)
- Customers novos: X (conversion SQL→Customer: X%)
- MRR novo: €X
- Churn: X% (target: < Y%)
- LTV/CAC: Xx (target: > 3x)
**Dashboard Trimestral (Estratégico):**
- OKRs progress (traffic light: 🟢🟡🔴)
- Market share: X% (vs Q anterior)
- Brand awareness: [Métrica]
- NPS: X (target: > 50)
```
**Dashboards:**
- **Semanal (Operacional)**: MQLs, CAC, traffic, ad spend, top channel
- **Mensal (Tactico)**: SQLs, customers novos, MRR, churn, LTV/CAC
- **Trimestral (Estrategico)**: OKRs progress, market share, brand awareness, NPS
---
## 🚀 Growth Hacking Tactics 2026
## Ferramentas Recomendadas
### Quick Wins (Implementar 1ª semana)
### Pesquisa e Analise
- Google Trends, SimilarWeb, SparkToro, AnswerThePublic
```markdown
1. **Lead Magnet Irresistível**
Template/Calculadora/Checklist grátis
→ Captura email → Nurturing sequence
2. **Referral Program**
"Indica amigo, ambos ganham X% desconto"
→ Viral loop
3. **Content Upgrade**
CTA in-content: "Descarrega versão PDF completa"
→ Converte readers em leads
4. **Exit-Intent Popup**
"Antes de saíres... 10% desconto primeira compra"
→ Recupera 2-5% abandonos
5. **Retargeting Agressivo**
Visitantes website últimos 30 dias
→ Ads personalizados produto visualizado
```
### Growth Loops (Sustentáveis)
```
Loop 1: Content → SEO → Traffic → Conversão → Case Study → Content
[Composto anual: 20-30% crescimento orgânico]
Loop 2: Customer → Referral → New Customer → Repeat
[CAC reduz 40% com referrals]
Loop 3: User → UGC (User Generated Content) → Social Proof → New User
[Trust aumenta CVR 15-25%]
```
---
## 📊 KPIs por Objectivo
| Objectivo | KPIs | Target | Ferramenta |
|-----------|------|--------|------------|
| **Awareness** | Reach, Impressions, Brand Search | Crescer 20%/trim | Google Analytics, Google Trends |
| **Engagement** | Time on Site, Pages/Session, Social Engagement | ToS > 3min | GA, Social Analytics |
| **Lead Gen** | MQLs, SQLs, Cost per Lead | CPL < €50 | CRM (HubSpot, Pipedrive) |
| **Conversion** | CVR, CAC, Revenue | CVR > 3%, CAC < €800 | CRM + Analytics |
| **Retention** | Churn Rate, NPS, LTV | Churn < 5%, NPS > 50 | CRM, Surveys |
---
## 📋 Template Plano Marketing Executivo
```markdown
# Plano Marketing [Empresa] - Q1 2026
## 1. Executive Summary (1 página)
- Situação actual
- Objectivo principal
- Investimento necessário
- ROI esperado
## 2. Análise de Situação (2-3 páginas)
### Mercado
- Tamanho: €XXM
- Crescimento: X%/ano
- Tendências: [3 principais]
### Concorrência
- Player 1: [Posicionamento, forças/fraquezas]
- Player 2: [...]
- Player 3: [...]
### SWOT
[Matriz 2x2 visual]
## 3. Estratégia (2 páginas)
### Segmentação
[Segmentos identificados + priorização]
### Posicionamento
[Positioning statement + USPs]
### Mensagem Core
[Elevator pitch + mensagens secundárias]
## 4. Objectivos (1 página)
### OKRs Q1
[3-4 objectives com key results mensuráveis]
## 5. Táticas (3-4 páginas)
### Canais Escolhidos
[Canal 1]: Objectivo, acções, budget, KPIs
[Canal 2]: ...
[Canal 3]: ...
### Calendário Editorial
[Grid mês a mês com tipos conteúdo]
## 6. Orçamento (1 página)
| Canal | Budget Mensal | % Total |
|-------|---------------|---------|
| SEO/Content | €X | 40% |
| Paid Ads | €X | 30% |
| Social | €X | 20% |
| Tools | €X | 10% |
| **TOTAL** | **€X** | **100%** |
## 7. Timeline & Milestones (1 página)
[Gantt chart trimestral]
## 8. Métricas e Reporting (1 página)
- Dashboard link
- Frequência reports (semanal/mensal)
- Responsáveis por métrica
```
---
## 🛠️ Ferramentas Recomendadas
### Pesquisa e Análise
- **Google Trends** - Tendências pesquisa
- **SimilarWeb** - Análise concorrência
- **SparkToro** - Audience research
- **AnswerThePublic** - Questions research
### Planning e Colaboração
- **Notion** - Roadmaps, wikis
- **Miro** - Brainstorming visual
- **Asana/Monday** - Project management
### Planning e Colaboracao
- Notion, Miro, Asana/Monday
### Analytics e Reporting
- **Google Analytics 4** - Website analytics
- **Mixpanel** - Product analytics
- **Looker Studio** - Dashboards custom
- Google Analytics 4, Mixpanel, Looker Studio
---
## 📚 Datasets Dify (Consultar SEMPRE)
## References (conteudo detalhado)
| Dataset | ID | Prioridade | Uso |
|---------|----|-----------:|-----|
| **Marketing Digital** | `c1ec779f-4cb1-4ecf-ba11-6b39b93d4e24` | 1 | Estratégia geral, frameworks |
| **Estratégia** | [ID] | 1 | Posicionamento, análise mercado |
| **Growth Hacking** | [ID] | 2 | Táticas crescimento rápido |
| **Seth Godin** | `3a2e536c-4985-42df-9a00-f0a4dfe720a3` | 3 | Marketing moderno, posicionamento |
### Como Consultar
```javascript
// Frameworks estratégia marketing
mcp__notebooklm__notebook_query, mcp__dify-kb__dify_kb_retrieve_segments({
dataset_id: "c1ec779f-4cb1-4ecf-ba11-6b39b93d4e24",
query: "marketing strategy framework OKRs positioning 2026"
})
// Growth hacking tactics
mcp__dify-kb__dify_kb_retrieve_segments({
dataset_id: "[GROWTH_HACKING_ID]",
query: "growth loops viral marketing acquisition"
})
// Posicionamento moderno
mcp__dify-kb__dify_kb_retrieve_segments({
dataset_id: "3a2e536c-4985-42df-9a00-f0a4dfe720a3",
query: "positioning differentiation purple cow marketing"
})
```
| Ficheiro | Conteudo |
|----------|----------|
| `references/frameworks-estrategicos.md` | Templates SWOT, Porter, Segmentacao, ICP, Posicionamento, OKRs |
| `references/marketing-mix-orcamento.md` | Canais por funil, orcamentos (startup/scale-up/enterprise), growth hacking, template plano executivo, KPIs |
---
## 🎯 Agente Complementar
- `marketing-planning-expert` (agente especializado)
## Anti-Patterns
- Estrategia sem dados de mercado reais
- Segmentacao demasiado generica (todos sao target)
- Objectivos sem metricas mensuraveis
- Budget sem priorizacao por canal
- Ignorar retention e advocacy (so focar aquisicao)
- Plano sem timeline e responsaveis
---
**Versão:** 2.0.0 | **Autor:** Descomplicar® | **Data:** 2026-02-03
**Frameworks:** OKRs, Porter, SWOT, 4C Positioning, Growth Loops 2026
---
## 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]
```
**Versao:** 2.1.0 | **Autor:** Descomplicar

156
marketing/skills/marketing-strategy/references/frameworks-estrategicos.md Normal file
View File

@@ -0,0 +1,156 @@
# Frameworks Estrategicos
## Fase 1: Analise de Situacao (Research)
### 1.1 Analise de Mercado
```markdown
Tamanho e Crescimento:
- TAM (Total Addressable Market): XXXM EUR
- SAM (Serviceable Available Market): XXXM EUR
- SOM (Serviceable Obtainable Market): XXXM EUR
- CAGR (Taxa Crescimento): X%/ano
Tendencias:
- [Tendencia 1 relevante]
- [Tendencia 2 relevante]
- [Oportunidade/Ameaca]
Barreiras Entrada:
- Capital inicial: XX EUR
- Regulacao: [Licencas necessarias]
- Know-how tecnico: [Nivel complexidade]
```
### 1.2 Analise Concorrencia (Porter's 5 Forces)
```markdown
Rivalidade Actual:
- Principais players: [TOP 3 concorrentes]
- Market share: [% mercado]
- Posicionamento: [Como se posicionam]
Ameaca Novos Entrantes: BAIXA / MEDIA / ALTA
Poder Negocial Fornecedores: BAIXO / MEDIO / ALTO
Poder Negocial Clientes: BAIXO / MEDIO / ALTO
Ameaca Substitutos: BAIXA / MEDIA / ALTA
```
### 1.3 Analise Interna (SWOT)
```markdown
Strengths (Forcas):
- [Vantagem competitiva 1]
- [Recurso unico 2]
Weaknesses (Fraquezas):
- [Limitacao 1]
- [Gap recursos 2]
Opportunities (Oportunidades):
- [Tendencia mercado 1]
- [Nicho nao explorado 2]
Threats (Ameacas):
- [Concorrente novo 1]
- [Mudanca regulacao 2]
```
---
## Fase 2: Segmentacao e Targeting
```markdown
**Segmentos Mercado (3-5 maximo):**
Segmento A: [Nome Descritivo]
- Demografia: Idade, genero, localizacao, rendimento
- Psicografica: Valores, interesses, comportamentos
- Tamanho: X% mercado, XXXM EUR
- Dor principal: [Problema especifico]
- Solucao actual: [Como resolvem hoje]
- Willingness to pay: XX-YY EUR
**Priorizacao (Reach/Revenue/Resources):**
| Segmento | Reach | Revenue | Resources | Score | Prioridade |
|----------|-------|---------|-----------|-------|------------|
| A | 8/10 | 9/10 | 7/10 | 24/30 | 1o |
| B | 6/10 | 7/10 | 8/10 | 21/30 | 2o |
| C | 4/10 | 5/10 | 6/10 | 15/30 | 3o |
**ICP (Ideal Customer Profile) - Segmento prioritario:**
B2B:
- Industria: [Sector especifico]
- Tamanho empresa: [No colaboradores / receita]
- Localizacao: [Geografia]
- Decision makers: [Cargos que compram]
- Pain points: [3 principais dores]
- Budget: [Range investimento]
- Ciclo venda: [Tempo medio decisao]
B2C:
- Idade: [Range]
- Localizacao: [Cidades principais]
- Rendimento: [Range]
- Educacao: [Nivel]
- Interesses: [Hobbies, valores]
- Pain points: [3 principais dores]
- Budget: [Gasto tipico]
```
---
## Fase 2.2: Posicionamento (Framework 4C)
```markdown
**Positioning Statement:**
Para [target audience especifico]
Que [tem este problema/necessidade]
O [produto/servico] e [categoria]
Que [beneficio principal unico]
Ao contrario de [alternativa/concorrente]
Nos [diferenciador unico e defensavel]
**Diferenciadores (USPs):**
1. [USP #1 - Quantificavel]
2. [USP #2 - Defensavel]
3. [USP #3 - Relevante]
**Mensagem Core (Elevator Pitch - 30 segundos):**
[2 frases que captam atencao e comunicam valor unico]
```
---
## Fase 3: Objectivos (OKRs Framework)
```markdown
**Q1 2026 OKRs:**
Objective 1: Dominar Aquisicao de Clientes B2B
- KR1: 150 SQLs (Sales Qualified Leads) por mes
- KR2: CAC (Customer Acquisition Cost) < 800 EUR
- KR3: Conversion Rate SQL->Customer > 15%
- Owner: [Nome]
Objective 2: Estabelecer Lideranca de Pensamento
- KR1: 50K visitas organicas/mes (blog + SEO)
- KR2: 10K seguidores LinkedIn (empresa)
- KR3: 5 guest posts em media tier-1
- Owner: [Nome]
Objective 3: Optimizar Funil de Conversao
- KR1: Landing page CVR 8% (actual: 3.5%)
- KR2: Email nurturing open rate > 35%
- KR3: Demo show-up rate > 70%
- Owner: [Nome]
**Metricas North Star:**
- MRR (Monthly Recurring Revenue): XXK EUR
- NPS (Net Promoter Score): > 50
- LTV/CAC: > 3x
```

191
marketing/skills/marketing-strategy/references/marketing-mix-orcamento.md Normal file
View File

@@ -0,0 +1,191 @@
# Marketing Mix e Orcamento
## Canais por Funnel Stage
```
AWARENESS (ToFu)
-- SEO / Content Marketing (40% budget)
- Blog posts (2x/semana)
- Guias/Ebooks (1x/mes)
- Videos YouTube (1x/semana)
-- Social Media Organico (20% budget)
- LinkedIn (5x/semana)
- Instagram (3x/semana)
- TikTok (experimental, 2x/semana)
-- Paid Ads - Display/Video (20% budget)
- Google Display
- YouTube Ads
- Meta Ads (Awareness)
CONSIDERATION (MoFu)
-- Email Nurturing (5% budget)
- Welcome series (5 emails)
- Educational series
- Case studies
-- Webinars/Lives (5% budget)
- 1x/mes tema especifico
- Recording -> lead magnet
-- Retargeting (10% budget)
- Google Ads Remarketing
- Meta Ads Retargeting
CONVERSION (BoFu)
-- Search Ads (High-intent keywords)
-- Landing Pages Optimizadas
-- Sales Enablement (Case studies, demos)
-- Free Trial/Demo (reduzir friccao)
RETENTION e ADVOCACY
-- Customer Success (Onboarding, training)
-- Email Marketing (Updates, tips, upsell)
-- Community (Grupo privado, eventos)
-- Referral Program (Incentivos)
```
## Orcamento por Canal
### Startup (< 5.000 EUR/mes)
```
40% Content/SEO -> 2.000 EUR
30% Paid Ads -> 1.500 EUR
20% Social Organico -> 1.000 EUR
10% Tools -> 500 EUR
```
### Scale-up (5.000-20.000 EUR/mes)
```
30% Paid Ads -> 6.000 EUR
25% Content/SEO -> 5.000 EUR
20% Social/Influencers -> 4.000 EUR
15% Email/Automation -> 3.000 EUR
10% Tools/Agency -> 2.000 EUR
```
### Enterprise (> 20.000 EUR/mes)
```
Full mix com especialistas dedicados por canal
Budget flexivel baseado em performance (ROAS > 3x manter/escalar)
```
---
## Growth Hacking Tactics 2026
### Quick Wins (Implementar 1a semana)
1. **Lead Magnet Irresistivel**
Template/Calculadora/Checklist gratis
-> Captura email -> Nurturing sequence
2. **Referral Program**
"Indica amigo, ambos ganham X% desconto"
-> Viral loop
3. **Content Upgrade**
CTA in-content: "Descarrega versao PDF completa"
-> Converte readers em leads
4. **Exit-Intent Popup**
"Antes de saires... 10% desconto primeira compra"
-> Recupera 2-5% abandonos
5. **Retargeting Agressivo**
Visitantes website ultimos 30 dias
-> Ads personalizados produto visualizado
### Growth Loops (Sustentaveis)
```
Loop 1: Content -> SEO -> Traffic -> Conversao -> Case Study -> Content
[Composto anual: 20-30% crescimento organico]
Loop 2: Customer -> Referral -> New Customer -> Repeat
[CAC reduz 40% com referrals]
Loop 3: User -> UGC (User Generated Content) -> Social Proof -> New User
[Trust aumenta CVR 15-25%]
```
---
## Template Plano Marketing Executivo
```markdown
# Plano Marketing [Empresa] - Q1 2026
## 1. Executive Summary (1 pagina)
- Situacao actual
- Objectivo principal
- Investimento necessario
- ROI esperado
## 2. Analise de Situacao (2-3 paginas)
### Mercado
- Tamanho: XXXM EUR
- Crescimento: X%/ano
- Tendencias: [3 principais]
### Concorrencia
- Player 1: [Posicionamento, forcas/fraquezas]
- Player 2: [...]
- Player 3: [...]
### SWOT
[Matriz 2x2 visual]
## 3. Estrategia (2 paginas)
### Segmentacao
[Segmentos identificados + priorizacao]
### Posicionamento
[Positioning statement + USPs]
### Mensagem Core
[Elevator pitch + mensagens secundarias]
## 4. Objectivos (1 pagina)
### OKRs Q1
[3-4 objectives com key results mensuraveis]
## 5. Tacticas (3-4 paginas)
### Canais Escolhidos
[Canal 1]: Objectivo, accoes, budget, KPIs
[Canal 2]: ...
[Canal 3]: ...
### Calendario Editorial
[Grid mes a mes com tipos conteudo]
## 6. Orcamento (1 pagina)
| Canal | Budget Mensal | % Total |
|-------|---------------|---------|
| SEO/Content | X EUR | 40% |
| Paid Ads | X EUR | 30% |
| Social | X EUR | 20% |
| Tools | X EUR | 10% |
| **TOTAL** | **X EUR** | **100%** |
## 7. Timeline e Milestones (1 pagina)
[Gantt chart trimestral]
## 8. Metricas e Reporting (1 pagina)
- Dashboard link
- Frequencia reports (semanal/mensal)
- Responsaveis por metrica
```
---
## KPIs por Objectivo
| Objectivo | KPIs | Target | Ferramenta |
|-----------|------|--------|------------|
| **Awareness** | Reach, Impressions, Brand Search | Crescer 20%/trim | Google Analytics, Google Trends |
| **Engagement** | Time on Site, Pages/Session, Social Engagement | ToS > 3min | GA, Social Analytics |
| **Lead Gen** | MQLs, SQLs, Cost per Lead | CPL < 50 EUR | CRM (HubSpot, Pipedrive) |
| **Conversion** | CVR, CAC, Revenue | CVR > 3%, CAC < 800 EUR | CRM + Analytics |
| **Retention** | Churn Rate, NPS, LTV | Churn < 5%, NPS > 50 | CRM, Surveys |

537
marketing/skills/seo-audit/SKILL.md
View File

@@ -1,14 +1,6 @@
---
name: seo-audit
description: Comprehensive SEO audit and optimization recommendations. Analyzes technical
SEO, content, backlinks, and performance. Use when user mentions "seo audit", "auditoria
seo", "otimização", "ranking", "google search".
author: Descomplicar® Crescimento Digital
version: 2.0.0
quality_score: 75
user_invocable: true
desk_task: 1481
allowed-tools: Task
description: Auditoria SEO completa com recomendacoes de optimizacao. Analisa SEO tecnico, conteudo, backlinks e desempenho.
---
# SEO Audit - Auditoria Completa
@@ -17,136 +9,71 @@ Skill para realizar auditorias SEO completas usando o stack de ferramentas insta
---
## 🎯 Quando Usar
## Contexto NotebookLM
- Auditar um site completo (técnico + conteúdo + performance)
- Verificar Core Web Vitals e ranking factors
- Analisar backlinks e autoridade de domínio
- Obter dados reais do Google Search Console
- Identificar oportunidades de optimização
- Comparar com concorrência
ANTES de executar, consultar notebook para contexto especializado:
| Notebook | ID | Consultar quando |
|----------|-----|-----------------|
| Marketing Digital PT | `4c595973` | Sempre |
```
mcp__notebooklm__notebook_query({
notebook_id: "4c595973-ba10-420a-a3bf-e4389e424ad3",
query: "<adaptar ao contexto — ex: auditoria SEO tecnico, Core Web Vitals, backlinks, E-E-A-T>"
})
```
**Procedimento relacionado:** `PROC-DMARC-Email-Entregabilidade.md` -- consultar quando a auditoria envolve email deliverability.
---
## 📊 Google Updates 2026
## Quando Usar
- Auditar um site completo (tecnico + conteudo + performance)
- Verificar Core Web Vitals e ranking factors
- Analisar backlinks e autoridade de dominio
- Obter dados reais do Google Search Console
- Identificar oportunidades de optimizacao
- Comparar com concorrencia
---
## Google Updates 2026
### Core Algorithm Updates
| Update | Data | Impacto |
|--------|------|---------|
| **Helpful Content Q1** | Jan 2026 | Penaliza conteúdo AI de baixa qualidade |
| **Helpful Content Q1** | Jan 2026 | Penaliza conteudo AI de baixa qualidade |
| **Core Web Vitals 3.0** | Mar 2026 | INP substitui FID, thresholds mais rigorosos |
| **E-E-A-T Focus** | Q1-Q2 | Experiência prática obrigatória (not just expertise) |
| **E-E-A-T Focus** | Q1-Q2 | Experiencia pratica obrigatoria |
| **Mobile-First Index** | Universal | 100% dos sites |
### Novos Ranking Factors 2026
1. **INP (Interaction to Next Paint)** - Substitui FID
- Bom: < 200ms
- Necessita melhoria: 200-500ms
- Mau: > 500ms
2. **E-E-A-T** (Experience, Expertise, Authoritativeness, Trust)
- Autor identificado com bio
- Credenciais verificáveis
- Experiência real demonstrada
3. **Page Experience Signals**
- HTTPS obrigatório
- Intrusive interstitials penalizados
- Safe Browsing compliance
1. **INP (Interaction to Next Paint)** -- Bom: < 200ms | Medio: 200-500ms | Mau: > 500ms
2. **E-E-A-T** -- Autor identificado com bio, credenciais verificaveis, experiencia real
3. **Page Experience Signals** -- HTTPS obrigatorio, intrusive interstitials penalizados
---
## 🔧 Ferramentas Disponíveis
## Workflow de Auditoria Completa
### 1. SEO Tools API (http://localhost:3000)
```bash
# Auditoria básica
curl "http://localhost:3000/seo-audit?url=URL"
# Velocidade PageSpeed Insights style
curl "http://localhost:3000/page-speed-analyzer?url=URL"
# Backlinks + DR/UR
curl "http://localhost:3000/backlink-checker?url=URL"
# Rankings para keywords
curl "http://localhost:3000/rank-checker?url=URL&keywords=keyword1,keyword2"
# Optimização conteúdo on-page
curl "http://localhost:3000/content-optimization?url=URL"
# Internal linking structure
curl "http://localhost:3000/internal-linking?url=URL"
# Sitemap XML generator
curl "http://localhost:3000/sitemap-generator?url=URL"
# Análise concorrência
curl "http://localhost:3000/competitor-analysis?url=URL&competitors=site1.com,site2.com"
```
### 2. Lighthouse MCP
| Tool | Função | Output |
|------|--------|--------|
| `run_audit(url)` | Auditoria completa | Performance, SEO, A11y, Best Practices |
| `get_performance_score(url)` | Score performance | 0-100 |
| `get_core_web_vitals(url)` | LCP, INP, CLS | Mobile + Desktop |
| `get_accessibility_score(url)` | Acessibilidade | 0-100 + issues |
| `get_seo_analysis(url)` | Análise SEO técnico | Meta, headings, indexabilidade |
| `get_security_audit(url)` | Segurança | HTTPS, mixed content, headers |
| `compare_mobile_desktop(url)` | Comparação | Diferenças performance |
| `get_lcp_opportunities(url)` | Optimizações LCP | Preload, lazy load |
| `find_unused_javascript(url)` | JS não usado | Tamanhos, % savings |
### 3. SEO Ahrefs MCP (via API)
| Tool | Função | Dados |
|------|--------|-------|
| `get_backlinks_list(domain)` | Lista backlinks | DR, UR, anchor text |
| `keyword_generator(keyword, country)` | Ideias keywords | Volume, KD, CPC |
| `get_traffic(domain)` | Tráfego estimado | Visitas mensais, keywords |
| `keyword_difficulty(keyword)` | Dificuldade keyword | 0-100 (KD score) |
### 4. Google Search Console MCP
| Tool | Função | Dados Reais |
|------|--------|-------------|
| `list_properties` | Listar sites verificados | URLs properties |
| `get_search_analytics(site, period)` | Queries, cliques, CTR | Últimos 16 meses |
| `inspect_url_enhanced(site, url)` | Inspecionar URL | Indexação, mobile usability |
| `check_indexing_issues(site, urls)` | Problemas indexação | Erros, avisos |
| `get_sitemaps(site)` | Listar sitemaps | Status, URLs submetidos |
### 5. Google Analytics MCP
| Tool | Função | Métricas |
|------|--------|----------|
| `get_account_summaries` | Listar contas | Properties disponíveis |
| `run_report(property, metrics, dimensions)` | Relatório custom | Sessions, users, bounce rate |
| `run_realtime_report(property)` | Tempo real | Utilizadores activos now |
---
## 📋 Workflow de Auditoria Completa
### Passo 1: Análise Técnica Básica (3 min)
### Passo 1: Analise Tecnica Basica (3 min)
```
1. SEO Tools API → /seo-audit → Meta tags, headings, estrutura HTML
2. SEO Tools API → /page-speed-analyzer → Velocidade, sugestões
3. Lighthouse → run_audit → Performance, SEO, Accessibility scores
1. SEO Tools API -> /seo-audit -> Meta tags, headings, estrutura HTML
2. SEO Tools API -> /page-speed-analyzer -> Velocidade, sugestoes
3. Lighthouse -> run_audit -> Performance, SEO, Accessibility scores
```
**Checklist Crítico:**
**Checklist Critico:**
- [ ] Meta title (50-60 chars)
- [ ] Meta description (150-160 chars)
- [ ] H1 único com keyword
- [ ] H1 unico com keyword
- [ ] Canonical URL definido
- [ ] Robots.txt accessível
- [ ] Robots.txt acessivel
- [ ] Sitemap.xml presente
- [ ] HTTPS activo
- [ ] Mobile-friendly
@@ -154,66 +81,66 @@ curl "http://localhost:3000/competitor-analysis?url=URL&competitors=site1.com,si
### Passo 2: Core Web Vitals (2 min)
```
1. Lighthouse → get_core_web_vitals → LCP, INP, CLS (mobile + desktop)
2. Lighthouse → compare_mobile_desktop → Identificar gaps
3. Lighthouse → get_lcp_opportunities → Sugestões optimização
1. Lighthouse -> get_core_web_vitals -> LCP, INP, CLS (mobile + desktop)
2. Lighthouse -> compare_mobile_desktop -> Identificar gaps
3. Lighthouse -> get_lcp_opportunities -> Sugestoes optimizacao
```
**Thresholds 2026:**
| Métrica | Bom | Necessita Melhoria | Mau |
| Metrica | Bom | Necessita Melhoria | Mau |
|---------|-----|-------------------|-----|
| **LCP** | < 2.5s | 2.5-4s | > 4s |
| **INP** | < 200ms | 200-500ms | > 500ms |
| **CLS** | < 0.1 | 0.1-0.25 | > 0.25 |
### Passo 3: Análise de Conteúdo (3 min)
### Passo 3: Analise de Conteudo (3 min)
```
1. SEO Tools API → /content-optimization → On-page SEO, keyword density
2. SEO Tools API → /internal-linking → Estrutura links internos
3. SEO Ahrefs → keyword_generator → Keywords relacionadas, volume, KD
1. SEO Tools API -> /content-optimization -> On-page SEO, keyword density
2. SEO Tools API -> /internal-linking -> Estrutura links internos
3. SEO Ahrefs -> keyword_generator -> Keywords relacionadas, volume, KD
```
**Checklist E-E-A-T:**
- [ ] Autor identificado com bio
- [ ] Credenciais verificáveis
- [ ] Data publicação/actualização
- [ ] Credenciais verificaveis
- [ ] Data publicacao/actualizacao
- [ ] Fontes citadas (links externos autoritativos)
- [ ] Experiência real demonstrada
- [ ] Experiencia real demonstrada
### Passo 4: Backlinks e Autoridade (2 min)
```
1. SEO Tools API → /backlink-checker → Backlinks básicos, DR/UR
2. SEO Ahrefs → get_backlinks_list → Lista detalhada Ahrefs (DR, anchor text)
3. SEO Ahrefs → get_traffic → Tráfego estimado mensal
1. SEO Tools API -> /backlink-checker -> Backlinks basicos, DR/UR
2. SEO Ahrefs -> get_backlinks_list -> Lista detalhada (DR, anchor text)
3. SEO Ahrefs -> get_traffic -> Trafego estimado mensal
```
**Métricas Autoridade:**
- **DR (Domain Rating)**: 0-100 (força backlink profile)
- **UR (URL Rating)**: 0-100 (força página específica)
**Metricas Autoridade:**
- **DR (Domain Rating)**: 0-100 (forca backlink profile)
- **UR (URL Rating)**: 0-100 (forca pagina especifica)
- **Backlinks**: Quantidade + qualidade (DR > 30)
- **Referring Domains**: Número de domínios únicos
- **Referring Domains**: Numero de dominios unicos
### Passo 5: Dados Reais GSC (3 min)
```
1. GSC → get_search_analytics → Queries, impressões, CTR real (últimos 90 dias)
2. GSC → check_indexing_issues → Problemas de indexação
3. GSC → get_sitemaps → Status sitemaps submetidos
1. GSC -> get_search_analytics -> Queries, impressoes, CTR real (ultimos 90 dias)
2. GSC -> check_indexing_issues -> Problemas de indexacao
3. GSC -> get_sitemaps -> Status sitemaps submetidos
```
**Métricas GSC a Analisar:**
- **Impressões vs Cliques**: CTR médio > 2%
- **Posição média**: Top 3 para keywords principais
- **Cobertura**: % páginas indexadas vs submetidas
- **Mobile Usability**: Erros específicos mobile
**Metricas GSC a Analisar:**
- **Impressoes vs Cliques**: CTR medio > 2%
- **Posicao media**: Top 3 para keywords principais
- **Cobertura**: % paginas indexadas vs submetidas
- **Mobile Usability**: Erros especificos mobile
### Passo 6: Concorrência (opcional, 2 min)
### Passo 6: Concorrencia (opcional, 2 min)
```
SEO Tools API → /competitor-analysis → Comparar com 2-3 concorrentes
SEO Tools API -> /competitor-analysis -> Comparar com 2-3 concorrentes
- Keywords gap
- Backlinks gap
- Content gap
@@ -221,220 +148,8 @@ SEO Tools API → /competitor-analysis → Comparar com 2-3 concorrentes
---
## 📄 Template de Relatório
## Propriedades GSC Disponiveis
```markdown
# Relatório SEO - [DOMÍNIO]
**Data:** YYYY-MM-DD
**Versão:** 2.0 (2026 Standards)
---
## 🎯 Resumo Executivo
| Métrica | Valor | Status |
|---------|-------|--------|
| **Score Geral** | X/100 | 🟢 Bom / 🟡 Médio / 🔴 Crítico |
| **Core Web Vitals** | LCP Xs \| INP Xms \| CLS X | ✅ / ⚠️ / ❌ |
| **Backlinks** | X (DR: X) | 🟢 Bom / 🟡 Médio / 🔴 Fraco |
| **Problemas Críticos** | X | Lista abaixo |
---
## 1️⃣ Análise Técnica
### Meta Tags
- **Title**: [OK/NOK] - [Conteúdo]
- **Description**: [OK/NOK] - [Conteúdo]
- **Canonical**: [OK/NOK]
- **Open Graph**: [OK/NOK]
### Headings Structure
```
H1: [Texto] ✅
H2: [Texto] ✅
H3: [Texto] ✅
H2: [Texto] ⚠️ (Sem keyword)
```
### Velocidade
- **Mobile**: X/100 - [LCP Xs | INP Xms | CLS X]
- **Desktop**: X/100 - [LCP Xs | INP Xms | CLS X]
- **Bloqueio Principal**: [JS/CSS/Imagens]
---
## 2️⃣ Core Web Vitals
### Comparação Mobile vs Desktop
| Métrica | Mobile | Desktop | Diferença |
|---------|--------|---------|-----------|
| LCP | X.Xs | X.Xs | +X.X% |
| INP | Xms | Xms | +X% |
| CLS | X | X | +X% |
### Oportunidades LCP
1. **Preload imagem hero** - Savings: X KB
2. **Lazy load below-fold** - Savings: X KB
3. **Optimizar servidor**: TTFB > 600ms
### Oportunidades INP
1. **Reduzir JS não usado**: X KB (X% savings)
2. **Code splitting**: Carregar só necessário
3. **Web Workers**: Tarefas pesadas off main thread
---
## 3️⃣ Conteúdo e E-E-A-T
### On-Page SEO
| Factor | Status | Nota |
|--------|--------|------|
| Keyword no title | ✅ / ❌ | |
| Keyword no H1 | ✅ / ❌ | |
| Keyword primeiros 100 chars | ✅ / ❌ | |
| Alt text imagens | ✅ / ⚠️ / ❌ | X/Y com alt |
| Internal linking | ✅ / ⚠️ / ❌ | X links internos |
| External links | ✅ / ⚠️ / ❌ | X links autoritativos |
### E-E-A-T Score
| Critério | Status | Observação |
|----------|--------|------------|
| Autor identificado | ✅ / ❌ | |
| Bio com credenciais | ✅ / ❌ | |
| Data publicação | ✅ / ❌ | |
| Experiência demonstrada | ✅ / ❌ | |
| Fontes citadas | ✅ / ❌ | X links externos |
---
## 4️⃣ Backlinks e Autoridade
### Perfil de Links
| Métrica | Valor | Benchmark |
|---------|-------|-----------|
| **Domain Rating (DR)** | X | > 30 bom |
| **URL Rating (UR)** | X | > 20 bom |
| **Backlinks Totais** | X | |
| **Referring Domains** | X | > 50 bom |
| **DoFollow vs NoFollow** | X% / X% | > 60% DoFollow ideal |
### Top 5 Backlinks
| Domínio | DR | Anchor Text | DoFollow |
|---------|-----|-------------|----------|
| site1.com | 75 | [Texto] | Sim |
| site2.com | 62 | [Texto] | Sim |
| ... | ... | ... | ... |
### Oportunidades
1. **Guest posts** em sites DR > 40
2. **Broken link building** (X links quebrados encontrados)
3. **Recuperar menções não linkadas** (X menções)
---
## 5️⃣ Search Console (Dados Reais)
### Performance Últimos 90 Dias
| Métrica | Valor | Variação vs período anterior |
|---------|-------|------------------------------|
| **Cliques** | X | +X% / -X% |
| **Impressões** | X | +X% / -X% |
| **CTR Médio** | X% | +X pp |
| **Posição Média** | X | +X / -X |
### Top 10 Queries
| Query | Cliques | Impressões | CTR | Posição |
|-------|---------|------------|-----|---------|
| query1 | X | X | X% | X |
| query2 | X | X | X% | X |
| ... | ... | ... | ... | ... |
### Oportunidades CTR
- **Posição 4-10, CTR < 5%**: Optimizar meta description
- **Posição 11-20**: Targets fáceis para top 10
- **Alta impressão, baixo CTR**: Melhorar title/description
### Indexação
| Estado | Páginas | Acção Necessária |
|--------|---------|------------------|
| ✅ Indexadas | X | - |
| ⚠️ Excluídas | X | Investigar |
| ❌ Erros | X | Corrigir urgente |
**Problemas Críticos:**
1. [Erro 404]: X páginas
2. [Robots bloqueado]: X páginas
3. [Soft 404]: X páginas
---
## 6️⃣ Recomendações Prioritárias
### 🔴 Crítico (Fazer AGORA)
1. [ ] **[Problema]** - [Impacto] - [Solução]
2. [ ] **[Problema]** - [Impacto] - [Solução]
### 🟡 Importante (Fazer esta semana)
1. [ ] **[Problema]** - [Impacto] - [Solução]
2. [ ] **[Problema]** - [Impacto] - [Solução]
### 🟢 Melhoria (Fazer este mês)
1. [ ] **[Problema]** - [Impacto] - [Solução]
2. [ ] **[Problema]** - [Impacto] - [Solução]
---
## 📊 Roadmap Optimização (Q1-Q2 2026)
### Mês 1: Fundação Técnica
- [ ] Corrigir todos os problemas críticos
- [ ] Optimizar Core Web Vitals (target: All green)
- [ ] Implementar E-E-A-T básico (autor, datas, bio)
### Mês 2: Conteúdo e Autoridade
- [ ] Actualizar conteúdo underperforming (posição 11-20)
- [ ] Criar conteúdo para keywords gap vs concorrência
- [ ] Campanha backlinks (target: +10 DR > 30)
### Mês 3: Consolidação e Escala
- [ ] Monitorizar rankings e ajustar
- [ ] Expandir internal linking
- [ ] Criar cluster de conteúdo para keywords principais
---
## 🔧 Ferramentas Utilizadas
- ✅ SEO Tools API (localhost:3000)
- ✅ Lighthouse MCP
- ✅ SEO Ahrefs MCP
- ✅ Google Search Console MCP
- ✅ Google Analytics MCP (opcional)
---
**Próxima Auditoria**: [Data + 3 meses]
```
---
## ⚠️ Notas Importantes
### Requisitos
- **SEO Tools API** deve estar a correr: `~/mcp-servers/seo-tools-api/start.sh`
- **GSC** requer autenticação OAuth na primeira utilização
- **GA** requer ADC credentials configuradas (`gcloud auth application-default login`)
### Propriedades GSC Disponíveis
```
sc-domain:descomplicar.pt
https://emanuelalmeida.pt/
@@ -445,103 +160,39 @@ https://alojadamaria.com/
https://e-commerce.descomplicar.pt/
```
### Limitações
---
## Notas Importantes
### Requisitos
- **SEO Tools API** deve estar a correr: `~/mcp-servers/seo-tools-api/start.sh`
- **GSC** requer autenticacao OAuth na primeira utilizacao
- **GA** requer ADC credentials configuradas
### Limitacoes
- Ahrefs API tem rate limiting (100 req/day free tier)
- GSC data máximo: 16 meses histórico
- Lighthouse scores variam ±5 pontos entre execuções (network dependent)
- GSC data maximo: 16 meses historico
- Lighthouse scores variam +/- 5 pontos entre execucoes
---
## 📚 Datasets Dify (Consultar SEMPRE)
## References (conteudo detalhado)
Consultar os seguintes datasets via MCP para complementar análises:
| Dataset | ID | Uso |
|---------|----|----|
| **SEO (Search Engine Optimization)** | `b93c6475-2f22-412e-ba9d-666eb081b872` | Técnicas SEO avançadas, updates Google |
| **Neil Patel** | `6ff761b3-a054-435c-8fc3-a6e6c3a0afaf` | Link building, conteúdo, estratégias |
| **Marketing de Conteúdo** | `061f19a3-d4b6-4383-9f44-620742167201` | Criação conteúdo, E-E-A-T |
| **Marketing Digital** | `c1ec779f-4cb1-4ecf-ba11-6b39b93d4e24` | Estratégia geral, métricas |
### Como Consultar
```javascript
// Pesquisar técnicas SEO técnico
mcp__notebooklm__notebook_query, mcp__dify-kb__dify_kb_retrieve_segments({
dataset_id: "b93c6475-2f22-412e-ba9d-666eb081b872",
query: "core web vitals INP optimization 2026"
})
// Estratégias link building Neil Patel
mcp__dify-kb__dify_kb_retrieve_segments({
dataset_id: "6ff761b3-a054-435c-8fc3-a6e6c3a0afaf",
query: "backlinks guest posting strategies"
})
// E-E-A-T implementation
mcp__dify-kb__dify_kb_retrieve_segments({
dataset_id: "061f19a3-d4b6-4383-9f44-620742167201",
query: "google EEAT author credibility"
})
```
### Quando Consultar
- Após identificar problemas técnicos (buscar soluções específicas)
- Antes de recomendar estratégia de backlinks
- Para validar best practices 2026
| Ficheiro | Conteudo |
|----------|----------|
| `references/template-relatorio-auditoria.md` | Template completo do relatorio com todas as seccoes e tabelas |
| `references/ferramentas-api.md` | Endpoints SEO Tools API, Lighthouse MCP, Ahrefs, GSC, GA |
---
## 📈 Instrumentação Automática
## Anti-Patterns
Esta skill grava métricas automaticamente para análise PDCA.
### Query para Gravar (executar no final)
```sql
INSERT INTO tblskill_agent_metrics (
type, name, duration_ms, status, staff_id,
kb_consulted, kb_cache_hit, tool_calls, project_id
) VALUES (
'skill', '/seo-audit', {DURACAO_MS}, '{STATUS}', 25,
{KB_CONSULTADO}, {CACHE_HIT}, {TOOL_CALLS}, {PROJECT_ID}
);
```
- Auditar sem dados reais (nunca simular metricas)
- Ignorar gap mobile vs desktop
- Nao verificar se site esta no GSC antes de recolher dados
- Recomendacoes sem priorizacao (critico/importante/melhoria)
- Esquecer E-E-A-T na analise de conteudo
---
**Versão:** 2.0.0 | **Autor:** Descomplicar® | **Data:** 2026-02-03
**Desk Task:** #1481 | **Best Practices:** 2026 Google Standards
---
## 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]
```
**Versao:** 2.1.0 | **Autor:** Descomplicar

94
marketing/skills/seo-audit/references/ferramentas-api.md Normal file
View File

@@ -0,0 +1,94 @@
# Ferramentas e APIs - SEO Audit
## 1. SEO Tools API (http://localhost:3000)
```bash
# Auditoria basica
curl "http://localhost:3000/seo-audit?url=URL"
# Velocidade PageSpeed Insights style
curl "http://localhost:3000/page-speed-analyzer?url=URL"
# Backlinks + DR/UR
curl "http://localhost:3000/backlink-checker?url=URL"
# Rankings para keywords
curl "http://localhost:3000/rank-checker?url=URL&keywords=keyword1,keyword2"
# Optimizacao conteudo on-page
curl "http://localhost:3000/content-optimization?url=URL"
# Internal linking structure
curl "http://localhost:3000/internal-linking?url=URL"
# Sitemap XML generator
curl "http://localhost:3000/sitemap-generator?url=URL"
# Analise concorrencia
curl "http://localhost:3000/competitor-analysis?url=URL&competitors=site1.com,site2.com"
```
## 2. Lighthouse MCP
| Tool | Funcao | Output |
|------|--------|--------|
| `run_audit(url)` | Auditoria completa | Performance, SEO, A11y, Best Practices |
| `get_performance_score(url)` | Score performance | 0-100 |
| `get_core_web_vitals(url)` | LCP, INP, CLS | Mobile + Desktop |
| `get_accessibility_score(url)` | Acessibilidade | 0-100 + issues |
| `get_seo_analysis(url)` | Analise SEO tecnico | Meta, headings, indexabilidade |
| `get_security_audit(url)` | Seguranca | HTTPS, mixed content, headers |
| `compare_mobile_desktop(url)` | Comparacao | Diferencas performance |
| `get_lcp_opportunities(url)` | Optimizacoes LCP | Preload, lazy load |
| `find_unused_javascript(url)` | JS nao usado | Tamanhos, % savings |
## 3. SEO Ahrefs MCP (via API)
| Tool | Funcao | Dados |
|------|--------|-------|
| `get_backlinks_list(domain)` | Lista backlinks | DR, UR, anchor text |
| `keyword_generator(keyword, country)` | Ideias keywords | Volume, KD, CPC |
| `get_traffic(domain)` | Trafego estimado | Visitas mensais, keywords |
| `keyword_difficulty(keyword)` | Dificuldade keyword | 0-100 (KD score) |
## 4. Google Search Console MCP
| Tool | Funcao | Dados Reais |
|------|--------|-------------|
| `list_properties` | Listar sites verificados | URLs properties |
| `get_search_analytics(site, period)` | Queries, cliques, CTR | Ultimos 16 meses |
| `inspect_url_enhanced(site, url)` | Inspeccionar URL | Indexacao, mobile usability |
| `check_indexing_issues(site, urls)` | Problemas indexacao | Erros, avisos |
| `get_sitemaps(site)` | Listar sitemaps | Status, URLs submetidos |
## 5. Google Analytics MCP
| Tool | Funcao | Metricas |
|------|--------|----------|
| `get_account_summaries` | Listar contas | Properties disponiveis |
| `run_report(property, metrics, dimensions)` | Relatorio custom | Sessions, users, bounce rate |
| `run_realtime_report(property)` | Tempo real | Utilizadores activos now |
## Propriedades GSC Disponiveis
```
sc-domain:descomplicar.pt
https://emanuelalmeida.pt/
https://carstuff.pt/
https://solarfvengenharia.com/
https://aquisevende.pt/
https://alojadamaria.com/
https://e-commerce.descomplicar.pt/
```
## Requisitos
- **SEO Tools API** deve estar a correr: `~/mcp-servers/seo-tools-api/start.sh`
- **GSC** requer autenticacao OAuth na primeira utilizacao
- **GA** requer ADC credentials configuradas (`gcloud auth application-default login`)
## Limitacoes
- Ahrefs API tem rate limiting (100 req/day free tier)
- GSC data maximo: 16 meses historico
- Lighthouse scores variam +/- 5 pontos entre execucoes (network dependent)

195
marketing/skills/seo-audit/references/template-relatorio-auditoria.md Normal file
View File

@@ -0,0 +1,195 @@
# Template Relatorio Auditoria SEO
```markdown
# Relatorio SEO - [DOMINIO]
**Data:** YYYY-MM-DD
**Versao:** 2.0 (2026 Standards)
---
## Resumo Executivo
| Metrica | Valor | Status |
|---------|-------|--------|
| **Score Geral** | X/100 | Bom / Medio / Critico |
| **Core Web Vitals** | LCP Xs | INP Xms | CLS X | OK / Aviso / Critico |
| **Backlinks** | X (DR: X) | Bom / Medio / Fraco |
| **Problemas Criticos** | X | Lista abaixo |
---
## 1. Analise Tecnica
### Meta Tags
- **Title**: [OK/NOK] - [Conteudo]
- **Description**: [OK/NOK] - [Conteudo]
- **Canonical**: [OK/NOK]
- **Open Graph**: [OK/NOK]
### Headings Structure
```
H1: [Texto] OK
H2: [Texto] OK
H3: [Texto] OK
H2: [Texto] Aviso (Sem keyword)
```
### Velocidade
- **Mobile**: X/100 - [LCP Xs | INP Xms | CLS X]
- **Desktop**: X/100 - [LCP Xs | INP Xms | CLS X]
- **Bloqueio Principal**: [JS/CSS/Imagens]
---
## 2. Core Web Vitals
### Comparacao Mobile vs Desktop
| Metrica | Mobile | Desktop | Diferenca |
|---------|--------|---------|-----------|
| LCP | X.Xs | X.Xs | +X.X% |
| INP | Xms | Xms | +X% |
| CLS | X | X | +X% |
### Oportunidades LCP
1. **Preload imagem hero** - Savings: X KB
2. **Lazy load below-fold** - Savings: X KB
3. **Optimizar servidor**: TTFB > 600ms
### Oportunidades INP
1. **Reduzir JS nao usado**: X KB (X% savings)
2. **Code splitting**: Carregar so necessario
3. **Web Workers**: Tarefas pesadas off main thread
---
## 3. Conteudo e E-E-A-T
### On-Page SEO
| Factor | Status | Nota |
|--------|--------|------|
| Keyword no title | OK / NOK | |
| Keyword no H1 | OK / NOK | |
| Keyword primeiros 100 chars | OK / NOK | |
| Alt text imagens | OK / Aviso / NOK | X/Y com alt |
| Internal linking | OK / Aviso / NOK | X links internos |
| External links | OK / Aviso / NOK | X links autoritativos |
### E-E-A-T Score
| Criterio | Status | Observacao |
|----------|--------|------------|
| Autor identificado | OK / NOK | |
| Bio com credenciais | OK / NOK | |
| Data publicacao | OK / NOK | |
| Experiencia demonstrada | OK / NOK | |
| Fontes citadas | OK / NOK | X links externos |
---
## 4. Backlinks e Autoridade
### Perfil de Links
| Metrica | Valor | Benchmark |
|---------|-------|-----------|
| **Domain Rating (DR)** | X | > 30 bom |
| **URL Rating (UR)** | X | > 20 bom |
| **Backlinks Totais** | X | |
| **Referring Domains** | X | > 50 bom |
| **DoFollow vs NoFollow** | X% / X% | > 60% DoFollow ideal |
### Top 5 Backlinks
| Dominio | DR | Anchor Text | DoFollow |
|---------|-----|-------------|----------|
| site1.com | 75 | [Texto] | Sim |
| ... | ... | ... | ... |
### Oportunidades
1. **Guest posts** em sites DR > 40
2. **Broken link building** (X links quebrados encontrados)
3. **Recuperar mencoes nao linkadas** (X mencoes)
---
## 5. Search Console (Dados Reais)
### Performance Ultimos 90 Dias
| Metrica | Valor | Variacao vs periodo anterior |
|---------|-------|------------------------------|
| **Cliques** | X | +X% / -X% |
| **Impressoes** | X | +X% / -X% |
| **CTR Medio** | X% | +X pp |
| **Posicao Media** | X | +X / -X |
### Top 10 Queries
| Query | Cliques | Impressoes | CTR | Posicao |
|-------|---------|------------|-----|---------|
| query1 | X | X | X% | X |
| ... | ... | ... | ... | ... |
### Oportunidades CTR
- **Posicao 4-10, CTR < 5%**: Optimizar meta description
- **Posicao 11-20**: Targets faceis para top 10
- **Alta impressao, baixo CTR**: Melhorar title/description
### Indexacao
| Estado | Paginas | Accao Necessaria |
|--------|---------|------------------|
| Indexadas | X | - |
| Excluidas | X | Investigar |
| Erros | X | Corrigir urgente |
---
## 6. Recomendacoes Prioritarias
### Critico (Fazer AGORA)
1. [ ] **[Problema]** - [Impacto] - [Solucao]
2. [ ] **[Problema]** - [Impacto] - [Solucao]
### Importante (Fazer esta semana)
1. [ ] **[Problema]** - [Impacto] - [Solucao]
2. [ ] **[Problema]** - [Impacto] - [Solucao]
### Melhoria (Fazer este mes)
1. [ ] **[Problema]** - [Impacto] - [Solucao]
2. [ ] **[Problema]** - [Impacto] - [Solucao]
---
## Roadmap Optimizacao (Q1-Q2 2026)
### Mes 1: Fundacao Tecnica
- [ ] Corrigir todos os problemas criticos
- [ ] Optimizar Core Web Vitals (target: All green)
- [ ] Implementar E-E-A-T basico (autor, datas, bio)
### Mes 2: Conteudo e Autoridade
- [ ] Actualizar conteudo underperforming (posicao 11-20)
- [ ] Criar conteudo para keywords gap vs concorrencia
- [ ] Campanha backlinks (target: +10 DR > 30)
### Mes 3: Consolidacao e Escala
- [ ] Monitorizar rankings e ajustar
- [ ] Expandir internal linking
- [ ] Criar cluster de conteudo para keywords principais
---
## Ferramentas Utilizadas
- SEO Tools API (localhost:3000)
- Lighthouse MCP
- SEO Ahrefs MCP
- Google Search Console MCP
- Google Analytics MCP (opcional)
---
**Proxima Auditoria**: [Data + 3 meses]
```

678
marketing/skills/seo-content-optimization/SKILL.md
View File

@@ -1,25 +1,36 @@
---
name: seo-content-optimization
description: Content optimization for search engines. Improves existing content with
keywords, structure, and readability. Use when user mentions "seo content", "optimize
content", "content optimization", "improve seo", "keyword optimization".
author: Descomplicar® Crescimento Digital
version: 2.0.0
quality_score: 75
user_invocable: true
desk_task: 1482
allowed-tools: Task
description: Optimizacao de conteudo para motores de busca. Melhora conteudo existente com palavras-chave, estrutura e legibilidade.
---
# SEO Content Optimization
Skill para optimização SEO técnico e de conteúdo com standards Google 2026.
Skill para optimizacao SEO tecnico e de conteudo com standards Google 2026.
---
## 🎯 Quando Usar
## Contexto NotebookLM
- Optimizar páginas para motores de busca
ANTES de executar, consultar notebook para contexto especializado:
| Notebook | ID | Consultar quando |
|----------|-----|-----------------|
| Marketing Digital PT | `4c595973` | Sempre |
```
mcp__notebooklm__notebook_query({
notebook_id: "4c595973-ba10-420a-a3bf-e4389e424ad3",
query: "<adaptar ao contexto — ex: SEO on-page, keyword research, E-E-A-T, Core Web Vitals>"
})
```
**Procedimento relacionado:** `PROC-DMARC-Email-Entregabilidade.md` -- consultar quando o contexto SEO envolve email deliverability.
---
## Quando Usar
- Optimizar paginas para motores de busca
- Implementar meta tags e structured data
- Melhorar Core Web Vitals
- Fazer keyword research
@@ -28,358 +39,93 @@ Skill para optimização SEO técnico e de conteúdo com standards Google 2026.
---
## 📖 Google Updates 2026 - Novos Standards
### E-E-A-T Evolution
## E-E-A-T 2026
| Factor | 2024-2025 | **2026 Standards** |
|--------|-----------|-----|
| **Experience** | Sugerido | **OBRIGATÓRIO** - Demonstração de experiência real |
| **Expertise** | Credenciais | Credenciais **VERIFICÁVEIS** (LinkedIn, certificações) |
| **Authoritativeness** | Backlinks | Backlinks + **menções media** + **citações académicas** |
| **Experience** | Sugerido | **Obrigatorio** - Demonstracao de experiencia real |
| **Expertise** | Credenciais | Credenciais **verificaveis** (LinkedIn, certificacoes) |
| **Authoritativeness** | Backlinks | Backlinks + **mencoes media** + **citacoes academicas** |
| **Trust** | HTTPS | HTTPS + **About page completo** + **Contactos reais** |
**Impacto:** Sites sem E-E-A-T perderam -15% a -40% tráfego orgânico Q1 2026.
**Impacto:** Sites sem E-E-A-T perderam -15% a -40% trafego organico Q1 2026.
### Helpful Content Update Q1 2026
**Penalizações Automáticas:**
- Conteúdo AI sem edição humana: -30% rankings
**Penalizacoes Automaticas:**
- Conteudo AI sem edicao humana: -30% rankings
- Keyword stuffing (densidade > 3%): -50% rankings
- Thin content (< 300 palavras): Desindexação
- Conteúdo duplicado: Canibalização severa
- Thin content (< 300 palavras): Desindexacao
- Conteudo duplicado: Canibalizacao severa
**Boas Práticas:**
- Conteúdo original, profundo (> 1200 palavras para topics competitivos)
- Múltiplos formatos (texto + imagem + vídeo)
- Actualização regular (timestamp visível)
**Boas Praticas:**
- Conteudo original, profundo (> 1200 palavras para topics competitivos)
- Multiplos formatos (texto + imagem + video)
- Actualizacao regular (timestamp visivel)
---
## ✅ Regras Core
### Meta Tags Essenciais 2026
## Heading Structure (Hierarquia Correcta)
```html
<!-- ✅ Title tag (50-60 caracteres) -->
<title>Keyword Principal | Nome Marca 2026</title>
<!-- CORRECTO: Hierarquia logica -->
<h1>Titulo Principal da Pagina (1 por pagina, keyword principal)</h1>
<h2>Seccao 1 (keyword secundaria)</h2>
<h3>Sub-seccao 1.1</h3>
<h3>Sub-seccao 1.2</h3>
<h2>Seccao 2 (keyword secundaria)</h2>
<!-- ✅ Meta description (150-160 caracteres, CTA claro) -->
<meta name="description" content="Descrição apelativa com keyword, benefício claro e CTA subtil. Actualizado 2026.">
<!-- ✅ Canonical URL (evita duplicação) -->
<link rel="canonical" href="https://site.pt/pagina/">
<!-- ✅ Open Graph (essencial para social shares) -->
<meta property="og:title" content="Título para Social (60 chars)">
<meta property="og:description" content="Descrição social (65 palavras max)">
<meta property="og:image" content="https://site.pt/og-image.jpg">
<meta property="og:url" content="https://site.pt/pagina/">
<meta property="og:type" content="article">
<!-- ✅ Twitter Card -->
<meta name="twitter:card" content="summary_large_image">
<meta name="twitter:title" content="Título Twitter">
<meta name="twitter:description" content="Descrição Twitter">
<meta name="twitter:image" content="https://site.pt/twitter-image.jpg">
<!-- 🆕 2026: Article metadata -->
<meta property="article:published_time" content="2026-02-03T10:00:00Z">
<meta property="article:modified_time" content="2026-02-03T15:30:00Z">
<meta property="article:author" content="Nome Autor">
<meta property="article:section" content="Categoria">
<meta property="article:tag" content="tag1, tag2, tag3">
<!-- ERRADO: Saltar niveis -->
<h1>Titulo</h1>
<h4>Sub-titulo</h4> <!-- Saltou H2 e H3 -->
```
### Structured Data (Schema.org) 2026
```json
// ✅ Organization (Homepage)
{
"@context": "https://schema.org",
"@type": "Organization",
"name": "Nome Empresa",
"url": "https://site.pt",
"logo": "https://site.pt/logo.png",
"sameAs": [
"https://linkedin.com/company/...",
"https://facebook.com/...",
"https://instagram.com/..."
],
"contactPoint": {
"@type": "ContactPoint",
"telephone": "+351-XXX-XXX-XXX",
"contactType": "Customer Service",
"areaServed": "PT",
"availableLanguage": ["pt", "en"]
}
}
// ✅ Article/BlogPosting (EEAT compliant)
{
"@context": "https://schema.org",
"@type": "Article",
"headline": "Título do Artigo",
"author": {
"@type": "Person",
"name": "Nome Autor",
"url": "https://site.pt/autor/nome",
"jobTitle": "Especialista em...",
"knowsAbout": ["Área 1", "Área 2"]
},
"publisher": {
"@type": "Organization",
"name": "Nome Empresa",
"logo": {
"@type": "ImageObject",
"url": "https://site.pt/logo.png"
}
},
"datePublished": "2026-02-03",
"dateModified": "2026-02-03",
"image": "https://site.pt/imagem.jpg",
"articleBody": "Conteúdo completo...",
"wordCount": 1500,
"inLanguage": "pt-PT"
}
// ✅ FAQPage (featured snippets)
{
"@context": "https://schema.org",
"@type": "FAQPage",
"mainEntity": [
{
"@type": "Question",
"name": "Pergunta completa?",
"acceptedAnswer": {
"@type": "Answer",
"text": "Resposta completa e detalhada (min 40 palavras para snippets)."
}
},
{
"@type": "Question",
"name": "Segunda pergunta?",
"acceptedAnswer": {
"@type": "Answer",
"text": "Resposta detalhada..."
}
}
]
}
// 🆕 2026: HowTo Schema (aparece em rich results)
{
"@context": "https://schema.org",
"@type": "HowTo",
"name": "Como fazer X",
"description": "Guia completo passo a passo",
"totalTime": "PT30M",
"estimatedCost": {
"@type": "MonetaryAmount",
"currency": "EUR",
"value": "50"
},
"step": [
{
"@type": "HowToStep",
"name": "Passo 1",
"text": "Descrição detalhada passo 1",
"image": "https://site.pt/passo1.jpg"
},
{
"@type": "HowToStep",
"name": "Passo 2",
"text": "Descrição detalhada passo 2",
"image": "https://site.pt/passo2.jpg"
}
]
}
// 🆕 2026: Review/Rating Schema (produtos/serviços)
{
"@context": "https://schema.org",
"@type": "Product",
"name": "Nome Produto",
"image": "https://site.pt/produto.jpg",
"description": "Descrição produto",
"brand": {
"@type": "Brand",
"name": "Nome Marca"
},
"aggregateRating": {
"@type": "AggregateRating",
"ratingValue": "4.8",
"reviewCount": "127"
},
"offers": {
"@type": "Offer",
"price": "95.00",
"priceCurrency": "EUR",
"availability": "https://schema.org/InStock"
}
}
```
**Boas Praticas 2026:**
- H1: Unica, 60-70 chars, keyword principal
- H2: Keywords secundarias, variacoes LSI
- H3-H6: Long-tail keywords, questoes especificas
- Incluir numeros quando possivel ("7 Formas de...", "Top 10...")
---
## 🏗️ Heading Structure (Hierarquia Correcta)
## On-Page SEO Checklist 2026
```html
<!-- ✅ CORRECTO: Hierarquia lógica -->
<h1>Título Principal da Página (1 por página, keyword principal)</h1>
### Conteudo
<h2>Secção 1 (keyword secundária)</h2>
<h3>Sub-secção 1.1</h3>
<h3>Sub-secção 1.2</h3>
<h2>Secção 2 (keyword secundária)</h2>
<h3>Sub-secção 2.1</h3>
<h4>Detalhe 2.1.1</h4>
<h3>Sub-secção 2.2</h3>
<h2>Secção 3 (keyword secundária)</h2>
<!-- ❌ ERRADO: Saltar níveis -->
<h1>Título</h1>
<h4>Sub-título</h4> <!-- Saltou H2 e H3 - PENALIZADO 2026 -->
<!-- ❌ ERRADO: Múltiplos H1 -->
<h1>Título 1</h1>
<h1>Título 2</h1> <!-- Só 1 H1 permitido -->
```
**Boas Práticas 2026:**
- H1: Única, 60-70 chars, keyword principal
- H2: Keywords secundárias, variações LSI
- H3-H6: Long-tail keywords, questões específicas
- Incluir números quando possível ("7 Formas de...", "Top 10...")
---
## ⚡ Core Web Vitals 2026
| Métrica | Bom | Necessita Melhoria | Mau | **2026 Change** |
|---------|-----|-------------------|-----|-----------------|
| **LCP** | < 2.5s | 2.5-4s | > 4s | Threshold mais rigoroso Q2 (< 2.0s) |
| **INP** | < 200ms | 200-500ms | > 500ms | **Substituiu FID em Jan 2026** |
| **CLS** | < 0.1 | 0.1-0.25 | > 0.25 | Sem mudanças |
### Optimizações LCP 2026
```html
<!-- ✅ Preload imagem hero (crítico) -->
<link rel="preload" as="image" href="/hero.jpg" fetchpriority="high">
<!-- ✅ Lazy loading imagens below-fold -->
<img src="image.jpg" loading="lazy" alt="Descrição">
<!-- ✅ Responsive images (servir tamanho correcto) -->
<img srcset="small.jpg 480w, medium.jpg 800w, large.jpg 1200w"
sizes="(max-width: 600px) 480px, (max-width: 1000px) 800px, 1200px"
src="large.jpg" alt="Descrição">
<!-- ✅ WebP format (60% menor que JPEG) -->
<picture>
<source srcset="image.webp" type="image/webp">
<img src="image.jpg" alt="Descrição">
</picture>
<!-- 🆕 2026: Priority hints -->
<img src="hero.jpg" fetchpriority="high" alt="Hero">
<img src="secondary.jpg" fetchpriority="low" alt="Secondary">
```
### Optimizações INP 2026 (Novo)
```javascript
// ✅ Debounce event handlers
function debounce(func, wait) {
let timeout;
return function executedFunction(...args) {
clearTimeout(timeout);
timeout = setTimeout(() => func(...args), wait);
};
}
const handleInput = debounce((e) => {
// Processar input
}, 300);
// ✅ Code splitting (carregar só necessário)
// Webpack/Vite config
const component = () => import('./HeavyComponent.js');
// ✅ Web Workers (tarefas pesadas off main thread)
const worker = new Worker('worker.js');
worker.postMessage({ task: 'heavy-computation', data });
// ❌ EVITAR: Event listeners síncronos pesados
button.addEventListener('click', () => {
// EVITAR processamento síncrono pesado aqui
for (let i = 0; i < 1000000; i++) { /* ... */ }
});
```
### Optimizações CLS 2026
```css
/* ✅ Definir width/height em imagens */
img {
width: 800px;
height: 600px;
aspect-ratio: 4 / 3;
}
/* ✅ Reservar espaço para ads/embeds */
.ad-container {
min-height: 250px;
background: #f0f0f0;
}
/* ✅ Font loading optimizado */
@font-face {
font-family: 'Custom Font';
src: url('/font.woff2') format('woff2');
font-display: swap; /* ou optional */
}
```
---
## 📝 On-Page SEO Checklist 2026
```markdown
### Conteúdo
- [ ] Keyword no título (primeiros 60 chars)
- [ ] Keyword no H1 (única vez)
- [ ] Keyword no titulo (primeiros 60 chars)
- [ ] Keyword no H1 (unica vez)
- [ ] Keyword nos primeiros 100 caracteres
- [ ] Keywords secundárias em H2/H3
- [ ] LSI keywords distribuídas naturalmente
- [ ] Conteúdo > 1200 palavras (topics competitivos)
- [ ] Keyword density 1-2% (não > 3%)
- [ ] Keywords secundarias em H2/H3
- [ ] LSI keywords distribuidas naturalmente
- [ ] Conteudo > 1200 palavras (topics competitivos)
- [ ] Keyword density 1-2% (nao > 3%)
### Autor e E-E-A-T
- [ ] **Autor identificado** (nome + foto)
- [ ] **Bio autor** (credenciais, experiência)
- [ ] **Data publicação + última actualização**
- [ ] **Experiência real demonstrada** (exemplos, casos)
- [ ] **Bio autor** (credenciais, experiencia)
- [ ] **Data publicacao + ultima actualizacao**
- [ ] **Experiencia real demonstrada** (exemplos, casos)
- [ ] Links para perfis autor (LinkedIn, Twitter)
### Media
- [ ] Alt text descritivo em TODAS as imagens
- [ ] Imagens optimizadas (WebP, < 200KB)
- [ ] Vídeo embed (aumenta tempo na página)
- [ ] Infográficos (linkable assets)
- [ ] Video embed (aumenta tempo na pagina)
- [ ] Infograficos (linkable assets)
### Links
- [ ] 3-5 internal links relevantes
- [ ] 1-3 external links para fontes autoritativas
- [ ] Anchor text descritivo (não "clique aqui")
- [ ] Anchor text descritivo (nao "clique aqui")
- [ ] Links abrem em nova tab (external)
### Técnico
- [ ] URL amigável (curto, keyword, sem parâmetros)
- [ ] Meta description única (150-160 chars)
### Tecnico
- [ ] URL amigavel (curto, keyword, sem parametros)
- [ ] Meta description unica (150-160 chars)
- [ ] Canonical URL definido
- [ ] Open Graph completo
- [ ] Schema.org implementado
@@ -388,101 +134,65 @@ img {
- [ ] Core Web Vitals green
### Engagement
- [ ] CTA claro (call-to-action)
- [ ] FAQ section (featured snippets)
- [ ] Formulário/contacto
- [ ] Formulario/contacto
- [ ] Social share buttons
- [ ] Comentários activos (engagement signal)
```
---
## 🔍 Keyword Research 2026
## Anti-Patterns SEO 2026
### Ferramentas
| Ferramenta | Uso | Métricas |
|------------|-----|----------|
| **Google Keyword Planner** | Volume, CPC | Volume mensal, competição |
| **Ahrefs** | KD, SERP analysis | Keyword Difficulty, DR necessário |
| **Semrush** | Concorrência | Gap analysis, trending |
| **AnswerThePublic** | Long-tail questions | Questões reais utilizadores |
| **Google Trends** | Sazonalidade | Tendência temporal |
### Processo
```
1. **Seed Keywords** - Brainstorm inicial (5-10 keywords principais)
2. **Expand** - Ferramentas para 100+ variações
3. **Filter** - Volume > 50/mês, KD < 60 (para começar)
4. **Analyse Intent** - Informacional, Navegacional, Transacional
5. **Prioritize** - Matriz Volume vs KD vs Relevância
6. **Cluster** - Agrupar por topic, criar pillar content
```
### Keyword Difficulty Benchmarks
| KD | Dificuldade | DR Necessário | Backlinks Estimados |
|----|-------------|---------------|---------------------|
| 0-20 | Muito Fácil | < 20 | 0-5 |
| 21-40 | Fácil | 20-35 | 5-20 |
| 41-60 | Médio | 35-50 | 20-50 |
| 61-80 | Difícil | 50-70 | 50-200 |
| 81-100 | Muito Difícil | > 70 | 200+ |
**Estratégia:** Começar por KD 0-40, escalar para 41-60 após DR > 35.
| Anti-Pattern | Penalizacao 2026 | Solucao |
|--------------|------------------|---------|
| **Keyword stuffing** (> 3%) | -50% rankings | Escrita natural, 1-2% |
| **Conteudo duplicado** | Canibalizacao | Canonical, consolidar |
| **Meta descriptions iguais** | Menos impressoes | Unica por pagina |
| **Imagens sem alt** | -10% accessibility | Alt descritivo |
| **JavaScript-only content** | Nao indexado | SSR/SSG |
| **Redirect chains** | Timeout, bounce | Redirect directo |
| **Thin content** (< 300 palavras) | Desindexacao | Min 800 palavras |
| **Conteudo AI nao editado** | -30% rankings | Edicao humana |
| **Links comprados** | Penalizacao manual | Earn links, guest posts |
| **Hidden text** | Desindexacao | Texto visivel |
---
## 🌐 URL Structure Best Practices
## Ferramentas Recomendadas
```
✅ CORRECTO:
https://site.pt/categoria/keyword-principal/
https://site.pt/blog/como-fazer-energia-solar-2026/
https://site.pt/servicos/instalacao-paineis-solares/
### Validacao
❌ ERRADO:
https://site.pt/p?id=123&cat=5&lang=pt (parâmetros)
https://site.pt/este-url-e-muito-longo-com-muitas-palavras-desnecessarias-que-ninguem-le/ (> 60 chars)
https://site.pt/artigo_novo_23_final_v2/ (underscores, versões)
```
- **Google Search Console** - Monitorizacao, indexacao
- **PageSpeed Insights** - Core Web Vitals
- **Schema Validator** - Testar structured data (schema.org/validator)
- **Mobile-Friendly Test** - Google mobile test
- **Rich Results Test** - Google rich results
**Regras 2026:**
- Máximo 60 caracteres
- Hífens (não underscores)
- Lowercase
- Keyword no início se possível
- Sem stop words (de, o, a, em) quando possível
- Estrutura lógica (site.pt/categoria/subcategoria/artigo)
### Analise
- **Screaming Frog** - Auditoria tecnica completa
- **Ahrefs/Semrush** - Keyword research, backlinks
- **AnswerThePublic** - Long-tail questions
- **Google Trends** - Sazonalidade keywords
### Optimizacao
- **TinyPNG/Squoosh** - Comprimir imagens
- **Cloudflare** - CDN, cache
- **WP Rocket/Autoptimize** - WordPress performance
---
## 🚫 Anti-Patterns SEO 2026
## Checklist Pre-Publicacao
| Anti-Pattern | Problema | Penalização 2026 | Solução |
|--------------|----------|------------------|---------|
| **Keyword stuffing** | Densidade > 3% | -50% rankings | Escrita natural, 1-2% |
| **Conteúdo duplicado** | Canibalização | Ambas páginas caem | Canonical, consolidar |
| **Meta descriptions iguais** | CTR baixo | Menos impressões | Única por página |
| **Imagens sem alt** | A11y + SEO | -10% accessibility score | Alt descritivo |
| **JavaScript-only content** | Indexação | Não indexado | SSR/SSG |
| **Redirect chains** | Page speed | Timeout, bounce alto | Redirect directo |
| **Thin content** | < 300 palavras | Desindexação | Min 800 palavras |
| **Conteúdo AI não editado** | Detectável | -30% rankings | Edição humana, fact-check |
| **Links comprados** | Spam | Penalização manual | Earn links, guest posts |
| **Hidden text** | Spam | Desindexação | Texto visível |
### Tecnico
---
## ✅ Checklist Pré-Publicação
### Técnico
- [ ] Title tag optimizado (50-60 chars, keyword início)
- [ ] Meta description única (150-160 chars, CTA)
- [ ] H1 único com keyword principal
- [ ] Title tag optimizado (50-60 chars, keyword inicio)
- [ ] Meta description unica (150-160 chars, CTA)
- [ ] H1 unico com keyword principal
- [ ] Imagens com alt text descritivo
- [ ] URL amigável (< 60 chars, keyword)
- [ ] URL amigavel (< 60 chars, keyword)
- [ ] Canonical definido
- [ ] Open Graph configurado (title, description, image)
- [ ] Schema.org implementado (Article/FAQPage)
@@ -490,171 +200,43 @@ https://site.pt/artigo_novo_23_final_v2/ (underscores, versões)
- [ ] HTTPS activo
- [ ] Core Web Vitals green (LCP, INP, CLS)
### Conteúdo
### Conteudo
- [ ] > 1200 palavras (topics competitivos)
- [ ] Keyword density 1-2%
- [ ] 2-3 internal links relevantes
- [ ] 1-2 external links autoritativos (DR > 40)
- [ ] Autor identificado + bio
- [ ] Data publicação visível
- [ ] Experiência real demonstrada
- [ ] Data publicacao visivel
- [ ] Experiencia real demonstrada
- [ ] FAQ section (min 3 perguntas)
### Engagement
- [ ] CTA claro e visível
- [ ] Formulário/contacto (se aplicável)
- [ ] CTA claro e visivel
- [ ] Formulario/contacto (se aplicavel)
- [ ] Social share buttons
- [ ] Imagens optimizadas (< 200KB, WebP)
- [ ] Vídeo embed (se relevante)
- [ ] Video embed (se relevante)
---
## 🛠️ Ferramentas Recomendadas
## Referencias Detalhadas
### Validação
- **Google Search Console** - Monitorização, indexação
- **PageSpeed Insights** - Core Web Vitals
- **Schema Validator** - Testar structured data (schema.org/validator)
- **Mobile-Friendly Test** - Google mobile test
- **Rich Results Test** - Google rich results
Para conteudo tecnico detalhado, consultar:
### Análise
- **Screaming Frog** - Auditoria técnica completa
- **Ahrefs/Semrush** - Keyword research, backlinks
- **AnswerThePublic** - Long-tail questions
- **Google Trends** - Sazonalidade keywords
### Optimização
- **TinyPNG/Squoosh** - Comprimir imagens
- **Cloudflare** - CDN, cache
- **WP Rocket/Autoptimize** - WordPress performance
- [references/structured-data.md](references/structured-data.md) - Meta tags completas, Schema.org (Organization, Article, FAQ, HowTo, Product), Core Web Vitals (LCP, INP, CLS com codigo), URL structure, Keyword Research com benchmarks
---
## 📚 Datasets Dify (Consulta Obrigatória)
## Protocolo de Execucao
| Dataset | ID | Prioridade | Uso |
|---------|----|-----------:|-----|
| **SEO (Search Engine Optimization)** | `b93c6475-2f22-412e-ba9d-666eb081b872` | 1 | Técnicas SEO, Google updates |
| **Neil Patel** | `6ff761b3-a054-435c-8fc3-a6e6c3a0afaf` | 1 | Link building, estratégias |
| **Marketing de Conteúdo** | `061f19a3-d4b6-4383-9f44-620742167201` | 2 | E-E-A-T, criação conteúdo |
| **Marketing Digital** | `c1ec779f-4cb1-4ecf-ba11-6b39b93d4e24` | 2 | Estratégia geral |
### Como Consultar
```javascript
// Pesquisar técnicas SEO on-page
mcp__notebooklm__notebook_query, mcp__dify-kb__dify_kb_retrieve_segments({
dataset_id: "b93c6475-2f22-412e-ba9d-666eb081b872",
query: "keyword research on-page optimization 2026"
})
// Estratégias Neil Patel para link building
mcp__dify-kb__dify_kb_retrieve_segments({
dataset_id: "6ff761b3-a054-435c-8fc3-a6e6c3a0afaf",
query: "backlinks content strategy guest posting"
})
// Implementação E-E-A-T
mcp__dify-kb__dify_kb_retrieve_segments({
dataset_id: "061f19a3-d4b6-4383-9f44-620742167201",
query: "google EEAT author credibility experience"
})
// Core Web Vitals optimização
mcp__dify-kb__dify_kb_retrieve_segments({
dataset_id: "b93c6475-2f22-412e-ba9d-666eb081b872",
query: "core web vitals LCP INP CLS optimization"
})
```
### Quando Consultar
- **Keyword research** - Validar abordagem e ferramentas
- **Optimização meta tags** - Exemplos best practices
- **Structured data** - Templates schema.org
- **Link building** - Estratégias white-hat
- **Core Web Vitals** - Soluções técnicas específicas
- **E-E-A-T** - Implementação correcta
1. **Analise Inicial** - Verificar requisitos e contexto
2. **Preparacao** - Validar acesso a recursos
3. **Execucao** - Operacoes incrementais com validacao
4. **Validacao** - Verificar resultados obtidos
5. **Conclusao** - Documentar alteracoes e proximos passos
---
## 📈 Instrumentação Automática
```sql
INSERT INTO tblskill_agent_metrics (
type, name, duration_ms, status, staff_id,
kb_consulted, kb_cache_hit, tool_calls, project_id
) VALUES (
'skill', '/seo-content-optimization', {DURACAO_MS}, '{STATUS}', 25,
{KB_CONSULTADO}, {CACHE_HIT}, {TOOL_CALLS}, {PROJECT_ID}
);
```
---
**Versão**: 2.0.0 | **Autor**: Descomplicar® | **Data**: 2026-02-03
**Desk Task:** #1482 | **Standards:** Google 2026 (E-E-A-T, INP, Helpful Content)
---
## 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 aprovação manual obrigatória
- Quando os requisitos não estão claramente definidos
## Protocolo de Execução
1. **Análise Inicial**
- Verificar requisitos e contexto
- Identificar ferramentas necessárias
2. **Preparação**
- Validar acesso a recursos
- Preparar ambiente de trabalho
3. **Execução**
- Executar operações de forma incremental
- Validar cada passo antes de prosseguir
4. **Validação**
- Verificar resultados obtidos
- Confirmar sucesso da operação
5. **Conclusão**
- Documentar alterações realizadas
- Reportar status final e próximos passos
## Exemplos de Uso
### Exemplo 1: Caso Básico
```
User: [requisição simples relacionada com seo-content-optimization]
Skill: [execução directa com validação]
Output: [resultado conciso e accionável]
```
### Exemplo 2: Caso Complexo
```
User: [requisição multi-passo ou complexa]
Skill:
1. Análise dos requisitos
2. Planeamento da abordagem
3. Execução faseada
4. Validação contínua
Output: [resultado detalhado com próximos passos]
```
### Exemplo 3: Caso com Dependências
```
User: [requisição que depende de outros sistemas]
Skill:
1. Verificar dependências disponíveis
2. Coordenar com skills/MCPs necessários
3. Executar workflow integrado
Output: [resultado completo com referências]
```
**Standards:** Google 2026 (E-E-A-T, INP, Helpful Content)

270
marketing/skills/seo-content-optimization/references/structured-data.md Normal file
View File

@@ -0,0 +1,270 @@
# /seo-content-optimization - Structured Data e Meta Tags
## Meta Tags Essenciais 2026
```html
<!-- Title tag (50-60 caracteres) -->
<title>Keyword Principal | Nome Marca 2026</title>
<!-- Meta description (150-160 caracteres, CTA claro) -->
<meta name="description" content="Descrição apelativa com keyword, benefício claro e CTA subtil. Actualizado 2026.">
<!-- Canonical URL -->
<link rel="canonical" href="https://site.pt/pagina/">
<!-- Open Graph -->
<meta property="og:title" content="Título para Social (60 chars)">
<meta property="og:description" content="Descrição social (65 palavras max)">
<meta property="og:image" content="https://site.pt/og-image.jpg">
<meta property="og:url" content="https://site.pt/pagina/">
<meta property="og:type" content="article">
<!-- Twitter Card -->
<meta name="twitter:card" content="summary_large_image">
<meta name="twitter:title" content="Título Twitter">
<meta name="twitter:description" content="Descrição Twitter">
<meta name="twitter:image" content="https://site.pt/twitter-image.jpg">
<!-- 2026: Article metadata -->
<meta property="article:published_time" content="2026-02-03T10:00:00Z">
<meta property="article:modified_time" content="2026-02-03T15:30:00Z">
<meta property="article:author" content="Nome Autor">
```
---
## Structured Data (Schema.org) 2026
### Organization (Homepage)
```json
{
"@context": "https://schema.org",
"@type": "Organization",
"name": "Nome Empresa",
"url": "https://site.pt",
"logo": "https://site.pt/logo.png",
"sameAs": [
"https://linkedin.com/company/...",
"https://facebook.com/...",
"https://instagram.com/..."
],
"contactPoint": {
"@type": "ContactPoint",
"telephone": "+351-XXX-XXX-XXX",
"contactType": "Customer Service",
"areaServed": "PT",
"availableLanguage": ["pt", "en"]
}
}
```
### Article/BlogPosting (E-E-A-T compliant)
```json
{
"@context": "https://schema.org",
"@type": "Article",
"headline": "Título do Artigo",
"author": {
"@type": "Person",
"name": "Nome Autor",
"url": "https://site.pt/autor/nome",
"jobTitle": "Especialista em...",
"knowsAbout": ["Área 1", "Área 2"]
},
"publisher": {
"@type": "Organization",
"name": "Nome Empresa",
"logo": {
"@type": "ImageObject",
"url": "https://site.pt/logo.png"
}
},
"datePublished": "2026-02-03",
"dateModified": "2026-02-03",
"image": "https://site.pt/imagem.jpg",
"wordCount": 1500,
"inLanguage": "pt-PT"
}
```
### FAQPage (featured snippets)
```json
{
"@context": "https://schema.org",
"@type": "FAQPage",
"mainEntity": [
{
"@type": "Question",
"name": "Pergunta completa?",
"acceptedAnswer": {
"@type": "Answer",
"text": "Resposta completa e detalhada (min 40 palavras para snippets)."
}
}
]
}
```
### HowTo Schema (rich results 2026)
```json
{
"@context": "https://schema.org",
"@type": "HowTo",
"name": "Como fazer X",
"description": "Guia completo passo a passo",
"totalTime": "PT30M",
"step": [
{
"@type": "HowToStep",
"name": "Passo 1",
"text": "Descrição detalhada passo 1",
"image": "https://site.pt/passo1.jpg"
}
]
}
```
### Review/Rating Schema (produtos)
```json
{
"@context": "https://schema.org",
"@type": "Product",
"name": "Nome Produto",
"brand": { "@type": "Brand", "name": "Nome Marca" },
"aggregateRating": {
"@type": "AggregateRating",
"ratingValue": "4.8",
"reviewCount": "127"
},
"offers": {
"@type": "Offer",
"price": "95.00",
"priceCurrency": "EUR",
"availability": "https://schema.org/InStock"
}
}
```
---
## Core Web Vitals 2026
| Métrica | Bom | Necessita Melhoria | Mau | Mudança 2026 |
|---------|-----|-------------------|-----|--------------|
| **LCP** | < 2.5s | 2.5-4s | > 4s | Threshold < 2.0s Q2 |
| **INP** | < 200ms | 200-500ms | > 500ms | Substituiu FID em Jan 2026 |
| **CLS** | < 0.1 | 0.1-0.25 | > 0.25 | Sem mudanças |
### Optimizações LCP
```html
<!-- Preload imagem hero -->
<link rel="preload" as="image" href="/hero.jpg" fetchpriority="high">
<!-- Lazy loading imagens below-fold -->
<img src="image.jpg" loading="lazy" alt="Descrição">
<!-- Responsive images -->
<img srcset="small.jpg 480w, medium.jpg 800w, large.jpg 1200w"
sizes="(max-width: 600px) 480px, (max-width: 1000px) 800px, 1200px"
src="large.jpg" alt="Descrição">
<!-- WebP format -->
<picture>
<source srcset="image.webp" type="image/webp">
<img src="image.jpg" alt="Descrição">
</picture>
```
### Optimizações INP (novo 2026)
```javascript
// Debounce event handlers
function debounce(func, wait) {
let timeout;
return function executedFunction(...args) {
clearTimeout(timeout);
timeout = setTimeout(() => func(...args), wait);
};
}
// Code splitting
const component = () => import('./HeavyComponent.js');
// Web Workers para tarefas pesadas
const worker = new Worker('worker.js');
worker.postMessage({ task: 'heavy-computation', data });
```
### Optimizações CLS
```css
/* Definir width/height em imagens */
img {
width: 800px;
height: 600px;
aspect-ratio: 4 / 3;
}
/* Reservar espaço para ads */
.ad-container { min-height: 250px; }
/* Font loading */
@font-face {
font-family: 'Custom Font';
src: url('/font.woff2') format('woff2');
font-display: swap;
}
```
---
## URL Structure Best Practices
```
CORRECTO:
https://site.pt/categoria/keyword-principal/
https://site.pt/blog/como-fazer-energia-solar-2026/
ERRADO:
https://site.pt/p?id=123&cat=5&lang=pt
https://site.pt/este-url-e-muito-longo-com-muitas-palavras-desnecessarias/
```
**Regras 2026:**
- Máximo 60 caracteres
- Hífens (não underscores)
- Lowercase
- Keyword no início se possível
- Sem stop words quando possível
---
## Keyword Research
### Ferramentas
| Ferramenta | Uso | Métricas |
|------------|-----|----------|
| Google Keyword Planner | Volume, CPC | Volume mensal, competição |
| Ahrefs | KD, SERP analysis | Keyword Difficulty, DR necessário |
| Semrush | Concorrência | Gap analysis, trending |
| AnswerThePublic | Long-tail questions | Questões reais utilizadores |
| Google Trends | Sazonalidade | Tendência temporal |
### Keyword Difficulty Benchmarks
| KD | Dificuldade | DR Necessário |
|----|-------------|---------------|
| 0-20 | Muito Fácil | < 20 |
| 21-40 | Fácil | 20-35 |
| 41-60 | Médio | 35-50 |
| 61-80 | Difícil | 50-70 |
| 81-100 | Muito Difícil | > 70 |
**Estratégia:** Começar por KD 0-40, escalar para 41-60 após DR > 35.

597
marketing/skills/seo-report/SKILL.md
View File

@@ -1,575 +1,146 @@
---
name: seo-report
description: >
Complete SEO audit report with Lighthouse, Google Search Console, SEO Tools API and exports to Google Docs. Analyzes Core Web Vitals, performance, on-page SEO, backlinks and generates actionable recommendations.
Use when auditing website SEO, analyzing performance metrics, generating client reports, or when user mentions
"seo audit", "lighthouse", "core web vitals", "search console", "seo analysis", "performance report", "website audit", "google docs report".
author: Descomplicar® Crescimento Digital
version: 2.1.0
user_invocable: true
tags: [seo, audit, lighthouse, gsc, google-docs, core-web-vitals, performance]
desk_task: 1483
allowed-tools: mcp__lighthouse__run_audit, mcp__lighthouse__get_core_web_vitals, mcp__gsc__get_search_analytics, mcp__google-workspace__create_doc, WebFetch
category: content
quality_score: 90
updated: "2026-02-04T18:00:00Z"
description: Relatorio de auditoria SEO completo com Lighthouse, Google Search Console e exportacao para Google Docs. Analisa Core Web Vitals, desempenho, SEO on-page e gera recomendacoes accionaveis.
---
# Skill: /seo-report
Gera relatório SEO completo com dados de múltiplas fontes e exporta automaticamente para Google Docs.
Gera relatorio SEO completo com dados de multiplas fontes e exporta automaticamente para Google Docs.
---
## 🎯 Trigger
## Contexto NotebookLM
ANTES de executar, consultar notebook para contexto especializado:
| Notebook | ID | Consultar quando |
|----------|-----|-----------------|
| Marketing Digital PT | `4c595973` | Sempre |
```
mcp__notebooklm__notebook_query({
notebook_id: "4c595973-ba10-420a-a3bf-e4389e424ad3",
query: "<adaptar ao contexto — ex: auditoria SEO, relatorio performance, recomendacoes tecnicas>"
})
```
**Procedimento relacionado:** `PROC-DMARC-Email-Entregabilidade.md` -- consultar quando o relatorio envolve email deliverability.
---
## Trigger
`/seo-report <url>` ou `/seo-report <url> <email_destino>`
---
## 💡 Exemplos
## Exemplos
```bash
# Relatório básico (envia para emanuelalmeidaa@gmail.com)
# Relatorio basico (envia para emanuelalmeidaa@gmail.com)
/seo-report https://descomplicar.pt
# Relatório para cliente específico
# Relatorio para cliente especifico
/seo-report https://cliente.pt cliente@email.com
# Relatório com análise concorrência
# Relatorio com analise concorrencia
/seo-report https://site.pt --competitors=concorrente1.pt,concorrente2.pt
```
---
## 📊 Fontes de Dados
## Fontes de Dados
| Fonte | Dados Recolhidos | Tempo |
|-------|------------------|-------|
| **Lighthouse (Desktop)** | Performance, SEO, Accessibility, Best Practices | ~30s |
| **Lighthouse (Mobile)** | Core Web Vitals, INP, comparação mobile/desktop | ~30s |
| **Lighthouse (Optimizações)** | Oportunidades LCP, JS não usado, images optimization | ~15s |
| **GSC** | Cliques, impressões, CTR, posição média, top queries, tendência 90 dias | ~10s |
| **Lighthouse (Mobile)** | Core Web Vitals, INP, comparacao mobile/desktop | ~30s |
| **Lighthouse (Optimizacoes)** | Oportunidades LCP, JS nao usado, images optimization | ~15s |
| **GSC** | Cliques, impressoes, CTR, posicao media, top queries, tendencia 90 dias | ~10s |
| **SEO Tools API** | Meta tags, imagens, alt text, links internos/externos, estrutura HTML | ~5s |
| **Ahrefs (opcional)** | DR, UR, backlinks, referring domains | ~10s |
**Tempo Total:** ~1m40s (sem concorrência) | ~3m (com 2 concorrentes)
**Tempo Total:** ~1m40s (sem concorrencia) | ~3m (com 2 concorrentes)
---
## 📄 Output - Google Doc
## Workflow
### Estrutura do Documento
```markdown
# Relatório SEO - [DOMÍNIO]
Data: YYYY-MM-DD | Versão 2.0 (2026 Standards)
1. Validar URL de entrada
2. Verificar se site esta no GSC (skip se nao)
3. Executar auditorias em paralelo:
- Lighthouse Desktop + Mobile
- Core Web Vitals
- SEO Tools API
- GSC Analytics (se disponivel)
- Ahrefs (se habilitado)
4. Processar e formatar dados
5. Gerar relatorio Markdown
6. Criar Google Doc e partilhar
7. Retornar link do documento
---
## 🎯 Sumário Executivo
## Estrutura do Relatorio
**Principais Descobertas (Top 5):**
1. [Crítico] Core Web Vitals - INP > 500ms (target < 200ms)
2. [Importante] E-E-A-T - Sem autor identificado em 80% dos artigos
3. [Melhoria] CTR GSC - Posição 4-10 com CTR < 3%
4. [Oportunidade] 15 keywords posição 11-20 (easy wins)
5. [Acção Imediata] 47 imagens sem alt text (SEO + A11y)
O relatorio final tem 8 seccoes:
**Acção Imediata Recomendada:**
> Optimizar INP removendo 350KB JS não usado (-40% bundle size)
> ROI esperado: Posição média +2 ranks, CTR +0.8pp
1. **Sumario Executivo** -- Top 5 descobertas + accao imediata recomendada
2. **Pontuacoes Globais** -- Desktop vs Mobile (Performance, SEO, A11y, Best Practices)
3. **Core Web Vitals** -- LCP, INP, CLS com oportunidades de optimizacao
4. **GSC Analytics** -- Performance overview, top queries, oportunidades CTR (ultimos 90 dias)
5. **Analise On-Page** -- Meta tags, imagens SEO, internal linking
6. **Backlinks e Autoridade** -- DR, UR, top backlinks, estrategia
7. **Plano de Accao** -- Priorizado (critico/importante/melhoria) com impacto e esforco
8. **Roadmap Trimestral** -- Fundacao tecnica -> Conteudo e autoridade -> Consolidacao
---
## 📊 1. Pontuações Globais
### Desktop vs Mobile
| Métrica | Desktop | Mobile | Gap | Target 2026 |
|---------|---------|--------|-----|-------------|
| **Performance** | 85/100 🟡 | 62/100 🔴 | -23 | > 90 |
| **SEO** | 92/100 🟢 | 88/100 🟡 | -4 | > 95 |
| **Accessibility** | 78/100 🟡 | 78/100 🟡 | 0 | > 90 |
| **Best Practices** | 95/100 🟢 | 92/100 🟢 | -3 | > 95 |
**Análise Gap Mobile:** Dispositivos móveis representam 75% do tráfego. Gap de -23 pontos é crítico.
---
## ⚡ 2. Core Web Vitals
### Comparação Mobile vs Desktop
| Métrica | Mobile | Desktop | Threshold 2026 | Status |
|---------|--------|---------|----------------|--------|
| **LCP** | 2.8s | 1.9s | < 2.5s | 🟡 / ✅ |
| **INP** | 520ms | 180ms | < 200ms | 🔴 / ✅ |
| **CLS** | 0.08 | 0.05 | < 0.1 | ✅ / ✅ |
**Diagnóstico INP Mobile:**
- Main thread bloqueado 3.2s durante load
- Event handlers complexos (listeners + 200ms)
- Third-party scripts: Google Analytics, Facebook Pixel, Hotjar
### Oportunidades LCP
| Oportunidade | Savings | Prioridade |
|--------------|---------|------------|
| Preload imagem hero (`/images/hero.jpg`) | 1.2s | 🔴 Crítico |
| Lazy load below-fold (15 imagens) | 800ms | 🟡 Alto |
| Optimizar TTFB (servidor response) | 400ms | 🟡 Alto |
| Comprimir imagens WebP (85% quality) | 600ms | 🟢 Médio |
### Oportunidades INP
| Oportunidade | Savings | Prioridade |
|--------------|---------|------------|
| Remover JS não usado (350KB) | 280ms | 🔴 Crítico |
| Code splitting (carregar on-demand) | 180ms | 🟡 Alto |
| Defer third-party scripts | 120ms | 🟡 Alto |
| Optimizar event listeners | 80ms | 🟢 Médio |
---
## 🔍 3. GSC Analytics (Últimos 90 dias)
### Performance Overview
| Métrica | Valor | vs 90 dias anteriores | Tendência |
|---------|-------|------------------------|-----------|
| **Cliques** | 12,450 | +18% (+1,890) | 📈 |
| **Impressões** | 245,800 | +22% (+44,300) | 📈 |
| **CTR Médio** | 5.1% | -0.3pp | 📉 |
| **Posição Média** | 12.8 | +2.1 (pior) | 📉 |
**Análise de Tendência:**
- ✅ **Impressões crescem** - Conteúdo está a ganhar visibilidade
- ⚠️ **Posição média caiu** - Concorrência aumentou
- ⚠️ **CTR desceu** - Meta descriptions precisam optimização
### Top 10 Queries
| Query | Cliques | Impr. | CTR | Pos. | Oportunidade |
|-------|---------|-------|-----|------|--------------|
| energia solar fotovoltaica | 850 | 15,200 | 5.6% | 8.2 | 🟡 Optimizar para top 5 |
| painéis solares preço | 720 | 9,800 | 7.3% | 4.5 | ✅ Manter |
| instalação solar | 680 | 22,400 | 3.0% | 14.8 | 🔴 Melhorar CTR + posição |
| como funciona energia solar | 520 | 12,100 | 4.3% | 11.2 | 🟡 Easy win (target top 10) |
| ... | ... | ... | ... | ... | ... |
### Oportunidades Identificadas
**🎯 Quick Wins (Posição 11-20, > 1000 impressões):**
15 keywords com potencial top 10 através de optimização on-page
**🔴 CTR Abaixo da Média (Posição 1-10, CTR < 5%):**
8 keywords necessitam meta description rewrite
**📈 Trending Up (Crescimento > 50% impressões):**
- "bateria solar" - +120% impressões
- "autoconsumo energia" - +85% impressões
---
## 🛠️ 4. Análise On-Page
### Meta Tags Audit
| Página | Title | Description | Issues |
|--------|-------|-------------|--------|
| Homepage | ✅ 58 chars | ⚠️ 175 chars (muito longo) | Description > 160 chars |
| /servicos | ✅ 52 chars | ✅ 155 chars | - |
| /blog/energia-solar | ❌ 28 chars (curto) | ❌ Duplicado (5 páginas) | Title curto, description duplicada |
| ... | ... | ... | ... |
**Problemas Globais:**
- 12 páginas com title < 40 chars
- 8 páginas com description > 160 chars
- 5 páginas com meta description duplicada
- 3 páginas sem canonical URL
### Imagens SEO
| Métrica | Valor | Target | Status |
|---------|-------|--------|--------|
| **Total Imagens** | 127 | - | - |
| **Com Alt Text** | 80 (63%) | 100% | 🔴 |
| **Alt Text Descritivo** | 52 (41%) | 100% | 🔴 |
| **Formato WebP** | 15 (12%) | > 80% | 🔴 |
| **Lazy Loading** | 45 (35%) | 100% (below-fold) | 🟡 |
**Acção:** Adicionar alt text descritivo às 47 imagens sem texto.
### Internal Linking
| Métrica | Valor | Benchmark |
|---------|-------|-----------|
| **Links Internos Médios/Página** | 8.5 | > 10 bom |
| **Orphan Pages** | 3 | 0 ideal |
| **Broken Internal Links** | 7 | 0 |
| **Anchor Text Optimizado** | 42% | > 70% |
**Orphan Pages (sem links internos):**
1. `/blog/manutencao-paineis` (450 impressões/mês GSC)
2. `/faq/garantias` (280 impressões/mês)
3. `/recursos/calculadora` (190 impressões/mês)
---
## 🔗 5. Backlinks e Autoridade
### Perfil de Domínio
| Métrica | Valor | Benchmark | Status |
|---------|-------|-----------|--------|
| **Domain Rating (DR)** | 32 | > 40 bom | 🟡 |
| **URL Rating (UR) Médio** | 18 | > 25 bom | 🔴 |
| **Backlinks Totais** | 1,247 | - | - |
| **Referring Domains** | 87 | > 100 bom | 🟡 |
| **DoFollow** | 68% | > 60% | ✅ |
### Top 10 Backlinks (por DR)
| Domínio | DR | Anchor Text | DoFollow | Tipo |
|---------|-----|-------------|----------|------|
| portal-energia.pt | 58 | energia solar portugal | Sim | Editorial |
| apren.pt | 72 | apren-renewable-energy | Sim | Associação |
| jornaleconomico.pt | 65 | sector fotovoltaico | Sim | Media |
| energias-renovaveis.com | 48 | [Brand Name] | Sim | Directório |
| ... | ... | ... | ... | ... |
### Estratégia Backlinks Q1-Q2 2026
**🎯 Objectivo:** DR 40+ até Junho 2026
**Táticas:**
1. **Guest Posts** (Target: 6 posts, DR > 40)
- portal-energia.pt - Artigo sobre inovação solar
- ambientemagazine.pt - Case study instalação comercial
- idealista.pt - Guia valorização imóvel com solar
2. **Broken Link Building** (15 oportunidades identificadas)
- Links quebrados em sites DR > 35 no sector
3. **Digital PR**
- Press release: Projecto inovador cliente X
- Participação podcast "Energia do Futuro"
- Webinar parceria APREN
---
## 🏆 6. Benchmarks vs Concorrência
### Comparação Performance
| Métrica | [Site] | Concorrente A | Concorrente B | Gap |
|---------|--------|---------------|---------------|-----|
| DR | 32 | 45 | 38 | -13 |
| Traffic Estimado | 12.5K/mês | 28K/mês | 18K/mês | -15.5K |
| Ranking Keywords | 450 | 820 | 610 | -370 |
| Backlinks | 1,247 | 3,200 | 2,100 | -1,953 |
### Keywords Gap
**Oportunidades (Keywords concorrentes não exploramos):**
1. "energia solar empresas" - Vol 2.4K, KD 35 (Concorrente A pos 3)
2. "comparar paineis solares" - Vol 1.8K, KD 28 (Concorrente B pos 5)
3. "custos instalação solar" - Vol 3.2K, KD 42 (Ambos top 10)
---
## 🎯 7. Plano de Acção (Priorizado)
### 🔴 Crítico (Semana 1-2)
| Acção | Impacto Estimado | Esforço | ROI |
|-------|------------------|---------|-----|
| **Optimizar INP Mobile** (remover JS não usado 350KB) | Posição média +2, CTR +0.8pp | 8h | 🔥 Alto |
| **Adicionar alt text 47 imagens** | Acessibilidade +15 pontos, SEO +5% | 3h | 🔥 Alto |
| **Corrigir 7 links internos quebrados** | UX, crawl efficiency +10% | 1h | ⭐ Médio |
| **Reescrever 8 meta descriptions** (CTR baixo) | CTR +1.2pp estimado | 2h | 🔥 Alto |
### 🟡 Importante (Semana 3-4)
| Acção | Impacto Estimado | Esforço | ROI |
|-------|------------------|---------|-----|
| **Optimizar 15 keywords posição 11-20** | +1,200 cliques/mês | 12h | ⭐ Médio |
| **Implementar E-E-A-T** (autor, bio, datas) | Trust signals, rankings +5% | 6h | ⭐ Médio |
| **Internal linking 3 orphan pages** | Indexabilidade, link equity | 2h | ⭐ Médio |
| **Converter imagens WebP** | LCP -600ms | 4h | ⭐ Médio |
### 🟢 Melhoria (Mês 2-3)
| Acção | Impacto Estimado | Esforço | ROI |
|-------|------------------|---------|-----|
| **Criar conteúdo keywords gap** (3 artigos) | +2K visitas/mês | 20h | ⭐ Médio |
| **Campanha backlinks DR > 40** (6 guest posts) | DR +5, autoridade | 30h | ⚡ Baixo |
| **Optimizar structured data** | Rich snippets, CTR +0.5pp | 6h | ⚡ Baixo |
---
## 📅 8. Roadmap Trimestral
### Mês 1: Fundação Técnica
**Objectivo:** Core Web Vitals All Green, SEO Score > 95
- Semana 1-2: Críticos (INP, alt text, links quebrados, meta descriptions)
- Semana 3-4: Importantes (keywords 11-20, E-E-A-T, orphan pages)
**KPIs:**
- INP Mobile < 200ms ✅
- SEO Score > 95 ✅
- CTR médio > 5.5% ✅
### Mês 2: Conteúdo e Autoridade
**Objectivo:** +30% tráfego orgânico, DR 38+
- Criar 3 artigos keywords gap (2.4K + 1.8K + 3.2K vol)
- 3 guest posts DR > 40
- Optimizar 20 artigos existentes (posição 11-30)
**KPIs:**
- Tráfego orgânico: 16K/mês (+28%) ✅
- Backlinks novos: +15 DR > 35 ✅
- DR: 38+ ✅
### Mês 3: Consolidação e Escala
**Objectivo:** Top 10 para 10+ keywords principais
- Monitorizar rankings e ajustar on-page
- 3 guest posts adicionais
- Expandir internal linking (cluster content)
- Actualizar conteúdo underperforming
**KPIs:**
- Keywords top 10: 25+ ✅
- Cliques GSC: 18K/mês (+44%) ✅
- Posição média: < 10.0 ✅
---
## 🔧 Ferramentas Utilizadas
- ✅ **Lighthouse MCP** - Performance, Core Web Vitals, Accessibility
- ✅ **Google Search Console MCP** - Queries, cliques, CTR, posição
- ✅ **SEO Tools API** - Meta tags, imagens, internal linking
- ✅ **Ahrefs API** (opcional) - DR, UR, backlinks
- ✅ **Google Workspace MCP** - Criação e partilha Google Doc
---
## 📊 Anexos
### A. Metodologia
- Lighthouse: 3 runs, mediana reportada
- GSC: Últimos 90 dias completos
- Thresholds: Google 2026 Standards
### B. Glossário
- **DR**: Domain Rating (Ahrefs)
- **INP**: Interaction to Next Paint (substitui FID em 2026)
- **E-E-A-T**: Experience, Expertise, Authoritativeness, Trust
- **CTR**: Click-Through Rate
---
**Próxima Auditoria Recomendada:** [Data + 3 meses]
**Contacto Suporte:** recursos@descomplicar.pt
## Propriedades GSC Disponiveis
```
sc-domain:descomplicar.pt
https://emanuelalmeida.pt/
https://carstuff.pt/
https://solarfvengenharia.com/
https://aquisevende.pt/
https://alojadamaria.com/
https://e-commerce.descomplicar.pt/
```
---
## 🔄 Workflow Técnico
```mermaid
graph LR
A[Input: URL] --> B{Site em GSC?}
B -->|Sim| C[Recolher dados GSC]
B -->|Não| D[Skip GSC, aviso]
C --> E[Lighthouse Desktop]
D --> E
E --> F[Lighthouse Mobile]
F --> G[Core Web Vitals]
G --> H[SEO Tools API]
H --> I{Ahrefs habilitado?}
I -->|Sim| J[Recolher DR/UR]
I -->|Não| K[Skip Ahrefs]
J --> L[Processar dados]
K --> L
L --> M[Gerar relatório Markdown]
M --> N[Criar Google Doc]
N --> O[Partilhar com email]
O --> P[Retornar link]
```
### Implementação
```javascript
async function generateSEOReport(url, options = {}) {
const {
email = 'emanuelalmeidaa@gmail.com',
competitors = [],
includeAhrefs = true
} = options;
// 1. Validar URL
if (!isValidURL(url)) {
throw new Error('URL inválido');
}
// 2. Recolher dados em paralelo (melhor performance)
const [
lighthouseDesktop,
lighthouseMobile,
coreWebVitals,
seoToolsData,
gscData,
ahrefsData
] = await Promise.allSettled([
mcp__lighthouse__run_audit(url, 'desktop'),
mcp__lighthouse__run_audit(url, 'mobile'),
mcp__lighthouse__get_core_web_vitals(url),
fetch(`http://localhost:3000/seo-audit?url=${url}`).then(r => r.json()),
getGSCData(url), // Verifica se property existe
includeAhrefs ? getAhrefsData(url) : null
]);
// 3. Processar e formatar
const reportData = {
url,
date: new Date().toISOString().split('T')[0],
scores: extractScores(lighthouseDesktop, lighthouseMobile),
cwv: processCoreWebVitals(coreWebVitals),
gsc: processGSCData(gscData),
onPage: processOnPageData(seoToolsData),
backlinks: processBacklinks(ahrefsData),
recommendations: generateRecommendations(/* all data */)
};
// 4. Gerar documento Markdown
const markdown = generateReportMarkdown(reportData);
// 5. Criar Google Doc
const docResult = await mcp__google-workspace__create_doc({
title: `Relatório SEO - ${extractDomain(url)} - ${reportData.date}`,
body_content: markdown,
user_google_email: email
});
// 6. Retornar link
return {
success: true,
doc_url: docResult.url,
summary: reportData.recommendations.slice(0, 5)
};
}
```
---
## 🎨 Propriedades GSC Disponíveis
```javascript
const GSC_PROPERTIES = [
'sc-domain:descomplicar.pt',
'https://emanuelalmeida.pt/',
'https://carstuff.pt/',
'https://solarfvengenharia.com/',
'https://aquisevende.pt/',
'https://alojadamaria.com/',
'https://e-commerce.descomplicar.pt/'
];
// Verificar se site está em GSC antes de tentar recolher dados
async function getGSCData(url) {
const domain = extractDomain(url);
const property = GSC_PROPERTIES.find(p => p.includes(domain));
if (!property) {
console.warn(`Site ${domain} não está no GSC. Dados GSC não disponíveis.`);
return null;
}
const analytics = await mcp__gsc__get_search_analytics({
site_url: property,
start_date: daysAgo(90),
end_date: 'today',
dimensions: ['query'],
row_limit: 100
});
return analytics;
}
```
---
## 📚 Datasets Dify (Consultar SEMPRE)
| Dataset | ID | Uso |
|---------|----|----|
| **SEO (Search Engine Optimization)** | `b93c6475-2f22-412e-ba9d-666eb081b872` | Técnicas SEO, Google updates |
| **Neil Patel** | `6ff761b3-a054-435c-8fc3-a6e6c3a0afaf` | Link building, estratégias |
| **Marketing de Conteúdo** | `061f19a3-d4b6-4383-9f44-620742167201` | E-E-A-T, criação conteúdo |
| **Marketing Digital** | `c1ec779f-4cb1-4ecf-ba11-6b39b93d4e24` | Estratégia geral |
### Como Consultar
```javascript
// Validar recomendações técnicas
mcp__notebooklm__notebook_query, mcp__dify-kb__dify_kb_retrieve_segments({
dataset_id: "b93c6475-2f22-412e-ba9d-666eb081b872",
query: "INP optimization javascript performance 2026"
})
// Estratégias link building
mcp__dify-kb__dify_kb_retrieve_segments({
dataset_id: "6ff761b3-a054-435c-8fc3-a6e6c3a0afaf",
query: "guest posting outreach backlinks"
})
```
---
## ⚙️ Notas Técnicas
## Notas Tecnicas
### Requisitos
- SEO Tools API a correr: `~/mcp-servers/seo-tools-api/start.sh`
- Google Workspace MCP configurado
- GSC authentication (OAuth primeira vez)
### Performance
- Execução paralela de tools (1m40s total)
- Cache Lighthouse results (5 min TTL)
- Rate limiting Ahrefs API (100 req/day free)
### Erros Comuns
- **Site não em GSC:** Relatório gerado sem dados GSC
- **Lighthouse timeout:** Retry automático (3x)
- **Ahrefs rate limit:** Skip backlinks, aviso no relatório
- **Site nao em GSC:** Relatorio gerado sem dados GSC (aviso incluido)
- **Lighthouse timeout:** Retry automatico (3x)
- **Ahrefs rate limit:** Skip backlinks, aviso no relatorio
---
## 📈 Instrumentação Automática
## References (conteudo detalhado)
```sql
INSERT INTO tblskill_agent_metrics (
type, name, duration_ms, status, staff_id,
kb_consulted, kb_cache_hit, tool_calls, project_id
) VALUES (
'skill', '/seo-report', {DURACAO_MS}, '{STATUS}', 25,
{KB_CONSULTADO}, {CACHE_HIT}, {TOOL_CALLS}, {PROJECT_ID}
);
```
| Ficheiro | Conteudo |
|----------|----------|
| `references/template-relatorio.md` | Template completo do relatorio com todas as tabelas e seccoes |
| `references/implementacao-tecnica.md` | Workflow mermaid, codigo JS, funcoes GSC, notas tecnicas |
---
**Versão:** 2.0.0 | **Autor:** Descomplicar® | **Data:** 2026-02-03
**Desk Task:** #1483 | **Output:** Google Docs automático
## Anti-Patterns
- Gerar relatorio sem dados reais (sempre usar MCPs)
- Ignorar gap mobile/desktop
- Nao priorizar recomendacoes (tudo parece igual)
- Esquecer de verificar se site esta no GSC antes de tentar recolher dados
- Relatorio sem accoes concretas e estimativas de impacto
---
**Versao:** 2.1.0 | **Autor:** Descomplicar

144
marketing/skills/seo-report/references/implementacao-tecnica.md Normal file
View File

@@ -0,0 +1,144 @@
# Implementacao Tecnica - SEO Report
## Workflow Tecnico
```mermaid
graph LR
A[Input: URL] --> B{Site em GSC?}
B -->|Sim| C[Recolher dados GSC]
B -->|Nao| D[Skip GSC, aviso]
C --> E[Lighthouse Desktop]
D --> E
E --> F[Lighthouse Mobile]
F --> G[Core Web Vitals]
G --> H[SEO Tools API]
H --> I{Ahrefs habilitado?}
I -->|Sim| J[Recolher DR/UR]
I -->|Nao| K[Skip Ahrefs]
J --> L[Processar dados]
K --> L
L --> M[Gerar relatorio Markdown]
M --> N[Criar Google Doc]
N --> O[Partilhar com email]
O --> P[Retornar link]
```
## Implementacao
```javascript
async function generateSEOReport(url, options = {}) {
const {
email = 'emanuelalmeidaa@gmail.com',
competitors = [],
includeAhrefs = true
} = options;
// 1. Validar URL
if (!isValidURL(url)) {
throw new Error('URL invalido');
}
// 2. Recolher dados em paralelo (melhor performance)
const [
lighthouseDesktop,
lighthouseMobile,
coreWebVitals,
seoToolsData,
gscData,
ahrefsData
] = await Promise.allSettled([
mcp__lighthouse__run_audit(url, 'desktop'),
mcp__lighthouse__run_audit(url, 'mobile'),
mcp__lighthouse__get_core_web_vitals(url),
fetch(`http://localhost:3000/seo-audit?url=${url}`).then(r => r.json()),
getGSCData(url),
includeAhrefs ? getAhrefsData(url) : null
]);
// 3. Processar e formatar
const reportData = {
url,
date: new Date().toISOString().split('T')[0],
scores: extractScores(lighthouseDesktop, lighthouseMobile),
cwv: processCoreWebVitals(coreWebVitals),
gsc: processGSCData(gscData),
onPage: processOnPageData(seoToolsData),
backlinks: processBacklinks(ahrefsData),
recommendations: generateRecommendations(/* all data */)
};
// 4. Gerar documento Markdown
const markdown = generateReportMarkdown(reportData);
// 5. Criar Google Doc
const docResult = await mcp__google-workspace__create_doc({
title: `Relatorio SEO - ${extractDomain(url)} - ${reportData.date}`,
body_content: markdown,
user_google_email: email
});
// 6. Retornar link
return {
success: true,
doc_url: docResult.url,
summary: reportData.recommendations.slice(0, 5)
};
}
```
## Propriedades GSC Disponiveis
```javascript
const GSC_PROPERTIES = [
'sc-domain:descomplicar.pt',
'https://emanuelalmeida.pt/',
'https://carstuff.pt/',
'https://solarfvengenharia.com/',
'https://aquisevende.pt/',
'https://alojadamaria.com/',
'https://e-commerce.descomplicar.pt/'
];
async function getGSCData(url) {
const domain = extractDomain(url);
const property = GSC_PROPERTIES.find(p => p.includes(domain));
if (!property) {
console.warn(`Site ${domain} nao esta no GSC. Dados GSC nao disponiveis.`);
return null;
}
const analytics = await mcp__gsc__get_search_analytics({
site_url: property,
start_date: daysAgo(90),
end_date: 'today',
dimensions: ['query'],
row_limit: 100
});
return analytics;
}
```
## Notas Tecnicas
### Requisitos
- SEO Tools API a correr: `~/mcp-servers/seo-tools-api/start.sh`
- Google Workspace MCP configurado
- GSC authentication (OAuth primeira vez)
### Performance
- Execucao paralela de tools (1m40s total)
- Cache Lighthouse results (5 min TTL)
- Rate limiting Ahrefs API (100 req/day free)
### Erros Comuns
- **Site nao em GSC:** Relatorio gerado sem dados GSC
- **Lighthouse timeout:** Retry automatico (3x)
- **Ahrefs rate limit:** Skip backlinks, aviso no relatorio

220
marketing/skills/seo-report/references/template-relatorio.md Normal file
View File

@@ -0,0 +1,220 @@
# Template Relatorio SEO
```markdown
# Relatorio SEO - [DOMINIO]
Data: YYYY-MM-DD | Versao 2.0 (2026 Standards)
---
## Sumario Executivo
**Principais Descobertas (Top 5):**
1. [Critico] Core Web Vitals - INP > 500ms (target < 200ms)
2. [Importante] E-E-A-T - Sem autor identificado em 80% dos artigos
3. [Melhoria] CTR GSC - Posicao 4-10 com CTR < 3%
4. [Oportunidade] 15 keywords posicao 11-20 (easy wins)
5. [Accao Imediata] 47 imagens sem alt text (SEO + A11y)
**Accao Imediata Recomendada:**
> Optimizar INP removendo 350KB JS nao usado (-40% bundle size)
> ROI esperado: Posicao media +2 ranks, CTR +0.8pp
---
## 1. Pontuacoes Globais
### Desktop vs Mobile
| Metrica | Desktop | Mobile | Gap | Target 2026 |
|---------|---------|--------|-----|-------------|
| **Performance** | 85/100 | 62/100 | -23 | > 90 |
| **SEO** | 92/100 | 88/100 | -4 | > 95 |
| **Accessibility** | 78/100 | 78/100 | 0 | > 90 |
| **Best Practices** | 95/100 | 92/100 | -3 | > 95 |
**Analise Gap Mobile:** Dispositivos moveis representam 75% do trafego. Gap de -23 pontos e critico.
---
## 2. Core Web Vitals
### Comparacao Mobile vs Desktop
| Metrica | Mobile | Desktop | Threshold 2026 | Status |
|---------|--------|---------|----------------|--------|
| **LCP** | 2.8s | 1.9s | < 2.5s | -- |
| **INP** | 520ms | 180ms | < 200ms | -- |
| **CLS** | 0.08 | 0.05 | < 0.1 | -- |
### Oportunidades LCP
| Oportunidade | Savings | Prioridade |
|--------------|---------|------------|
| Preload imagem hero | 1.2s | Critico |
| Lazy load below-fold (15 imagens) | 800ms | Alto |
| Optimizar TTFB (servidor response) | 400ms | Alto |
| Comprimir imagens WebP (85% quality) | 600ms | Medio |
### Oportunidades INP
| Oportunidade | Savings | Prioridade |
|--------------|---------|------------|
| Remover JS nao usado (350KB) | 280ms | Critico |
| Code splitting (carregar on-demand) | 180ms | Alto |
| Defer third-party scripts | 120ms | Alto |
| Optimizar event listeners | 80ms | Medio |
---
## 3. GSC Analytics (Ultimos 90 dias)
### Performance Overview
| Metrica | Valor | vs 90 dias anteriores | Tendencia |
|---------|-------|------------------------|-----------|
| **Cliques** | 12,450 | +18% (+1,890) | Subida |
| **Impressoes** | 245,800 | +22% (+44,300) | Subida |
| **CTR Medio** | 5.1% | -0.3pp | Descida |
| **Posicao Media** | 12.8 | +2.1 (pior) | Descida |
### Top 10 Queries
| Query | Cliques | Impr. | CTR | Pos. | Oportunidade |
|-------|---------|-------|-----|------|--------------|
| [keyword 1] | 850 | 15,200 | 5.6% | 8.2 | Optimizar para top 5 |
| [keyword 2] | 720 | 9,800 | 7.3% | 4.5 | Manter |
| [keyword 3] | 680 | 22,400 | 3.0% | 14.8 | Melhorar CTR + posicao |
| ... | ... | ... | ... | ... | ... |
---
## 4. Analise On-Page
### Meta Tags Audit
| Pagina | Title | Description | Issues |
|--------|-------|-------------|--------|
| Homepage | OK 58 chars | Longo 175 chars | Description > 160 chars |
| /servicos | OK 52 chars | OK 155 chars | - |
| /blog/[slug] | Curto 28 chars | Duplicado (5 paginas) | Title curto, description duplicada |
### Imagens SEO
| Metrica | Valor | Target | Status |
|---------|-------|--------|--------|
| **Total Imagens** | 127 | - | - |
| **Com Alt Text** | 80 (63%) | 100% | Critico |
| **Alt Text Descritivo** | 52 (41%) | 100% | Critico |
| **Formato WebP** | 15 (12%) | > 80% | Critico |
| **Lazy Loading** | 45 (35%) | 100% (below-fold) | Medio |
### Internal Linking
| Metrica | Valor | Benchmark |
|---------|-------|-----------|
| **Links Internos Medios/Pagina** | 8.5 | > 10 bom |
| **Orphan Pages** | 3 | 0 ideal |
| **Broken Internal Links** | 7 | 0 |
| **Anchor Text Optimizado** | 42% | > 70% |
---
## 5. Backlinks e Autoridade
### Perfil de Dominio
| Metrica | Valor | Benchmark | Status |
|---------|-------|-----------|--------|
| **Domain Rating (DR)** | 32 | > 40 bom | -- |
| **URL Rating (UR) Medio** | 18 | > 25 bom | -- |
| **Backlinks Totais** | 1,247 | - | - |
| **Referring Domains** | 87 | > 100 bom | -- |
| **DoFollow** | 68% | > 60% | OK |
### Top 10 Backlinks (por DR)
| Dominio | DR | Anchor Text | DoFollow | Tipo |
|---------|-----|-------------|----------|------|
| [site DR alto] | 58 | [anchor] | Sim | Editorial |
| ... | ... | ... | ... | ... |
---
## 6. Benchmarks vs Concorrencia
| Metrica | [Site] | Concorrente A | Concorrente B | Gap |
|---------|--------|---------------|---------------|-----|
| DR | 32 | 45 | 38 | -13 |
| Traffic Estimado | 12.5K/mes | 28K/mes | 18K/mes | -15.5K |
| Ranking Keywords | 450 | 820 | 610 | -370 |
| Backlinks | 1,247 | 3,200 | 2,100 | -1,953 |
---
## 7. Plano de Accao (Priorizado)
### Critico (Semana 1-2)
| Accao | Impacto Estimado | Esforco | ROI |
|-------|------------------|---------|-----|
| **Optimizar INP Mobile** | Posicao media +2, CTR +0.8pp | 8h | Alto |
| **Adicionar alt text imagens** | Acessibilidade +15 pontos, SEO +5% | 3h | Alto |
| **Corrigir links internos quebrados** | UX, crawl efficiency +10% | 1h | Medio |
| **Reescrever meta descriptions** (CTR baixo) | CTR +1.2pp estimado | 2h | Alto |
### Importante (Semana 3-4)
| Accao | Impacto Estimado | Esforco | ROI |
|-------|------------------|---------|-----|
| **Optimizar keywords posicao 11-20** | +1,200 cliques/mes | 12h | Medio |
| **Implementar E-E-A-T** | Trust signals, rankings +5% | 6h | Medio |
| **Internal linking orphan pages** | Indexabilidade, link equity | 2h | Medio |
| **Converter imagens WebP** | LCP -600ms | 4h | Medio |
### Melhoria (Mes 2-3)
| Accao | Impacto Estimado | Esforco | ROI |
|-------|------------------|---------|-----|
| **Criar conteudo keywords gap** (3 artigos) | +2K visitas/mes | 20h | Medio |
| **Campanha backlinks DR > 40** (6 guest posts) | DR +5, autoridade | 30h | Baixo |
| **Optimizar structured data** | Rich snippets, CTR +0.5pp | 6h | Baixo |
---
## 8. Roadmap Trimestral
### Mes 1: Fundacao Tecnica
- Semana 1-2: Criticos (INP, alt text, links quebrados, meta descriptions)
- Semana 3-4: Importantes (keywords 11-20, E-E-A-T, orphan pages)
### Mes 2: Conteudo e Autoridade
- Criar artigos keywords gap
- Guest posts DR > 40
- Optimizar artigos existentes (posicao 11-30)
### Mes 3: Consolidacao e Escala
- Monitorizar rankings e ajustar on-page
- Guest posts adicionais
- Expandir internal linking (cluster content)
- Actualizar conteudo underperforming
---
## Anexos
### A. Metodologia
- Lighthouse: 3 runs, mediana reportada
- GSC: Ultimos 90 dias completos
- Thresholds: Google 2026 Standards
### B. Glossario
- **DR**: Domain Rating (Ahrefs)
- **INP**: Interaction to Next Paint (substitui FID em 2026)
- **E-E-A-T**: Experience, Expertise, Authoritativeness, Trust
- **CTR**: Click-Through Rate
---
**Proxima Auditoria Recomendada:** [Data + 3 meses]
**Contacto Suporte:** recursos@descomplicar.pt
```

565
marketing/skills/social-media/SKILL.md
View File

@@ -1,109 +1,65 @@
---
name: social-media
description: Social media content strategy and management. Plans posts, content calendar,
and engagement tactics. Use when user mentions "social media", "redes sociais",
"social content", "social media strategy", "content calendar".
author: Descomplicar® Crescimento Digital
version: 2.0.0
quality_score: 55
user_invocable: true
desk_task:
- TBD
allowed-tools: Edit
description: Estrategia e gestao de conteudo para redes sociais. Planeia publicacoes, calendario de conteudo e tacticas de engagement.
---
# /social-media
Gestão completa e estratégia de redes sociais com best practices 2026.
Gestao completa e estrategia de redes sociais com best practices 2026.
---
## 🎯 Triggers
- "Redes sociais", "social media"
- "Instagram", "Facebook", "LinkedIn", "TikTok"
- "Post", "stories", "reels", "engagement"
- "Calendário editorial", "content plan"
## Contexto NotebookLM
ANTES de executar, consultar notebook para contexto especializado:
| Notebook | ID | Consultar quando |
|----------|-----|-----------------|
| Social Media e Branding | `9053d0e8` | Sempre |
```
mcp__notebooklm__notebook_query({
notebook_id: "9053d0e8-dd39-460b-b5ea-e67af3e9a675",
query: "<adaptar ao contexto — ex: estrategia Instagram, LinkedIn B2B, TikTok crescimento>"
})
```
---
## 📱 Plataformas e Formatos 2026
## Quando Usar
### Instagram
| Formato | Dimensões | Duração | Uso | Alcance Médio |
|---------|-----------|---------|-----|---------------|
| **Feed** | 1080x1080 (1:1) ou 1080x1350 (4:5) | - | Conteúdo evergreen | 10-20% followers |
| **Stories** | 1080x1920 (9:16) | 15s/slide | Daily engagement, polls | 5-10% followers |
| **Reels** | 1080x1920 (9:16) | 15-90s | Crescimento, viral | 50-200% followers |
| **Carrossel** | 1080x1080 cada | Até 10 | Tutoriais, antes/depois | 15-25% followers |
| **IGTV/Vídeo** | 1080x1920 ou 1080x1080 | Até 60 min | Long-form conteúdo | 5-15% followers |
**Algoritmo 2026:**
- Reels têm 3-5x mais alcance que posts estáticos
- Primeiros 30 minutos críticos (engagement boost)
- Shares > Saves > Comments > Likes (ordem importância)
- Tempo visualização > número likes
### LinkedIn
| Formato | Dimensões | Extensão | Uso | Engagement B2B |
|---------|-----------|----------|-----|----------------|
| **Post Imagem** | 1200x627 ou 1080x1080 | - | Insights, dicas | 2-5% impressões |
| **Carrossel PDF** | 1080x1080 | Até 300 slides | Guias, infográficos | 3-8% impressões |
| **Vídeo** | 1920x1080 (16:9) | Até 10 min | Tutoriais, interviews | 5-10% impressões |
| **Article** | - | 1000-2000 palavras | Thought leadership | 1-3% impressões |
| **Poll** | - | 2-4 opções | Engagement rápido | 10-20% impressões |
**Algoritmo 2026:**
- Primeiros 60 minutos críticos (engage early)
- Comments com +10 palavras pesam 3x mais
- Posts nativos > links externos
- Dwell time (tempo leitura) factor chave
### Facebook
| Formato | Dimensões | Uso | Alcance Orgânico 2026 |
|---------|-----------|-----|----------------------|
| **Post** | 1200x630 | Updates, promos | 2-5% fans (muito baixo) |
| **Stories** | 1080x1920 | Daily content | 5-10% fans |
| **Reels** | 1080x1920 | Crescimento | 20-50% fans |
| **Cover** | 820x312 (desktop), 640x360 (mobile) | Branding | - |
| **Grupos** | - | Community building | 50-80% membros |
**Alcance Orgânico Morto 2026:**
- Posts normais: 2-5% fans (forçar ads)
- Reels: Único formato com alcance orgânico decente
- Grupos: Melhor alternativa para engagement
### TikTok
| Formato | Dimensões | Duração | Uso | Potencial Viral |
|---------|-----------|---------|-----|-----------------|
| **Vídeo** | 1080x1920 (9:16) | 15s a 10 min | Tudo | Muito Alto |
| **Duração Ideal** | - | 21-34s | Max retention | - |
| **Lives** | 1080x1920 | Até 60 min | Community | Alto engagement |
**Algoritmo TikTok 2026 (Mais Generoso):**
- TODOS os vídeos testados (não precisa seguidores)
- Completions > Likes (assistir até final)
- Re-watches contam 2x
- Primeiras 3 horas críticas
- Redes sociais, social media
- Instagram, Facebook, LinkedIn, TikTok
- Posts, stories, reels, engagement
- Calendario editorial, content plan
---
## 📅 Calendário Editorial 2026
## Plataformas - Resumo 2026
### Frequência Recomendada
| Plataforma | Formato Prioritario | Alcance Organico | Melhor Para |
|------------|---------------------|------------------|-------------|
| **Instagram** | Reels (3-5x alcance) | 50-200% (Reels) | B2C, visual, crescimento |
| **LinkedIn** | Posts nativos + PDF | 2-5% impressoes | B2B, authority, leads |
| **Facebook** | Reels + Grupos | 2-5% fans (baixo) | Community, ads |
| **TikTok** | Video 21-34s | Muito alto (todos) | Viralidade, jovens |
| Plataforma | Mínimo | Ideal | Formato Prioritário |
Detalhes completos de dimensoes, algoritmos e formatos em `references/plataformas-formatos.md`.
---
## Calendario Editorial 2026
### Frequencia Recomendada
| Plataforma | Minimo | Ideal | Formato Prioritario |
|------------|--------|-------|---------------------|
| **Instagram** | 3x/semana feed + 5x/semana stories | 5x/semana feed + diário stories | Reels (3x/semana) |
| **Instagram** | 3x/semana feed + 5x stories | 5x/semana feed + diario stories | Reels (3x/semana) |
| **LinkedIn** | 2x/semana | 4x/semana | Posts nativos + 1 carrossel/semana |
| **Facebook** | 2x/semana | 3x/semana | Reels + Grupos activos |
| **TikTok** | 3x/semana | Diário | Vídeos curtos (21-34s) |
| **Twitter/X** | 3x/dia | 5-10x/dia | Threads, opiniões |
| **TikTok** | 3x/semana | Diario | Videos curtos (21-34s) |
### Melhores Horários Portugal (2026 Data)
### Melhores Horarios Portugal (2026)
| Plataforma | B2C | B2B |
|------------|-----|-----|
@@ -112,430 +68,89 @@ Gestão completa e estratégia de redes sociais com best practices 2026.
| **Facebook** | 13h-14h, 16h-17h, 20h-21h | 9h-11h, 12h-14h |
| **TikTok** | 18h-22h (prime time) | 12h-14h, 18h-20h |
**Ferramentas Agendamento:**
- Buffer, Hootsuite, Later (multi-plataforma)
- Meta Business Suite (FB + IG)
- LinkedIn nativo
- TikTok Creative Center
---
## 🎨 Tipos de Conteúdo (Regra 70/20/10)
## Tipos de Conteudo (Regra 70/20/10)
```
70% VALOR (Educação, Entretenimento, Inspiração)
├─ 40% Educativo: How-to, tips, insights, dados
├─ 25% Entretenimento: Memes, trends, behind scenes
└─ 5% Inspiracional: Quotes, success stories
70% VALOR (Educacao, Entretenimento, Inspiracao)
-- 40% Educativo: How-to, tips, insights, dados
-- 25% Entretenimento: Memes, trends, behind scenes
-- 5% Inspiracional: Quotes, success stories
20% ENGAGEMENT (Conversação)
├─ Perguntas abertas
├─ Polls, quizzes
├─ User-generated content
└─ Responder comentários (conteúdo)
20% ENGAGEMENT (Conversacao)
-- Perguntas abertas, polls, quizzes
-- User-generated content
-- Responder comentarios (conteudo)
10% PROMOCIONAL (Vendas)
├─ Produtos/serviços
├─ Ofertas especiais
├─ CTAs directos
└─ Testemunhos clientes
-- Produtos/servicos, ofertas especiais
-- CTAs directos, testemunhos clientes
```
### Content Pillars (3-5 por marca)
**Exemplo Agência Marketing:**
1. **Dicas Práticas** (40%) - "Como crescer no Instagram"
Exemplo agencia marketing:
1. **Dicas Praticas** (40%) - "Como crescer no Instagram"
2. **Behind the Scenes** (25%) - Bastidores projectos
3. **Casos de Sucesso** (20%) - Resultados clientes
4. **Tendências** (10%) - Novidades marketing
5. **Ofertas** (5%) - Serviços e promoções
4. **Tendencias** (10%) - Novidades marketing
5. **Ofertas** (5%) - Servicos e promocoes
---
## 🚀 Estratégia Crescimento 2026
### Instagram (Reels-First Strategy)
```markdown
**Fase 1: 0-1K Followers (2-3 meses)**
Conteúdo:
- 5 Reels/semana (foco crescimento)
- 2 Posts carousel/semana (valor, save-worthy)
- Stories diário (engagement, polls, perguntas)
Optimização:
- Hook primeiros 1-2 segundos
- Legendas longas (SEO Instagram)
- 15-20 hashtags mix (grandes, médias, nicho)
- Geolocalização Portugal
- Trending audio (usar biblioteca Instagram)
Engagement:
- Comentar 20-30 posts nicho/dia (genuíno)
- Responder 100% comentários primeiros 60 min
- DM colaborações (contas 500-5K followers)
KPIs:
- Alcance > 2x followers
- Saves > 5% alcance
- Shares > 3% alcance
- 50-100 novos followers/semana
---
**Fase 2: 1K-10K Followers (3-6 meses)**
Conteúdo:
- Replicar top 10 Reels (formato + topic)
- Criar série/formato signature
- Collaborations com contas similares (5-20K)
Monetização Início:
- Afiliados (Amazon, nicho específico)
- Digital products (ebooks, templates)
- 1-1 services
KPIs:
- Alcance > 5x followers
- Engagement rate > 8%
- 200-500 novos followers/semana
```
### LinkedIn (Authority Building)
```markdown
**Conteúdo Alto Valor:**
1. **Personal Insights** (3x/semana)
- Experiência real, lições aprendidas
- Contrarian opinions (educadas)
- Dados/estudos com interpretação
2. **Carrosséis PDF** (1x/semana)
- Guias, frameworks, checklists
- 5-10 slides, design clean
- Download gratuito (lead magnet)
3. **Engagement Posts** (1x/semana)
- Perguntas abertas audiência
- Polls sobre tendências indústria
- Pedir opiniões/experiências
**Optimização:**
- Primeira linha hook (cabe em preview)
- Espaçamento parágrafos (legibilidade)
- Emojis estratégicos (não excessivo B2B)
- Tag pessoas relevantes (não spam)
**Network Growth:**
- Conectar 10-20 pessoas/dia (nicho)
- Comentar insights posts influencers
- Partilhar conteúdo outros (com opinião)
KPIs:
- Impressions > 10x connections
- Engagement rate > 5%
- 50-100 novos connections/semana
- 1-2 inbound leads/semana (>10K connections)
```
### TikTok (Viralidade)
```markdown
**Formato Winning:**
1. **Hook Primeiro Segundo**
- Visual surpreendente
- Texto "Não vais acreditar..."
- Jump cut imediato
2. **Duração 21-34s**
- Sweet spot retention
- Rewatch provável
3. **Trending Sounds**
- Usar áudio viral (biblioteca TikTok)
- Adicionar twist original
4. **Legendas Completas**
- 80% views sem som
- Texto on-screen legível
**Estratégia Posting:**
- 1-3x/dia (algoritmo favorece)
- Testar formatos diferentes
- Acompanhar TikTok Creative Center (trends)
**Cross-Promote:**
- Reutilizar TikToks como Reels Instagram
- Editar para cada plataforma (remover watermark)
KPIs TikTok:
- Completion rate > 80%
- Rewatches > 20%
- 1-3% viewers → followers
```
---
## 📊 Hashtag Strategy 2026
## Metricas Chave por Plataforma
### Instagram
```markdown
**Estrutura 15-20 Hashtags:**
🔴 Grandes (1M+ posts): 2-3
Alcance: Baixo, competição alta
Ex: #marketing, #business, #entrepreneur
🟡 Médias (100K-1M posts): 5-7
Alcance: Médio, sweet spot
Ex: #marketingdigitalportugal, #empreendeportugal
🟢 Nicho (10K-100K posts): 5-7
Alcance: Alto, target específico
Ex: #instagrammarketingpt, #pmeportugal
🔵 Branded (< 10K posts): 2-3
Alcance: Baixo, branding
Ex: #descomplicarpt, #seuhashtag
**Placement:**
- Primeiro comentário (não caption)
- Ou quebra linha caption (aesthetic)
**Rodar Sets:**
- Criar 5-7 sets diferentes
- Rodar para evitar shadowban
```
### LinkedIn
```
🎯 3-5 Hashtags MAX
Escolher:
- 1 broad (#marketing)
- 2 específicas (#b2bmarketing, #leadgeneration)
- 1-2 trending (ver LinkedIn trending)
Placement: Final do post
```
---
## 💬 Engagement Hacks 2026
### Comentários que Convertem
```markdown
**Fórmulas:**
1. **Pergunta Aberta** (fim caption)
"Qual destas estratégias já testaste? Conta nos comentários 👇"
2. **Tag Amigo** (Instagram/Facebook)
"Tag alguém que precisa ver isto 👥"
3. **Opinião Controversial**
"80% das empresas fazem isto errado. Concordas?"
4. **Prompt Específico**
"Comenta VAMOS se queres receber o template gratuito"
```
### Responder Comentários (Aumenta Alcance)
```
🚀 SEMPRE responder primeiros 60 minutos
Técnica:
- Resposta com pergunta (continua conversa)
- Não só "Obrigado" (engagement count)
- Tag autor se relevant
Exemplo:
User: "Adorei este post!"
Tu: "@user obrigado! Qual das dicas vais testar primeiro?"
```
### Stories Engagement (Instagram)
```markdown
**Ferramentas Interactivas:**
🗳️ Polls: "Qual preferes? A ou B?"
📊 Quiz: "Sabias que...? Verdadeiro ou Falso"
❓ Perguntas: "Qual a tua maior dúvida em X?"
👆 Slider: "De 0 a 100, quanto concordas?"
🔗 Link: "Swipe up" (>10K followers) ou adesivo link
**Frequência:** 5-10 stories/dia (mantém top-of-mind)
```
---
## 📈 Métricas Chave por Plataforma
### Instagram
| Métrica | Fórmula | Benchmark | Acção |
|---------|---------|-----------|-------|
| **Reach** | Contas únicas | > 2x followers | Aumentar Reels |
| **Engagement Rate** | (Likes+Comments+Saves+Shares)/Alcance | > 5% | Melhorar conteúdo |
| **Saves** | - | > 5% alcance | Conteúdo save-worthy |
| **Shares** | - | > 3% alcance | Conteúdo shareable |
| **Profile Visits** | - | > 2% alcance | Bio optimizada |
| **Followers Growth** | - | +5-10%/mês | Consistência |
### LinkedIn
| Métrica | Benchmark | Acção |
| Metrica | Benchmark | Accao |
|---------|-----------|-------|
| **Impressions** | > 10x connections | Postar horários óptimos |
| **Engagement Rate** | > 3% impressões | Conteúdo provocativo/valioso |
| **Comments** | > 1% impressões | Perguntas abertas |
| **Shares** | > 0.5% impressões | Conteúdo shareable |
| **Profile Views** | +10-20%/mês | Actividade consistente |
| **Reach** | > 2x followers | Aumentar Reels |
| **Engagement Rate** | > 5% | Melhorar conteudo |
| **Saves** | > 5% alcance | Conteudo save-worthy |
| **Shares** | > 3% alcance | Conteudo shareable |
| **Followers Growth** | +5-10%/mes | Consistencia |
### Ferramentas Analytics
### LinkedIn
- **Meta Business Suite**: Instagram + Facebook
- **LinkedIn Analytics**: Nativo
- **TikTok Analytics**: Nativo (contas Business)
- **Later, Buffer**: Multi-plataforma analytics
- **Iconosquare**: Instagram/Facebook avançado
| Metrica | Benchmark | Accao |
|---------|-----------|-------|
| **Impressions** | > 10x connections | Postar horarios optimos |
| **Engagement Rate** | > 3% impressoes | Conteudo provocativo/valioso |
| **Comments** | > 1% impressoes | Perguntas abertas |
| **Profile Views** | +10-20%/mes | Actividade consistente |
---
## 🛠️ Ferramentas Recomendadas 2026
## Ferramentas Recomendadas 2026
### Design
- **Canva Pro**: Templates, agendamento
- **Adobe Express**: Templates, vídeo
- **CapCut**: Edição vídeo mobile (TikTok/Reels)
- **InShot**: Edição rápida mobile
### Agendamento
- **Buffer**: Multi-plataforma, analytics
- **Hootsuite**: Enterprise, team collaboration
- **Later**: Visual planner Instagram
- **Meta Business Suite**: FB + IG gratuito
### Hashtags
- **Display Purposes**: Gerar hashtags relevantes
- **All Hashtag**: Gerador + analytics
- **Hashtagify**: Trending hashtags
### Analytics
- **Iconosquare**: Instagram/Facebook profundo
- **Sprout Social**: Enterprise analytics
- **Phlanx**: Engagement calculator
| Categoria | Ferramentas |
|-----------|-------------|
| **Design** | Canva Pro, Adobe Express, CapCut, InShot |
| **Agendamento** | Buffer, Hootsuite, Later, Meta Business Suite |
| **Hashtags** | Display Purposes, All Hashtag, Hashtagify |
| **Analytics** | Iconosquare, Sprout Social, Phlanx |
---
## 📚 Datasets Dify (Consultar SEMPRE)
## References (conteudo detalhado)
| Dataset | ID | Prioridade | Uso |
|---------|----|-----------:|-----|
| **Marketing Redes Sociais** | `66117552-348f-455d-9aca-2da722567693` | 1 | Estratégias, engagement |
| **Marketing Digital** | `c1ec779f-4cb1-4ecf-ba11-6b39b93d4e24` | 2 | Estratégia geral |
| **Youtube Marketing** | `baa1b3e6-ebf0-4413-84b2-63d1164867ea` | 3 | Vídeo (Reels, TikTok) |
### Como Consultar
```javascript
// Estratégias crescimento Instagram
mcp__notebooklm__notebook_query, mcp__dify-kb__dify_kb_retrieve_segments({
dataset_id: "66117552-348f-455d-9aca-2da722567693",
query: "instagram reels crescimento algoritmo 2026"
})
// LinkedIn B2B estratégia
mcp__dify-kb__dify_kb_retrieve_segments({
dataset_id: "66117552-348f-455d-9aca-2da722567693",
query: "linkedin b2b engagement authority building"
})
// TikTok viralidade
mcp__dify-kb__dify_kb_retrieve_segments({
dataset_id: "baa1b3e6-ebf0-4413-84b2-63d1164867ea",
query: "tiktok viral algorithm hook retention"
})
```
| Ficheiro | Conteudo |
|----------|----------|
| `references/plataformas-formatos.md` | Dimensoes, algoritmos e formatos detalhados por plataforma |
| `references/estrategias-crescimento.md` | Estrategias Instagram/LinkedIn/TikTok, hashtags, engagement hacks |
---
## 🎯 Agente Complementar
- `social-media-manager` (agente especializado)
## Anti-Patterns
- Mesmo conteudo em todas as plataformas (sem adaptar formato)
- Postar sem consistencia (sporadic vs regular)
- Ignorar engagement nos primeiros 60 minutos
- Excesso de conteudo promocional (> 10%)
- Nao adaptar horarios ao publico-alvo
- Usar hashtags sem estrategia (ou excessivas no LinkedIn)
---
**Versão:** 2.0.0 | **Autor:** Descomplicar® | **Data:** 2026-02-03
**Standards:** Algoritmos 2026, Reels-First, Engagement Autêntico
---
## 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 aprovação manual obrigatória
- Quando os requisitos não estão claramente definidos
## Protocolo de Execução
1. **Análise Inicial**
- Verificar requisitos e contexto
- Identificar ferramentas necessárias
2. **Preparação**
- Validar acesso a recursos
- Preparar ambiente de trabalho
3. **Execução**
- Executar operações de forma incremental
- Validar cada passo antes de prosseguir
4. **Validação**
- Verificar resultados obtidos
- Confirmar sucesso da operação
5. **Conclusão**
- Documentar alterações realizadas
- Reportar status final e próximos passos
## Exemplos de Uso
### Exemplo 1: Caso Básico
```
User: [requisição simples relacionada com social-media]
Skill: [execução directa com validação]
Output: [resultado conciso e accionável]
```
### Exemplo 2: Caso Complexo
```
User: [requisição multi-passo ou complexa]
Skill:
1. Análise dos requisitos
2. Planeamento da abordagem
3. Execução faseada
4. Validação contínua
Output: [resultado detalhado com próximos passos]
```
### Exemplo 3: Caso com Dependências
```
User: [requisição que depende de outros sistemas]
Skill:
1. Verificar dependências disponíveis
2. Coordenar com skills/MCPs necessários
3. Executar workflow integrado
Output: [resultado completo com referências]
```
**Versao:** 2.1.0 | **Autor:** Descomplicar

180
marketing/skills/social-media/references/estrategias-crescimento.md Normal file
View File

@@ -0,0 +1,180 @@
# Estrategias de Crescimento por Plataforma
## Instagram (Reels-First Strategy)
### Fase 1: 0-1K Followers (2-3 meses)
**Conteudo:**
- 5 Reels/semana (foco crescimento)
- 2 Posts carousel/semana (valor, save-worthy)
- Stories diario (engagement, polls, perguntas)
**Optimizacao:**
- Hook primeiros 1-2 segundos
- Legendas longas (SEO Instagram)
- 15-20 hashtags mix (grandes, medias, nicho)
- Geolocalizacao Portugal
- Trending audio (usar biblioteca Instagram)
**Engagement:**
- Comentar 20-30 posts nicho/dia (genuino)
- Responder 100% comentarios primeiros 60 min
- DM colaboracoes (contas 500-5K followers)
**KPIs:**
- Alcance > 2x followers
- Saves > 5% alcance
- Shares > 3% alcance
- 50-100 novos followers/semana
### Fase 2: 1K-10K Followers (3-6 meses)
**Conteudo:**
- Replicar top 10 Reels (formato + topic)
- Criar serie/formato signature
- Collaborations com contas similares (5-20K)
**Monetizacao Inicio:**
- Afiliados (Amazon, nicho especifico)
- Digital products (ebooks, templates)
- 1-1 services
**KPIs:**
- Alcance > 5x followers
- Engagement rate > 8%
- 200-500 novos followers/semana
---
## LinkedIn (Authority Building)
**Conteudo Alto Valor:**
1. **Personal Insights** (3x/semana)
- Experiencia real, licoes aprendidas
- Contrarian opinions (educadas)
- Dados/estudos com interpretacao
2. **Carrosseis PDF** (1x/semana)
- Guias, frameworks, checklists
- 5-10 slides, design clean
- Download gratuito (lead magnet)
3. **Engagement Posts** (1x/semana)
- Perguntas abertas audiencia
- Polls sobre tendencias industria
- Pedir opinioes/experiencias
**Optimizacao:**
- Primeira linha hook (cabe em preview)
- Espacamento paragrafos (legibilidade)
- Emojis estrategicos (nao excessivo B2B)
- Tag pessoas relevantes (nao spam)
**Network Growth:**
- Conectar 10-20 pessoas/dia (nicho)
- Comentar insights posts influencers
- Partilhar conteudo outros (com opiniao)
**KPIs:**
- Impressions > 10x connections
- Engagement rate > 5%
- 50-100 novos connections/semana
- 1-2 inbound leads/semana (>10K connections)
---
## TikTok (Viralidade)
**Formato Winning:**
1. **Hook Primeiro Segundo**
- Visual surpreendente
- Texto "Nao vais acreditar..."
- Jump cut imediato
2. **Duracao 21-34s**
- Sweet spot retention
- Rewatch provavel
3. **Trending Sounds**
- Usar audio viral (biblioteca TikTok)
- Adicionar twist original
4. **Legendas Completas**
- 80% views sem som
- Texto on-screen legivel
**Estrategia Posting:**
- 1-3x/dia (algoritmo favorece)
- Testar formatos diferentes
- Acompanhar TikTok Creative Center (trends)
**Cross-Promote:**
- Reutilizar TikToks como Reels Instagram
- Editar para cada plataforma (remover watermark)
**KPIs TikTok:**
- Completion rate > 80%
- Rewatches > 20%
- 1-3% viewers -> followers
---
## Hashtag Strategy 2026
### Instagram (15-20 Hashtags)
**Estrutura:**
- **Grandes (1M+ posts):** 2-3 -- alcance baixo, competicao alta
- **Medias (100K-1M posts):** 5-7 -- sweet spot
- **Nicho (10K-100K posts):** 5-7 -- alcance alto, target especifico
- **Branded (< 10K posts):** 2-3 -- branding
**Placement:** Primeiro comentario (nao caption) ou quebra linha caption.
**Rodar sets:** Criar 5-7 sets diferentes para evitar shadowban.
### LinkedIn (3-5 Hashtags MAX)
- 1 broad (#marketing)
- 2 especificas (#b2bmarketing, #leadgeneration)
- 1-2 trending (ver LinkedIn trending)
- Placement: Final do post
---
## Engagement Hacks 2026
### Formulas Comentarios que Convertem
1. **Pergunta Aberta** (fim caption)
"Qual destas estrategias ja testaste? Conta nos comentarios"
2. **Tag Amigo** (Instagram/Facebook)
"Tag alguem que precisa ver isto"
3. **Opiniao Controversial**
"80% das empresas fazem isto errado. Concordas?"
4. **Prompt Especifico**
"Comenta VAMOS se queres receber o template gratuito"
### Responder Comentarios (Aumenta Alcance)
SEMPRE responder primeiros 60 minutos.
**Tecnica:**
- Resposta com pergunta (continua conversa)
- Nao so "Obrigado" (engagement count)
- Tag autor se relevante
### Stories Engagement (Instagram)
**Ferramentas Interactivas:**
- Polls: "Qual preferes? A ou B?"
- Quiz: "Sabias que...? Verdadeiro ou Falso"
- Perguntas: "Qual a tua maior duvida em X?"
- Slider: "De 0 a 100, quanto concordas?"
- Link: Adesivo link
**Frequencia:** 5-10 stories/dia (mantem top-of-mind)

62
marketing/skills/social-media/references/plataformas-formatos.md Normal file
View File

@@ -0,0 +1,62 @@
# Plataformas e Formatos 2026
## Instagram
| Formato | Dimensoes | Duracao | Uso | Alcance Medio |
|---------|-----------|---------|-----|---------------|
| **Feed** | 1080x1080 (1:1) ou 1080x1350 (4:5) | - | Conteudo evergreen | 10-20% followers |
| **Stories** | 1080x1920 (9:16) | 15s/slide | Daily engagement, polls | 5-10% followers |
| **Reels** | 1080x1920 (9:16) | 15-90s | Crescimento, viral | 50-200% followers |
| **Carrossel** | 1080x1080 cada | Ate 10 | Tutoriais, antes/depois | 15-25% followers |
| **IGTV/Video** | 1080x1920 ou 1080x1080 | Ate 60 min | Long-form conteudo | 5-15% followers |
**Algoritmo 2026:**
- Reels tem 3-5x mais alcance que posts estaticos
- Primeiros 30 minutos criticos (engagement boost)
- Shares > Saves > Comments > Likes (ordem importancia)
- Tempo visualizacao > numero likes
## LinkedIn
| Formato | Dimensoes | Extensao | Uso | Engagement B2B |
|---------|-----------|----------|-----|----------------|
| **Post Imagem** | 1200x627 ou 1080x1080 | - | Insights, dicas | 2-5% impressoes |
| **Carrossel PDF** | 1080x1080 | Ate 300 slides | Guias, infograficos | 3-8% impressoes |
| **Video** | 1920x1080 (16:9) | Ate 10 min | Tutoriais, interviews | 5-10% impressoes |
| **Article** | - | 1000-2000 palavras | Thought leadership | 1-3% impressoes |
| **Poll** | - | 2-4 opcoes | Engagement rapido | 10-20% impressoes |
**Algoritmo 2026:**
- Primeiros 60 minutos criticos (engage early)
- Comments com +10 palavras pesam 3x mais
- Posts nativos > links externos
- Dwell time (tempo leitura) factor chave
## Facebook
| Formato | Dimensoes | Uso | Alcance Organico 2026 |
|---------|-----------|-----|----------------------|
| **Post** | 1200x630 | Updates, promos | 2-5% fans (muito baixo) |
| **Stories** | 1080x1920 | Daily content | 5-10% fans |
| **Reels** | 1080x1920 | Crescimento | 20-50% fans |
| **Cover** | 820x312 (desktop), 640x360 (mobile) | Branding | - |
| **Grupos** | - | Community building | 50-80% membros |
**Alcance Organico 2026:**
- Posts normais: 2-5% fans (forcar ads)
- Reels: Unico formato com alcance organico decente
- Grupos: Melhor alternativa para engagement
## TikTok
| Formato | Dimensoes | Duracao | Uso | Potencial Viral |
|---------|-----------|---------|-----|-----------------|
| **Video** | 1080x1920 (9:16) | 15s a 10 min | Tudo | Muito Alto |
| **Duracao Ideal** | - | 21-34s | Max retention | - |
| **Lives** | 1080x1920 | Ate 60 min | Community | Alto engagement |
**Algoritmo TikTok 2026:**
- TODOS os videos testados (nao precisa seguidores)
- Completions > Likes (assistir ate final)
- Re-watches contam 2x
- Primeiras 3 horas criticas

711
marketing/skills/video/SKILL.md
View File

@@ -1,31 +1,46 @@
---
name: video
description: Video content strategy and production guidance. Plans video content,
scripts, and production workflows. Use when user mentions "video content", "conteúdo
vídeo", "youtube strategy", "video production", "video script".
author: Descomplicar® Crescimento Digital
version: 2.0.0
quality_score: 75
user_invocable: true
desk_task: 1486
allowed-tools: Edit
description: Criacao de videos profissionais com Remotion (React). Planeia conteudo, scripts e workflows de producao.
---
# /video - Criação de Vídeos com Remotion
# /video - Criacao de Videos com Remotion
Cria vídeos profissionais usando **Remotion** (React) a partir de descrições em linguagem natural.
Cria videos profissionais usando **Remotion** (React) a partir de descricoes em linguagem natural.
## Contexto NotebookLM
ANTES de executar, consultar notebooks para contexto especializado:
| Notebook | ID | Consultar quando |
|----------|-----|-----------------|
| Producao de Video e YouTube | `058a896e` | Para planeamento de video |
| Remotion Deep Research | `f2b75baa` | Para implementacao tecnica Remotion |
```
mcp__notebooklm__notebook_query({
notebook_id: "058a896e-6c9a-4e51-ae7d-9adb2738bc5f",
query: "<adaptar ao contexto>"
})
mcp__notebooklm__notebook_query({
notebook_id: "f2b75baa-1ab1-48d3-8f7c-a6a9e516934c",
query: "<adaptar ao contexto>"
})
```
---
## Arquitectura
```
Prompt Natural → Claude Code → Código React/Remotion → Vídeo MP4/GIF/WebM
Prompt Natural -> Claude Code -> Codigo React/Remotion -> Video MP4/GIF/WebM
```
| Componente | Função |
| Componente | Funcao |
|------------|--------|
| **Remotion** | Framework React para vídeos programáticos |
| **Esta Skill** | Ensina Claude a gerar código Remotion correcto |
| **Output** | MP4, GIF, WebM em qualquer resolução |
| **Remotion** | Framework React para videos programaticos |
| **Esta Skill** | Ensina Claude a gerar codigo Remotion correcto |
| **Output** | MP4, GIF, WebM em qualquer resolucao |
---
@@ -35,24 +50,18 @@ Prompt Natural → Claude Code → Código React/Remotion → Vídeo MP4/GIF/Web
/media/ealmeida/Dados/Dev/remotion-demo/
```
Este projecto já está configurado com:
- Remotion 4.x instalado
- Agent Skills do Remotion
- Composição de exemplo funcional
- Scripts de renderização
Ja configurado com Remotion 4.x, Agent Skills, composicao de exemplo e scripts de renderizacao.
---
## Uso Rápido
### Criar Novo Vídeo
## Uso Rapido
```bash
# 1. Navegar ao projecto
cd /media/ealmeida/Dados/Dev/remotion-demo
# 2. Descrever o vídeo pretendido ao Claude
"Cria um vídeo de 10 segundos para [empresa] com logo animado e tagline"
# 2. Descrever o video pretendido ao Claude
"Cria um video de 10 segundos para [empresa] com logo animado e tagline"
# 3. Renderizar
npm run render
@@ -60,9 +69,9 @@ npm run render
npx remotion render [CompositionName] out/video.mp4
```
### Comandos Disponíveis
### Comandos Disponiveis
| Comando | Descrição |
| Comando | Descricao |
|---------|-----------|
| `npm run dev` | Abrir Remotion Studio (preview) |
| `npm run render` | Renderizar DemoVideo para MP4 |
@@ -73,16 +82,15 @@ npx remotion render [CompositionName] out/video.mp4
## Estrutura de Prompt Recomendada
```
Cria um vídeo de [duração] segundos para [empresa/propósito] com:
- Resolução: [1920x1080 / 1080x1920 / 1080x1080]
Cria um video de [duracao] segundos para [empresa/proposito] com:
- Resolucao: [1920x1080 / 1080x1920 / 1080x1080]
- FPS: [30 / 60]
- Fundo: [cor sólida / gradiente / imagem]
- Sequência de animação:
1. [Elemento] [animação] (frames X-Y)
2. [Elemento] [animação] (frames X-Y)
3. ...
- Texto: [título, subtítulo, CTA]
- Estilo: [minimalista / corporativo / energético / elegante]
- Fundo: [cor solida / gradiente / imagem]
- Sequencia de animacao:
1. [Elemento] [animacao] (frames X-Y)
2. [Elemento] [animacao] (frames X-Y)
- Texto: [titulo, subtitulo, CTA]
- Estilo: [minimalista / corporativo / energetico / elegante]
```
---
@@ -90,11 +98,12 @@ Cria um vídeo de [duração] segundos para [empresa/propósito] com:
## Exemplos de Prompts
### Intro Corporativa
```
Cria um vídeo intro de 5 segundos para "Descomplicar" com:
- Resolução: 1920x1080, 30fps
Cria um video intro de 5 segundos para "Descomplicar" com:
- Resolucao: 1920x1080, 30fps
- Fundo: gradiente de #1e3a8a para #7c3aed
- Animação:
- Animacao:
1. Logo fade in com bounce (0-45 frames)
2. Tagline "Crescimento Digital" slide up (45-90 frames)
3. Linha decorativa expande (60-120 frames)
@@ -102,27 +111,16 @@ Cria um vídeo intro de 5 segundos para "Descomplicar" com:
```
### Reel/Short Vertical
```
Cria um vídeo vertical de 15 segundos para Instagram Reels com:
- Resolução: 1080x1920, 30fps
Cria um video vertical de 15 segundos para Instagram Reels com:
- Resolucao: 1080x1920, 30fps
- Tema: "5 Dicas de SEO"
- Sequência:
1. Título impactante com zoom (0-30 frames)
- Sequencia:
1. Titulo impactante com zoom (0-30 frames)
2. Dica 1 slide in (30-90 frames)
3. Dica 2 slide in (90-150 frames)
...
- CTA final: "Segue para mais!"
- Cores: marca Descomplicar
```
### Promo Produto
```
Cria um vídeo promocional de 20 segundos com:
- Resolução: 1920x1080, 30fps
- Produto: [Nome]
- Features a destacar: [lista]
- CTA: "Experimenta grátis"
- Incluir: preço com animação de destaque
```
---
@@ -130,27 +128,30 @@ Cria um vídeo promocional de 20 segundos com:
## Conceitos Remotion Essenciais
### Timing
- **Frames**: Unidade base (30fps = 30 frames/segundo)
- **useCurrentFrame()**: Frame actual da animação
- **useCurrentFrame()**: Frame actual da animacao
- **interpolate()**: Mapear frames para valores (opacity, position, scale)
- **spring()**: Animações com física (bounce, elastic)
- **spring()**: Animacoes com fisica (bounce, elastic)
### Componentes Core
```tsx
import {
AbsoluteFill, // Container full-screen
Sequence, // Sequenciar elementos no tempo
useCurrentFrame, // Frame actual
useVideoConfig, // fps, width, height, duration
interpolate, // Interpolação linear
spring, // Animação spring
interpolate, // Interpolacao linear
spring, // Animacao spring
Img, // Imagens
Audio, // Áudio
Video, // Vídeo embebido
Audio, // Audio
Video, // Video embebido
} from "remotion";
```
### Estrutura de Composição
### Estrutura de Composicao
```tsx
// src/Root.tsx
<Composition
@@ -166,36 +167,27 @@ import {
---
## Opções de Renderização
## Opcoes de Renderizacao
### Qualidade
```bash
# Alta qualidade (lento)
npx remotion render Video out.mp4 --crf=18
# Qualidade média (rápido)
npx remotion render Video out.mp4 --crf=23
# Baixa qualidade (muito rápido)
npx remotion render Video out.mp4 --crf=28
npx remotion render Video out.mp4 --crf=18 # Alta qualidade (lento)
npx remotion render Video out.mp4 --crf=23 # Qualidade media (rapido)
npx remotion render Video out.mp4 --crf=28 # Baixa qualidade (muito rapido)
```
### Formatos
```bash
# MP4 (H.264)
npx remotion render Video out.mp4
# GIF
npx remotion render Video out.gif --codec=gif
# WebM (VP8)
npx remotion render Video out.webm --codec=vp8
# ProRes (alta qualidade, ficheiro grande)
npx remotion render Video out.mov --codec=prores
npx remotion render Video out.mp4 # MP4 (H.264)
npx remotion render Video out.gif --codec=gif # GIF
npx remotion render Video out.webm --codec=vp8 # WebM
npx remotion render Video out.mov --codec=prores # ProRes
```
### Props Dinâmicas
### Props Dinamicas
```bash
npx remotion render Video out.mp4 \
--props='{"titulo":"Descomplicar","cor":"#1e3a8a"}'
@@ -203,9 +195,9 @@ npx remotion render Video out.mp4 \
---
## Resoluções Comuns
## Resolucoes Comuns
| Formato | Resolução | Uso |
| Formato | Resolucao | Uso |
|---------|-----------|-----|
| 16:9 HD | 1920x1080 | YouTube, Website |
| 16:9 4K | 3840x2160 | YouTube 4K |
@@ -215,72 +207,12 @@ npx remotion render Video out.mp4 \
---
## Boas Práticas
### Performance
- Usar `React.memo()` para componentes pesados
- Evitar re-renders desnecessários
- Pré-carregar assets com `staticFile()`
### Animações
- Começar com `interpolate()` para animações simples
- Usar `spring()` para movimentos naturais
- Combinar `Sequence` para organizar timeline
### Assets
- Colocar imagens/áudio em `public/`
- Usar `staticFile("nome.png")` para referenciar
- Formatos recomendados: PNG (imagens), MP3/WAV (áudio)
---
## Troubleshooting
| Problema | Solução |
|----------|---------|
| Vídeo preto | Verificar `AbsoluteFill` tem background |
| Fontes não carregam | Usar `@remotion/google-fonts` |
| Animação não funciona | Verificar range de frames no `interpolate` |
| Erro de módulo | `rm -rf node_modules && npm install` |
| Render lento | Reduzir `--concurrency` ou usar `--crf` maior |
---
## Regras Detalhadas
Para instruções específicas, consultar:
- [rules/animations.md](rules/animations.md) - Animações fundamentais
- [rules/timing.md](rules/timing.md) - Interpolação e easing
- [rules/transitions.md](rules/transitions.md) - Transições entre cenas
- [rules/sequencing.md](rules/sequencing.md) - Organização temporal
- [rules/fonts.md](rules/fonts.md) - Carregamento de fontes
- [rules/images.md](rules/images.md) - Trabalhar com imagens
- [rules/audio.md](rules/audio.md) - Áudio e som
- [rules/tailwind.md](rules/tailwind.md) - TailwindCSS no Remotion
---
## Workflow Completo
```
1. DEFINIR → Duração, resolução, estilo
2. DESCREVER → Prompt detalhado ao Claude
3. GERAR → Claude cria componentes React
4. PREVIEW → npm run dev (Remotion Studio)
5. AJUSTAR → Refinar animações/timing
6. RENDER → npx remotion render
7. EXPORTAR → MP4/GIF/WebM conforme necessidade
```
---
## Casos de Uso
| Tipo | Duração | Resolução |
| Tipo | Duracao | Resolucao |
|------|---------|-----------|
| Logo Intro | 3-5s | 1920x1080 |
| Promo Rápida | 15-30s | 1080x1920 |
| Promo Rapida | 15-30s | 1080x1920 |
| Explainer | 60-120s | 1920x1080 |
| Social Post | 5-15s | 1080x1080 |
| YouTube Intro | 5-10s | 1920x1080 |
@@ -288,462 +220,77 @@ Para instruções específicas, consultar:
---
---
## Boas Praticas
## Datasets Dify (Consulta Obrigatória)
### Performance
Em caso de dúvidas ou para aprofundar conhecimento, consultar os seguintes datasets via MCP:
- Usar `React.memo()` para componentes pesados
- Evitar re-renders desnecessarios
- Pre-carregar assets com `staticFile()`
| Dataset | ID | Prioridade |
|---------|----|-----------:|
| **Canva** | `7efc5db4-05b1-408a-9e41-b612188ee877` | 2 |
| **Criatividade** | `39818f77-8c70-4729-9b5c-6f92d3a2b418` | 2 |
| **Youtube Marketing** | `baa1b3e6-ebf0-4413-84b2-63d1164867ea` | 2 |
| **Marketing Redes Sociais** | `66117552-348f-455d-9aca-2da722567693` | 3 |
### Animacoes
### Como Consultar
- Comecar com `interpolate()` para animacoes simples
- Usar `spring()` para movimentos naturais
- Combinar `Sequence` para organizar timeline
```javascript
// Princípios de design para vídeo
mcp__notebooklm__notebook_query, mcp__dify-kb__dify_kb_retrieve_segments({
dataset_id: "7efc5db4-05b1-408a-9e41-b612188ee877",
query: "animacao motion design"
})
### Assets
// Técnicas criativas
mcp__dify-kb__dify_kb_retrieve_segments({
dataset_id: "39818f77-8c70-4729-9b5c-6f92d3a2b418",
query: "storytelling visual criativo"
})
// Optimização para YouTube
mcp__dify-kb__dify_kb_retrieve_segments({
dataset_id: "baa1b3e6-ebf0-4413-84b2-63d1164867ea",
query: "thumbnail intro retention"
})
```
### Quando Consultar
- Criar animações e motion graphics
- Princípios de design visual
- Optimizar vídeos para redes sociais
- Storytelling visual
- Colocar imagens/audio em `public/`
- Usar `staticFile("nome.png")` para referenciar
- Formatos recomendados: PNG (imagens), MP3/WAV (audio)
---
## Paletas de Cores para Vídeo
## Troubleshooting
| Problema | Solucao |
|----------|---------|
| Video preto | Verificar `AbsoluteFill` tem background |
| Fontes nao carregam | Usar `@remotion/google-fonts` |
| Animacao nao funciona | Verificar range de frames no `interpolate` |
| Erro de modulo | `rm -rf node_modules && npm install` |
| Render lento | Reduzir `--concurrency` ou usar `--crf` maior |
---
## Workflow Completo
### Corporativo Profissional
```tsx
const colors = {
background: "#0f172a", // Slate 900
primary: "#3b82f6", // Blue 500
secondary: "#8b5cf6", // Violet 500
text: "#f8fafc", // Slate 50
accent: "#10b981", // Emerald 500
}
```
### Energético/Marketing
```tsx
const colors = {
background: "#ff006e", // Pink forte
primary: "#ffbe0b", // Amarelo vibrante
secondary: "#fb5607", // Laranja
text: "#ffffff",
accent: "#8338ec", // Roxo
}
```
### Minimalista/Elegante
```tsx
const colors = {
background: "#fafafa", // Off-white
primary: "#18181b", // Zinc 900
secondary: "#71717a", // Zinc 500
text: "#18181b",
accent: "#a855f7", // Purple 500
}
1. DEFINIR -> Duracao, resolucao, estilo
2. DESCREVER -> Prompt detalhado ao Claude
3. GERAR -> Claude cria componentes React
4. PREVIEW -> npm run dev (Remotion Studio)
5. AJUSTAR -> Refinar animacoes/timing
6. RENDER -> npx remotion render
7. EXPORTAR -> MP4/GIF/WebM conforme necessidade
```
---
## Animações Prontas (Copy-Paste)
## Referencias Detalhadas
### Fade In com Scale
```tsx
import { interpolate, useCurrentFrame } from "remotion"
Para conteudo detalhado, consultar:
export function FadeInScale({ children }: { children: React.ReactNode }) {
const frame = useCurrentFrame()
const opacity = interpolate(frame, [0, 30], [0, 1], { extrapolateRight: "clamp" })
const scale = interpolate(frame, [0, 30], [0.8, 1], { extrapolateRight: "clamp" })
return (
<div style={{ opacity, transform: `scale(${scale})` }}>
{children}
</div>
)
}
```
### Slide Up
```tsx
export function SlideUp({ children, delay = 0 }: { children: React.ReactNode; delay?: number }) {
const frame = useCurrentFrame()
const y = interpolate(frame, [delay, delay + 20], [50, 0], { extrapolateRight: "clamp" })
const opacity = interpolate(frame, [delay, delay + 20], [0, 1], { extrapolateRight: "clamp" })
return (
<div style={{ opacity, transform: `translateY(${y}px)` }}>
{children}
</div>
)
}
```
### Bounce In (Spring)
```tsx
import { spring, useCurrentFrame, useVideoConfig } from "remotion"
export function BounceIn({ children }: { children: React.ReactNode }) {
const frame = useCurrentFrame()
const { fps } = useVideoConfig()
const scale = spring({
frame,
fps,
config: {
damping: 10,
stiffness: 200,
mass: 0.5,
},
})
return (
<div style={{ transform: `scale(${scale})` }}>
{children}
</div>
)
}
```
### Text Reveal (Linha por Linha)
```tsx
export function TextReveal({ lines }: { lines: string[] }) {
const frame = useCurrentFrame()
return (
<div className="space-y-2">
{lines.map((line, i) => {
const delay = i * 15
const opacity = interpolate(
frame,
[delay, delay + 10],
[0, 1],
{ extrapolateRight: "clamp" }
)
return (
<div key={i} style={{ opacity }}>
{line}
</div>
)
})}
</div>
)
}
```
- [references/components.md](references/components.md) - Animacoes prontas, templates, paletas de cores, tipografia, motion design, acessibilidade
- [rules/animations.md](rules/animations.md) - Animacoes fundamentais
- [rules/timing.md](rules/timing.md) - Interpolacao e easing
- [rules/transitions.md](rules/transitions.md) - Transicoes entre cenas
- [rules/sequencing.md](rules/sequencing.md) - Organizacao temporal
- [rules/fonts.md](rules/fonts.md) - Carregamento de fontes
- [rules/images.md](rules/images.md) - Trabalhar com imagens
- [rules/audio.md](rules/audio.md) - Audio e som
- [rules/tailwind.md](rules/tailwind.md) - TailwindCSS no Remotion
---
## Tipografia para Vídeo
## Anti-Patterns
### Hierarquia de Tamanhos
```tsx
// Remotion 1920x1080
const textSizes = {
hero: "120px", // Título principal
h1: "80px", // Secções
h2: "60px", // Sub-títulos
h3: "40px", // Destaques
body: "32px", // Texto normal
caption: "24px", // Legendas
}
// Remotion 1080x1920 (Vertical)
const textSizesVertical = {
hero: "80px",
h1: "56px",
h2: "40px",
h3: "32px",
body: "24px",
caption: "18px",
}
```
### Font Pairings para Vídeo
```tsx
// Moderno Tech
<style>{`
@import url('https://fonts.googleapis.com/css2?family=Inter:wght@700;900&display=swap');
@import url('https://fonts.googleapis.com/css2?family=JetBrains+Mono:wght@500&display=swap');
`}</style>
// Editorial Elegante
<style>{`
@import url('https://fonts.googleapis.com/css2?family=Playfair+Display:wght@700;900&display=swap');
@import url('https://fonts.googleapis.com/css2?family=Source+Sans+Pro:wght@400;600&display=swap');
`}</style>
```
- Nao usar para tarefas fora do dominio de video/Remotion
- Nao usar quando outra skill mais especifica esta disponivel
- Nao executar sem confirmar requisitos com o utilizador
---
## Templates Prontos
### Logo Intro (5s)
```tsx
import { AbsoluteFill, Img, interpolate, spring, useCurrentFrame, useVideoConfig } from "remotion"
export function LogoIntro({ logoSrc }: { logoSrc: string }) {
const frame = useCurrentFrame()
const { fps } = useVideoConfig()
// Logo scale com spring
const logoScale = spring({
frame: frame - 10,
fps,
config: { damping: 12, stiffness: 200 }
})
// Tagline slide up
const taglineY = interpolate(frame, [60, 90], [50, 0], { extrapolateRight: "clamp" })
const taglineOpacity = interpolate(frame, [60, 90], [0, 1], { extrapolateRight: "clamp" })
return (
<AbsoluteFill style={{ backgroundColor: "#0f172a", justifyContent: "center", alignItems: "center" }}>
{/* Logo */}
<div style={{ transform: `scale(${logoScale})` }}>
<Img src={logoSrc} style={{ width: "300px" }} />
</div>
{/* Tagline */}
<div
style={{
position: "absolute",
bottom: "150px",
fontSize: "48px",
color: "#f8fafc",
fontWeight: 600,
transform: `translateY(${taglineY}px)`,
opacity: taglineOpacity,
}}
>
Crescimento Digital
</div>
</AbsoluteFill>
)
}
```
### Stats Highlight (3s)
```tsx
export function StatsHighlight({ stat, label }: { stat: string; label: string }) {
const frame = useCurrentFrame()
const { fps } = useVideoConfig()
// Número escala com bounce
const scale = spring({
frame,
fps,
config: { damping: 10, mass: 0.5, stiffness: 200 }
})
// Label fade in
const labelOpacity = interpolate(frame, [30, 45], [0, 1], { extrapolateRight: "clamp" })
return (
<AbsoluteFill style={{ backgroundColor: "#3b82f6", justifyContent: "center", alignItems: "center" }}>
{/* Número */}
<div
style={{
fontSize: "180px",
fontWeight: 900,
color: "#ffffff",
transform: `scale(${scale})`,
}}
>
{stat}
</div>
{/* Label */}
<div
style={{
fontSize: "40px",
color: "#dbeafe",
marginTop: "20px",
opacity: labelOpacity,
}}
>
{label}
</div>
</AbsoluteFill>
)
}
```
---
## Motion Design Guidelines
### Duração de Animações
| Tipo | Frames (30fps) | Duração |
|------|----------------|---------|
| Micro (hover, toggle) | 3-6 | 100-200ms |
| Rápida (fade, slide) | 12-18 | 400-600ms |
| Normal (entrada cena) | 24-30 | 800-1000ms |
| Lenta (transição cena) | 45-60 | 1.5-2s |
### Easing Curves
```tsx
import { Easing } from "remotion"
// Entrada suave
const easeOut = Easing.bezier(0, 0, 0.2, 1)
// Saída suave
const easeIn = Easing.bezier(0.4, 0, 1, 1)
// Entrada e saída suave
const easeInOut = Easing.bezier(0.4, 0, 0.2, 1)
// Spring natural
const spring = Easing.bezier(0.34, 1.56, 0.64, 1)
// Uso
const y = interpolate(frame, [0, 30], [100, 0], {
easing: easeOut,
extrapolateRight: "clamp"
})
```
### Princípios de Motion
1. **Staging** - Um movimento de cada vez
2. **Anticipation** - Preparação antes do movimento
3. **Follow Through** - Overshooting ligeiro
4. **Timing** - Velocidade comunica peso/importância
5. **Exaggeration** - Amplificar para ênfase
---
## Acessibilidade em Vídeo
### Contraste de Texto
```tsx
// NUNCA usar contraste baixo
// BAD: texto cinza em fundo branco
const bad = { color: "#9ca3af", background: "#ffffff" } // Ratio 2.8:1
// GOOD: contraste mínimo 4.5:1
const good = { color: "#1f2937", background: "#ffffff" } // Ratio 15.8:1
```
### Tamanho Mínimo de Texto
```tsx
// 1080p (1920x1080)
const minSize = "28px" // Legível em mobile
// 4K (3840x2160)
const minSize4k = "56px"
```
### Reduced Motion
```tsx
import { useVideoConfig } from "remotion"
export function RespectMotion({ children }: { children: React.ReactNode }) {
const { fps } = useVideoConfig()
const prefersReducedMotion = false // Remotion não tem acesso a media queries
// Para export, criar versão alternativa sem animações complexas
return children
}
```
---
## Datasets Dify (Consulta Obrigatória)
Em caso de dúvidas ou para aprofundar conhecimento, consultar os seguintes datasets via MCP:
| Dataset | ID | Prioridade |
|---------|----|-----------:|
| **Canva** | `7efc5db4-05b1-408a-9e41-b612188ee877` | 2 |
| **Criatividade** | `39818f77-8c70-4729-9b5c-6f92d3a2b418` | 2 |
| **Youtube Marketing** | `baa1b3e6-ebf0-4413-84b2-63d1164867ea` | 2 |
| **Marketing Redes Sociais** | `66117552-348f-455d-9aca-2da722567693` | 3 |
### Como Consultar
```javascript
# PRIMARIO: NotebookLM (Gemini 2.5 RAG)
# mcp__notebooklm__notebook_query({notebook_id: "76647e0f-3ae2-4c00-a0a8-f457aebf5655", query: "<tema>"}) // Marketing Digital Avancado
# mcp__notebooklm__notebook_query({notebook_id: "9053d0e8-dd39-460b-b5ea-e67af3e9a675", query: "<tema>"}) // Social Media e Branding
# mcp__notebooklm__notebook_query({notebook_id: "7b8fec17-d34f-4e3f-a8c6-8231e51f6323", query: "<tema>"}) // Copywriting e Persuasao
# mcp__notebooklm__notebook_query({notebook_id: "058a896e-6c9a-4e51-ae7d-9adb2738bc5f", query: "<tema>"}) // Producao de Video e Youtube
# mcp__notebooklm__notebook_query({notebook_id: "79d43410-0e29-4be1-881d-84db6bdc239a", query: "<tema>"}) // Estrategia e Empreendedorismo
# mcp__notebooklm__notebook_query({notebook_id: "4c595973-ba10-420a-a3bf-e4389e424ad3", query: "<tema>"}) // Marketing Digital PT
# mcp__notebooklm__notebook_query({notebook_id: "0c9c079c-a426-486c-99eb-1564d42d37ad", query: "<tema>"}) // Gestao de Projectos e Agile
# FALLBACK: Dify KB (se NotebookLM insuficiente)
// Princípios de design para vídeo
mcp__dify-kb__dify_kb_retrieve_segments({
dataset_id: "7efc5db4-05b1-408a-9e41-b612188ee877",
query: "animacao motion design"
})
// Técnicas criativas
mcp__dify-kb__dify_kb_retrieve_segments({
dataset_id: "39818f77-8c70-4729-9b5c-6f92d3a2b418",
query: "storytelling visual criativo"
})
// Optimização para YouTube
mcp__dify-kb__dify_kb_retrieve_segments({
dataset_id: "baa1b3e6-ebf0-4413-84b2-63d1164867ea",
query: "thumbnail intro retention"
})
```
### Quando Consultar
- Criar animações e motion graphics
- Princípios de design visual
- Optimizar vídeos para redes sociais
- Storytelling visual
---
**Versão**: 2.0.0 | **Data**: 2026-02-03 | **Autor**: Descomplicar®
**Projecto Base**: `/media/ealmeida/Dados/Dev/remotion-demo/`
**Documentação**: [remotion.dev/docs](https://remotion.dev/docs)
---
## 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
**Documentacao**: [remotion.dev/docs](https://remotion.dev/docs)

274
marketing/skills/video/references/components.md Normal file
View File

@@ -0,0 +1,274 @@
# /video - Componentes e Templates Remotion
## Animações Prontas (Copy-Paste)
### Fade In com Scale
```tsx
import { interpolate, useCurrentFrame } from "remotion"
export function FadeInScale({ children }: { children: React.ReactNode }) {
const frame = useCurrentFrame()
const opacity = interpolate(frame, [0, 30], [0, 1], { extrapolateRight: "clamp" })
const scale = interpolate(frame, [0, 30], [0.8, 1], { extrapolateRight: "clamp" })
return (
<div style={{ opacity, transform: `scale(${scale})` }}>
{children}
</div>
)
}
```
### Slide Up
```tsx
export function SlideUp({ children, delay = 0 }: { children: React.ReactNode; delay?: number }) {
const frame = useCurrentFrame()
const y = interpolate(frame, [delay, delay + 20], [50, 0], { extrapolateRight: "clamp" })
const opacity = interpolate(frame, [delay, delay + 20], [0, 1], { extrapolateRight: "clamp" })
return (
<div style={{ opacity, transform: `translateY(${y}px)` }}>
{children}
</div>
)
}
```
### Bounce In (Spring)
```tsx
import { spring, useCurrentFrame, useVideoConfig } from "remotion"
export function BounceIn({ children }: { children: React.ReactNode }) {
const frame = useCurrentFrame()
const { fps } = useVideoConfig()
const scale = spring({
frame,
fps,
config: { damping: 10, stiffness: 200, mass: 0.5 },
})
return (
<div style={{ transform: `scale(${scale})` }}>
{children}
</div>
)
}
```
### Text Reveal (Linha por Linha)
```tsx
export function TextReveal({ lines }: { lines: string[] }) {
const frame = useCurrentFrame()
return (
<div className="space-y-2">
{lines.map((line, i) => {
const delay = i * 15
const opacity = interpolate(frame, [delay, delay + 10], [0, 1], { extrapolateRight: "clamp" })
return (
<div key={i} style={{ opacity }}>{line}</div>
)
})}
</div>
)
}
```
---
## Templates Prontos
### Logo Intro (5s)
```tsx
import { AbsoluteFill, Img, interpolate, spring, useCurrentFrame, useVideoConfig } from "remotion"
export function LogoIntro({ logoSrc }: { logoSrc: string }) {
const frame = useCurrentFrame()
const { fps } = useVideoConfig()
const logoScale = spring({
frame: frame - 10,
fps,
config: { damping: 12, stiffness: 200 }
})
const taglineY = interpolate(frame, [60, 90], [50, 0], { extrapolateRight: "clamp" })
const taglineOpacity = interpolate(frame, [60, 90], [0, 1], { extrapolateRight: "clamp" })
return (
<AbsoluteFill style={{ backgroundColor: "#0f172a", justifyContent: "center", alignItems: "center" }}>
<div style={{ transform: `scale(${logoScale})` }}>
<Img src={logoSrc} style={{ width: "300px" }} />
</div>
<div style={{
position: "absolute", bottom: "150px", fontSize: "48px",
color: "#f8fafc", fontWeight: 600,
transform: `translateY(${taglineY}px)`, opacity: taglineOpacity,
}}>
Crescimento Digital
</div>
</AbsoluteFill>
)
}
```
### Stats Highlight (3s)
```tsx
export function StatsHighlight({ stat, label }: { stat: string; label: string }) {
const frame = useCurrentFrame()
const { fps } = useVideoConfig()
const scale = spring({ frame, fps, config: { damping: 10, mass: 0.5, stiffness: 200 } })
const labelOpacity = interpolate(frame, [30, 45], [0, 1], { extrapolateRight: "clamp" })
return (
<AbsoluteFill style={{ backgroundColor: "#3b82f6", justifyContent: "center", alignItems: "center" }}>
<div style={{ fontSize: "180px", fontWeight: 900, color: "#ffffff", transform: `scale(${scale})` }}>
{stat}
</div>
<div style={{ fontSize: "40px", color: "#dbeafe", marginTop: "20px", opacity: labelOpacity }}>
{label}
</div>
</AbsoluteFill>
)
}
```
---
## Paletas de Cores
### Corporativo Profissional
```tsx
const colors = {
background: "#0f172a",
primary: "#3b82f6",
secondary: "#8b5cf6",
text: "#f8fafc",
accent: "#10b981",
}
```
### Energético/Marketing
```tsx
const colors = {
background: "#ff006e",
primary: "#ffbe0b",
secondary: "#fb5607",
text: "#ffffff",
accent: "#8338ec",
}
```
### Minimalista/Elegante
```tsx
const colors = {
background: "#fafafa",
primary: "#18181b",
secondary: "#71717a",
text: "#18181b",
accent: "#a855f7",
}
```
---
## Tipografia para Vídeo
### Hierarquia de Tamanhos
```tsx
// Remotion 1920x1080
const textSizes = {
hero: "120px",
h1: "80px",
h2: "60px",
h3: "40px",
body: "32px",
caption: "24px",
}
// Remotion 1080x1920 (Vertical)
const textSizesVertical = {
hero: "80px",
h1: "56px",
h2: "40px",
h3: "32px",
body: "24px",
caption: "18px",
}
```
### Font Pairings
```tsx
// Moderno Tech
<style>{`
@import url('https://fonts.googleapis.com/css2?family=Inter:wght@700;900&display=swap');
@import url('https://fonts.googleapis.com/css2?family=JetBrains+Mono:wght@500&display=swap');
`}</style>
// Editorial Elegante
<style>{`
@import url('https://fonts.googleapis.com/css2?family=Playfair+Display:wght@700;900&display=swap');
@import url('https://fonts.googleapis.com/css2?family=Source+Sans+Pro:wght@400;600&display=swap');
`}</style>
```
---
## Motion Design Guidelines
### Duração de Animações
| Tipo | Frames (30fps) | Duração |
|------|----------------|---------|
| Micro (hover, toggle) | 3-6 | 100-200ms |
| Rápida (fade, slide) | 12-18 | 400-600ms |
| Normal (entrada cena) | 24-30 | 800-1000ms |
| Lenta (transição cena) | 45-60 | 1.5-2s |
### Easing Curves
```tsx
import { Easing } from "remotion"
const easeOut = Easing.bezier(0, 0, 0.2, 1)
const easeIn = Easing.bezier(0.4, 0, 1, 1)
const easeInOut = Easing.bezier(0.4, 0, 0.2, 1)
const y = interpolate(frame, [0, 30], [100, 0], {
easing: easeOut,
extrapolateRight: "clamp"
})
```
### Princípios de Motion
1. **Staging** - Um movimento de cada vez
2. **Anticipation** - Preparação antes do movimento
3. **Follow Through** - Overshooting ligeiro
4. **Timing** - Velocidade comunica peso/importância
5. **Exaggeration** - Amplificar para ênfase
---
## Acessibilidade
```tsx
// Contraste mínimo 4.5:1
const good = { color: "#1f2937", background: "#ffffff" } // Ratio 15.8:1
// Tamanho mínimo de texto
const minSize1080p = "28px"
const minSize4k = "56px"
```

642
marketing/skills/youtube/SKILL.md
View File

@@ -1,464 +1,109 @@
---
name: youtube
description: YouTube channel management and optimization. Content strategy, SEO, thumbnails,
and analytics. Use when user mentions "youtube", "canal youtube", "youtube seo",
"video optimization", "youtube analytics".
author: Descomplicar® Crescimento Digital
version: 3.0.0
quality_score: 75
user_invocable: true
desk_task: 1490
allowed-tools: Edit, Task
description: Gestao e optimizacao de canais YouTube. Estrategia de conteudo, SEO, thumbnails e analytics.
---
# /youtube - YouTube Complete Toolkit
Comando para extrair transcrições, metadados E estratégia de crescimento de canais YouTube. Best practices 2026.
Comando para extrair transcricoes, metadados e estrategia de crescimento de canais YouTube. Best practices 2026.
---
## 🎯 Arquitectura v3.0.0
## Contexto NotebookLM
| Funcionalidade | Método | Estado | Notas |
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 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 |
| **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 |
---
## 📊 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
```markdown
**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
```markdown
**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
```markdown
**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%)
```markdown
**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%)
```markdown
**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
```markdown
**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)
## MCP youtube-research (8/12 funcionais)
### Ferramentas Funcionais
| Ferramenta | Função | Parâmetros |
| Ferramenta | Funcao | Parametros |
|------------|--------|------------|
| `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) |
| `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 (NÃO USAR)
### Ferramentas com Problemas (nao 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 |
| Ferramenta | Problema |
|------------|----------|
| `get-video-transcript` | Nao devolve output |
| `enhanced-transcript` | Transcricao vazia |
| `get-key-moments` | Depende de transcricao |
| `get-segmented-transcript` | Depende de transcricao |
> [!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.
> **Aviso:** As ferramentas de transcricao do MCP youtube-research nao funcionam. Usar sempre o script local.
---
## 📜 Transcrições (Script Local)
## Transcricoes (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
### 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"
```
### Via Skill
```
/youtube https://youtube.com/watch?v=xxx
```
Ou via skill: `/youtube https://youtube.com/watch?v=xxx`
---
## 📤 Upload de Vídeos (MCP youtube-uploader)
## Casos de Uso
### 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
### 1. Analise Concorrencia
```javascript
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
```javascript
// Pesquisar top vídeos nicho
// Pesquisar top videos nicho
mcp__youtube-research__search-videos({
query: "marketing digital portugal",
maxResults: 50,
order: "viewCount",
regionCode: "PT",
videoDuration: "medium" // 4-20 min
videoDuration: "medium"
})
// Analisar canal concorrente
@@ -467,28 +112,17 @@ mcp__youtube-research__analyze-channel-videos({
maxResults: 50,
sortBy: "viewCount"
})
// Insights:
// - Topics mais populares
// - Duração média top performers
// - Frequência uploads
// - Engagement médio
```
### 2. Keyword Research
```javascript
// 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)
// Analisar: titulos mais usados, CTR estimado, competicao
```
### 3. Trending Topics Portugal
@@ -497,101 +131,99 @@ mcp__youtube-research__search-videos({
mcp__youtube-research__get-trending-videos({
regionCode: "PT",
maxResults: 50,
categoryId: "22" // People & Blogs
categoryId: "22"
})
// Criar conteúdo relacionado com trending
```
---
## 📚 Datasets Dify (Consulta Obrigatória)
## Metricas Chave (YouTube Studio)
| 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 |
| 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 |
### Como Consultar
---
## 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
// 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"
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"
})
```
### 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)
### Categorias Principais
| ID | Nome | Uso |
|----|------|-----|
| 22 | People & Blogs | Vlogs, lifestyle |
| 24 | Entertainment | Entretenimento geral |
| 27 | Education | Tutoriais, cursos |
| 28 | Science & Technology | Tech, ciencia |
---
## 📈 Instrumentação Automática
## Referencias Detalhadas
```sql
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}
);
```
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
---
**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`
## 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)
---
## 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]
```

215
marketing/skills/youtube/references/strategy-guide.md Normal file
View File

@@ -0,0 +1,215 @@
# /youtube - Estratégia de Crescimento e Optimização
## Estratégia Crescimento Canal 2026
### Fase 1: Fundação (0-1K Subscribers)
**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)
**KPIs:**
- AVD (Average View Duration) > 45%
- CTR > 5%
- 50-100 subs/mês
### Fase 2: Aceleração (1K-10K Subscribers)
**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
**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)
**KPIs:**
- AVD > 50% | CTR > 8%
- 200-500 subs/mês | 10K+ views/mês
### Fase 3: Escala (10K-100K+ Subscribers)
**Monetização:**
- AdSense (4K watch hours + 1K subs)
- Afiliados/Sponsors
- Produtos próprios (cursos, consultoria)
- Memberships/Super Chat
**KPIs:**
- AVD > 55% | CTR > 10%
- 1K+ subs/mês | 100K+ views/mês
- RPM > 3EUR
---
## Algoritmo YouTube 2026
| Métrica | Peso | Benchmark |
|---------|------|-----------|
| Average View Duration | 40% | > 50% duração vídeo |
| CTR (Click-Through Rate) | 30% | > 8% (home/search) |
| Engagement (likes, comments, shares) | 20% | > 5% views |
| Session Time | 10% | 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)
---
## Optimização Títulos e Thumbnails
### Fórmulas de Títulos que Convertem
| 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")
### Thumbnails que Destacam
**Elementos Críticos:**
1. Rosto/Expressão (70% thumbnails top performers)
2. Texto Legível (3-5 palavras MAX, font grande)
3. Cores Contrastantes (amarelo, laranja, vermelho destacam)
4. Regra dos Terços (rosto/objecto num terço)
**Ferramentas:**
- Canva (templates YouTube)
- Photopea (Photoshop online gratuito)
- Remove.bg (remover backgrounds)
---
## SEO YouTube
### Descrição Optimizada
```markdown
[Primeira linha: Resumo + keyword]
Aprende como ganhar dinheiro no YouTube em 2026.
[Timestamp links]
0:00 Introdução
2:15 Passo 1: Nicho
5:30 Passo 2: Conteúdo
[Descrição expandida - min 200 palavras, keyword 3-5x]
[CTAs]
Subscreve: [URL canal]
Newsletter: [URL]
[Links relacionados]
Vídeo anterior: [URL]
[Hashtags - 3-5 relevantes]
#YouTubeMarketing #GanharDinheiro
[Contacto/Social]
Instagram: @handle
```
### Tags (Estratégia)
```
1. Exact keyword (1-2)
2. Variações (3-5)
3. Long-tail (3-5)
4. Genéricas nicho (2-3)
Total: 10-15 tags
```
---
## Hook Perfeito (Primeiros 30 Segundos)
```
[0-5s] Pattern Interrupt
Imagem/som surpreendente, statement bold
"Ganhei €50K com este canal em 90 dias."
[5-15s] Promessa + Preview
"Neste vídeo, mostro exactamente o método passo a passo."
[15-30s] Credibilidade + CTA Suave
"Faço YouTube há 5 anos. Subscreve para não perder."
[30s+] Conteúdo prometido
Entregar valor IMEDIATAMENTE
```
**Anti-Patterns:**
- Logo intro longa (> 5s)
- "Olá pessoal, tudo bem?" - tempo perdido
- Pedir subscrição ANTES de dar valor
---
## Métricas Chave
| Métrica | Benchmark | Acção se < Benchmark |
|---------|-----------|----------------------|
| AVD | > 50% | Melhorar hook, cortar partes fracas |
| CTR | > 8% | Testar thumbnail/título |
| Subscribers Rate | > 1% views | CTAs mais claros |
| Likes/Views | > 5% | Pedir likes com razão |
---
## Upload com MCP youtube-uploader
```javascript
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",
status: "public",
category_id: "22", // 22 = People & Blogs, 28 = Science & Technology
publish_at: "2026-02-05T18:00:00Z"
})
```
### Configuração Inicial OAuth (uma vez)
1. `mcp__youtube-uploader__authenticate` → URL OAuth2
2. Abrir URL no browser → Login Google → Autorizar
3. Copiar código do redirect → `mcp__youtube-uploader__accesstoken`
---
## Categorias YouTube
| ID | Nome | Uso |
|----|------|-----|
| 22 | People & Blogs | Vlogs, lifestyle |
| 24 | Entertainment | Entretenimento geral |
| 27 | Education | Tutoriais, cursos |
| 28 | Science & Technology | Tech, ciência |