feat(marketing): adiciona plugin marketing (agents, skills, knowledge e metadados do projeto)
This commit is contained in:
@@ -0,0 +1,159 @@
|
||||
---
|
||||
name: seo-report
|
||||
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.
|
||||
layer: wiki
|
||||
---
|
||||
|
||||
# Skill: /seo-report
|
||||
|
||||
Gera relatorio SEO completo com dados de multiplas fontes e exporta automaticamente para Google Docs.
|
||||
|
||||
---
|
||||
|
||||
## 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
|
||||
|
||||
```bash
|
||||
# Relatorio basico (envia para emanuelalmeidaa@gmail.com)
|
||||
/seo-report https://descomplicar.pt
|
||||
|
||||
# Relatorio para cliente especifico
|
||||
/seo-report https://cliente.pt cliente@email.com
|
||||
|
||||
# Relatorio com analise concorrencia
|
||||
/seo-report https://site.pt --competitors=concorrente1.pt,concorrente2.pt
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Fontes de Dados
|
||||
|
||||
| Fonte | Dados Recolhidos | Tempo |
|
||||
|-------|------------------|-------|
|
||||
| **Lighthouse (Desktop)** | Performance, SEO, Accessibility, Best Practices | ~30s |
|
||||
| **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 concorrencia) | ~3m (com 2 concorrentes)
|
||||
|
||||
---
|
||||
|
||||
## Workflow
|
||||
|
||||
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
|
||||
|
||||
---
|
||||
|
||||
## Estrutura do Relatorio
|
||||
|
||||
O relatorio final tem 8 seccoes:
|
||||
|
||||
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
|
||||
|
||||
---
|
||||
|
||||
## 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/
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Notas Tecnicas
|
||||
|
||||
### Requisitos
|
||||
- SEO Tools API a correr: `~/mcp-servers/seo-tools-api/start.sh`
|
||||
- Google Workspace MCP configurado
|
||||
- GSC authentication (OAuth primeira vez)
|
||||
|
||||
### Erros Comuns
|
||||
- **Site nao em GSC:** Relatorio gerado sem dados GSC (aviso incluido)
|
||||
- **Lighthouse timeout:** Retry automatico (3x)
|
||||
- **Ahrefs rate limit:** Skip backlinks, aviso no relatorio
|
||||
|
||||
---
|
||||
|
||||
## References (conteudo detalhado)
|
||||
|
||||
| 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 |
|
||||
|
||||
---
|
||||
|
||||
## 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
|
||||
|
||||
---
|
||||
|
||||
## Healing Log
|
||||
|
||||
Registo de erros conhecidos e como evitá-los. Lido automaticamente antes de executar.
|
||||
|
||||
```jsonl
|
||||
{"date":"","issue":"","fix":"","source":"user|auto"}
|
||||
```
|
||||
|
||||
*Adicionar nova linha após cada erro corrigido.*
|
||||
Reference in New Issue
Block a user