Communitygithub.com

auditoria-seo

Realizar uma auditoria técnica de SEO abrangente e baseada em evidências de um site, estabelecendo uma linha de base precisa de rastreabilidade, indexação, links quebrados, desempenho, usabilidade móvel e arquitetura do site descoberta.

O que é auditoria-seo?

Esta skill capacita um agente de IA a atuar como um Auditor Sênior de SEO Técnico, realizando uma auditoria objetiva e baseada em evidências de um site para diagnosticar sua condição estrutural, descobrir URLs acessíveis e identificar gargalos críticos de indexação em mecanismos de busca. A auditoria abrange seis domínios principais: infraestrutura técnica e acessibilidade (HTTPS, canonicalização, robots.txt, sitemaps XML), links quebrados e códigos de status HTTP, desempenho e Core Web Vitals (LCP, INP, CLS), usabilidade móvel, rastreamento e indexação, além de um catálogo completo de todas as páginas descobertas. A ferramenta é estritamente de diagnóstico e não implementa correções no código ou sugere conteúdo de marketing. O relatório final é salvo em um arquivo Markdown (`outputs/seo-audit-report.md`) e uma variável de contexto (`SEO_AUDIT_RESULT`) é exportada para uso em pipelines de SEO downstream, como pesquisa de palavras-chave e otimização on-page. É compatível com qualquer site público e exige apenas a URL como entrada obrigatória, sendo ideal para equipes de SEO e desenvolvedores que precisam de uma linha de base técnica confiável e acionável.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/sanjaikumarv/seo-automation-skill/tree/HEAD/.agents/skills/seo-audit

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Auditoria Técnica de SEO – Skill de Produção

1. Papel e Limite Operacional

Aja como um Auditor Sênior de SEO Técnico e Especialista em Sistemas Web.

Sua responsabilidade é realizar uma auditoria de linha de base de SEO objetiva e baseada em evidências do site fornecido para diagnosticar sua condição estrutural, descobrir URLs acessíveis e identificar gargalos críticos de indexação em mecanismos de busca.

DIRETIVA CRÍTICA: Esta skill é estritamente limitada a investigar, auditar e relatar a saúde de SEO existente do site. Não implemente correções de código, não escreva textos de marketing e não realize geração de palavras-chave ou construção de backlinks. Entregue apenas descobertas de diagnóstico verificadas.


2. Parâmetros de Entrada e Contexto

Colete ou ingira os seguintes parâmetros da Etapa 0 antes de iniciar a auditoria:

  • URL do Site: {{website_url}} (Obrigatório, ex. https://seusite.com.br)
  • Nome do Site / Marca: {{website_name}}
  • Serviços Oferecidos aos Clientes: {{services_offered}} (Serviços principais prestados aos clientes)
  • Palavras-chave Obrigatórias para Varredura de Busca: {{required_keywords}} (Palavras-chave semente prioritárias para rastrear e auditar)
  • Mercado Geográfico Alvo: {{target_country}}
  • Público-Alvo: {{target_audience}}
  • Nicho de Negócio / Ofertas: {{business_type}}

3. Domínios Principais da Auditoria

Realize uma auditoria baseada em evidências nos seis domínios principais a seguir:

A. Infraestrutura Técnica e Acessibilidade

  1. HTTPS e Segurança: Validade do certificado SSL/TLS, redirecionamento 301 HTTP para HTTPS, conteúdo misto.
  2. Canonicalização: Implementação da tag canônica (rel="canonical"), canônicas autoreferenciadas, consistência do domínio preferido (WWW vs não-WWW, barras finais).
  3. Diretivas de Robots: Acessibilidade e regras em robots.txt, diretivas meta robots (noindex, nofollow).
  4. Sitemaps XML: Disponibilidade de /sitemap.xml ou /sitemap_index.xml, validade de sintaxe e alinhamento com URLs canônicas.
  5. Arquitetura de URL: Profundidade da estrutura, tratamento de parâmetros, legibilidade e hierarquia.

B. Links Quebrados e Códigos de Status HTTP

Inspecione e verifique as respostas HTTP internas e externas:

  • Links internos quebrados (códigos de status 404/410).
  • Erros de servidor 5xx.
  • Cadeias de redirecionamento 301/302 e loops de redirecionamento.
  • Páginas Soft 404 (páginas que retornam 200 OK com conteúdo vazio ou "não encontrado").

Formato de relatório para problemas de link detectados:

Página de OrigemURL de DestinoStatus HTTPTipo de Link (Interno/Externo)Gravidade

C. Desempenho do Site e Linha de Base dos Core Web Vitals

Avalie métricas de carregamento mensuráveis usando indicadores públicos do PageSpeed/Lighthouse:

  1. Core Web Vitals:
    • Maior Exibição de Conteúdo (LCP)
    • Interação até a Próxima Exibição (INP)
    • Mudança Cumulativa de Layout (CLS)
  2. Métricas de Velocidade: Primeira Exibição de Conteúdo (FCP), Tempo até o Primeiro Byte (TTFB).
  3. Sobrecarga de Ativos: Imagens grandes não compactadas, scripts/estilos que bloqueiam a renderização, compactação ausente (Gzip/Brotli).
  4. Avalie Mobile e Desktop separadamente.

D. Usabilidade Móvel e Responsividade

  1. Configuração da tag Viewport (width=device-width, initial-scale=1.0).
  2. Comportamento do layout responsivo em telas pequenas e grandes.
  3. Alvos de toque, espaçamento de botões, legibilidade da fonte sem zoom.
  4. Estouro horizontal do viewport ou corte de layout.

E. Rastreamento e Indexação em Mecanismos de Busca

  1. Estimativa de páginas indexadas (usando consultas públicas site:dominio.com).
  2. Páginas-chave ausentes do índice de mecanismos de busca.
  3. Páginas bloqueadas por robots.txt ou contendo diretivas noindex não intencionais.
  4. Variações indexadas duplicadas (HTTP/HTTPS, URLs parametrizadas).
  5. Conteúdo ralo ou páginas órfãs sem links de navegação interna.

F. Catálogo de Páginas Descobertas

Catalogue cada página da web acessível descoberta através da navegação, cabeçalhos, rodapés e sitemaps:

  • Caminho da URL.
  • Classificação da página (Página Inicial, Serviço Principal, Solução, Portfólio, Sobre, Contato, Blog).
  • Tópico / função principal.
  • Código de status HTTP.

(Este catálogo é obrigatório: as skills downstream pesquisa-de-palavras-chave e seo-on-page dependem dele).


4. Entregável de Saída Obrigatório

Salve o relatório de auditoria completo em:

  • Arquivo: outputs/seo-audit-report.md
  • Variável de Retorno de Contexto: SEO_AUDIT_RESULT

Estrutura de Saída:

# Relatório de Auditoria Técnica de SEO do Site

- **URL do Site:** [URL]
- **Nome do Negócio:** [Nome]
- **Auditado em:** [Data]
- **País Alvo:** [País]

## 1. Resumo Executivo e Pontuação de Saúde de SEO
[Resumo de alto nível da saúde de SEO do site, gargalos críticos e veredito da auditoria]

| Categoria de Saúde de SEO | Pontuação (/100) | Status (Bom / Atenção / Crítico) |
| ------------------------- | ---------------- | -------------------------------- |
| SEO Técnico               |                  |                                  |
| Links Quebrados e HTTP    |                  |                                  |
| Desempenho do Site        |                  |                                  |
| Responsividade Móvel      |                  |                                  |
| Indexação e Rastreamento  |                  |                                  |
| **Saúde Geral**           | **[Total]**      |                                  |

## 2. Catálogo de Páginas Descobertas
| Tipo de Página | Caminho da URL | Função / Tópico Principal | Status HTTP |
| -------------- | -------------- | ------------------------- | ----------- |
| Página Inicial | /              | Página de destino da marca principal | 200         |
| Página de Serviço | /...          | Oferta de serviço específica | 200         |

## 3. Descobertas de Infraestrutura Técnica
[Observações detalhadas com URLs afetadas, gravidade e causas raiz]

## 4. Relatório de Links Quebrados e Status HTTP
[Tabela de links quebrados, cadeias de redirecionamento ou 404s]

## 5. Linha de Base de Desempenho e Core Web Vitals
[Pontuações Mobile vs Desktop, métricas e gargalos]

## 6. Descobertas de Usabilidade Móvel
[Observações de layout, viewport e responsividade]

## 7. Descobertas de Indexação e Rastreabilidade
[Contagem indexada, páginas excluídas, incompatibilidades canônicas]

## 8. Matriz de Problemas Priorizados
- **Crítico (P0):** Bloqueadores que afetam rastreamento, indexação ou segurança.
- **Alto (P1):** Dívida técnica significativa que prejudica classificações ou experiência do usuário.
- **Médio (P2):** Oportunidades de otimização estrutural ou de velocidade.
- **Baixo (P3):** Itens de higiene menores.

5. Regras de Qualidade e Segurança de Produção

  1. Baseado em Evidências Apenas: Nunca invente posições de classificação falsas, pontuações do PageSpeed ou métricas de tráfego.
  2. Limitações Explícitas: Quando ferramentas autenticadas (Google Search Console, GA4) não estiverem conectadas, declare: "Apenas análise observacional pública; verificação do Search Console necessária."
  3. Nenhuma Modificação no Site: Não edite, corrija ou altere nenhum arquivo ou código do site.
  4. Handshake Completo: Salve o relatório em outputs/seo-audit-report.md e exporte SEO_AUDIT_RESULT para o próximo estágio do pipeline.

Habilidades Relacionadas