--- 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 --- # SEO Audit - Auditoria Completa Skill para realizar auditorias SEO completas usando o stack de ferramentas instalado. Best practices 2026. --- ## 🎯 Quando Usar - 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 --- ## 📊 Google Updates 2026 ### Core Algorithm Updates | Update | Data | Impacto | |--------|------|---------| | **Helpful Content Q1** | Jan 2026 | Penaliza conteúdo 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) | | **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 --- ## 🔧 Ferramentas Disponíveis ### 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) ``` 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 ``` **Checklist Crítico:** - [ ] Meta title (50-60 chars) - [ ] Meta description (150-160 chars) - [ ] H1 único com keyword - [ ] Canonical URL definido - [ ] Robots.txt accessível - [ ] Sitemap.xml presente - [ ] HTTPS activo - [ ] Mobile-friendly ### 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 ``` **Thresholds 2026:** | Métrica | 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) ``` 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 - [ ] Fontes citadas (links externos autoritativos) - [ ] Experiência 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 ``` **Métricas Autoridade:** - **DR (Domain Rating)**: 0-100 (força backlink profile) - **UR (URL Rating)**: 0-100 (força página específica) - **Backlinks**: Quantidade + qualidade (DR > 30) - **Referring Domains**: Número de domínios únicos ### 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 ``` **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 ### Passo 6: Concorrência (opcional, 2 min) ``` SEO Tools API → /competitor-analysis → Comparar com 2-3 concorrentes - Keywords gap - Backlinks gap - Content gap ``` --- ## 📄 Template de Relatório ```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/ https://carstuff.pt/ https://solarfvengenharia.com/ https://aquisevende.pt/ https://alojadamaria.com/ https://e-commerce.descomplicar.pt/ ``` ### Limitações - 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) --- ## 📚 Datasets Dify (Consultar SEMPRE) 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 --- ## 📈 Instrumentação Automática 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} ); ``` --- **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] ```