Emanuel Almeida
6b3a6f2698
- 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>
147 lines
4.2 KiB
Markdown
147 lines
4.2 KiB
Markdown
---
|
|
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.
|
|
---
|
|
|
|
# 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
|