Communitygithub.com

AndresOrozcoDev/website

Faça auditorias em sites para SEO, aspectos técnicos, conteúdo, segurança, renderização JavaScript e prontidão para IA usando a CLI do SEOmator. Retorna relatórios otimizados para LLM com pontuações de saúde em 251 regras e 20 categorias. Use ao analisar sites, depurar problemas de SEO ou verificar a saúde do site.

O que é website?

Esta habilidade capacita agentes de IA a realizar auditorias abrangentes de sites usando a ferramenta de linha de comando SEOmator. Ela analisa sites contra 251 regras em 20 categorias, incluindo SEO principal, performance, links, imagens, segurança, SEO técnico, rastreabilidade, dados estruturados, renderização JavaScript, acessibilidade, conteúdo, redes sociais, E-E-A-T, estrutura de URL, redirecionamentos, mobile, internacionalização, validação HTML, prontidão para IA/GEO e conformidade legal. A auditoria produz um relatório com uma pontuação geral de saúde (0-100), detalhamentos por categoria e problemas específicos com recomendações de correção acionáveis. Suporta os formatos de saída console, JSON, HTML, Markdown e um formato XML compacto otimizado para LLMs (recomendado para agentes de IA). A instalação é feita via npm (`npm install -g @seomator/seo-audit`) e o uso típico envolve executar `seomator audit <url>` com sinalizadores como `--format llm` e `--crawl` para rastreamento de várias páginas. A habilidade também inclui comandos para verificar a configuração do sistema, gerenciar relatórios passados e criar arquivos de configuração.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/AndresOrozcoDev/website/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

Habilidade de Auditoria SEO

Audite sites para SEO, aspectos técnicos, conteúdo, performance, segurança, renderização JavaScript e prontidão para IA usando a CLI do SEOmator.

O SEOmator fornece auditorias abrangentes de sites, analisando a estrutura e o conteúdo do site com base em 251 regras em 20 categorias.

Ele fornece uma lista de problemas com níveis de severidade, URLs afetadas e sugestões de correção acionáveis.

Links

O Que Esta Habilidade Faz

Esta habilidade permite que agentes de IA auditem sites para 251 regras em 20 categorias, incluindo:

  • SEO Principal (19 regras): URLs canônicas, diretivas de indexação, unicidade de título, conflitos/loops canônicos
  • Performance (22 regras): LCP, CLS, FCP, TTFB, INP, compressão, caching, minificação, HTTP/2
  • Links (19 regras): Links quebrados, cadeias de redirecionamento, texto âncora, páginas órfãs, links localhost/fragmento
  • Imagens (14 regras): Texto alternativo, dimensões, lazy loading, formatos modernos, tamanho do alt, imagens de fundo
  • Segurança (16 regras): HTTPS, HSTS, CSP, segurança de links externos, segredos vazados, expiração/protocolo SSL
  • SEO Técnico (13 regras): robots.txt, sitemap.xml, estrutura de URL, páginas 404, soft 404s, códigos de erro
  • Rastreabilidade (18 regras): Conflitos de sitemap, sinais de indexabilidade, cadeias canônicas, problemas de paginação
  • Dados Estruturados (13 regras): Marcação Schema.org, Artigo, Organização, FAQ, Produto, Breadcrumb
  • Renderização JavaScript (13 regras): Verificações de DOM renderizado, incompatibilidades entre raw e renderizado, detecção de SSR
  • Acessibilidade (12 regras): Rótulos ARIA, contraste de cores, rótulos de formulários, landmarks, alvos de toque
  • Conteúdo (17 regras): Contagem de palavras, legibilidade, densidade de palavras-chave, detecção de duplicatas, larguras de pixel
  • Social (9 regras): Tags Open Graph, cartões Twitter, botões de compartilhamento, links de perfil
  • E-E-A-T (14 regras): Créditos de autor, citações, sinais de confiança, páginas sobre/contato, detecção YMYL
  • Estrutura de URL (14 regras): Slugs com palavras-chave, stop words, maiúsculas, underscores, IDs de sessão, parâmetros de rastreamento
  • Redirecionamentos (8 regras): Loops de redirecionamento, tipos (301/302), meta refresh, redirecionamentos JavaScript, redirecionamentos quebrados
  • Mobile (5 regras): Tamanhos de fonte, rolagem horizontal, intersticiais intrusivos, problemas de viewport
  • Internacionalização (10 regras): Atributo lang, validação de hreflang (links de retorno, conflitos, incompatibilidades)
  • Validação HTML (9 regras): Doctype, charset, estrutura do head, lorem ipsum, múltiplos títulos/descrições
  • Prontidão para IA/GEO (5 regras): HTML semântico, acesso a bots de IA, llms.txt, deriva de schema
  • Conformidade Legal (1 regra): Consentimento de cookies

A auditoria rastreia o site, analisa cada página de acordo com as regras de auditoria e retorna um relatório abrangente com:

  • Pontuação geral de saúde (0-100) com nota de letra (A-F)
  • Detalhamentos por categoria com contagens de aprovação/advertência/falha
  • Problemas específicos com URLs afetadas agrupadas por regra
  • Recomendações de correção acionáveis

Quando Usar

Use esta habilidade quando você precisar:

  • Analisar a saúde SEO de um site
  • Depurar problemas técnicos de SEO
  • Verificar links quebrados e cadeias de redirecionamento
  • Validar meta tags, URLs canônicas e dados estruturados
  • Auditar cabeçalhos de segurança, SSL e HTTPS
  • Verificar conformidade de acessibilidade
  • Analisar renderização JavaScript e compatibilidade SSR
  • Avaliar prontidão para IA/GEO (HTML semântico, llms.txt, acesso a bots)
  • Detectar conteúdo duplicado entre páginas
  • Validar configuração de hreflang e internacionalização
  • Verificar estrutura e validação de documentos HTML
  • Gerar relatórios de auditoria do site em vários formatos
  • Comparar a saúde do site antes/depois de alterações

Pré-requisitos

Esta habilidade requer a instalação da CLI do SEOmator.

Instalação

npm install -g @seomator/seo-audit

Verificar Instalação

Verifique se o seomator está instalado e o sistema está pronto:

seomator self doctor

Isso verifica:

  • Versão do Node.js (18+ recomendado)
  • Disponibilidade do npm
  • Chrome/Chromium para Core Web Vitals e renderização JS
  • Permissões de escrita para ~/.seomator
  • Presença de arquivo de configuração local

Configuração

Executar seomator init cria um arquivo de configuração seomator.toml no diretório atual.

seomator init                    # Configuração interativa
seomator init -y                 # Usar padrões
seomator init --preset blog      # Configuração otimizada para blog
seomator init --preset ecommerce # Configuração para e-commerce
seomator init --preset ci        # Configuração CI mínima

Se não houver um arquivo seomator.toml no diretório, CRIE UM com seomator init antes de executar auditorias.

Uso

Melhores Práticas para Agentes de IA

VOCÊ DEVE sempre preferir --format llm - ele fornece saída XML otimizada para tokens, projetada especificamente para agentes de IA (50-70% menor que JSON).

Ao auditar:

  1. Prefira sites ativos em vez de servidores de desenvolvimento locais para dados precisos de performance e renderização
  2. Use --no-cwv para auditorias mais rápidas quando não forem necessárias verificações de Core Web Vitals e renderização JS
  3. Defina o escopo das correções como tarefas concorrentes ao implementar várias correções
  4. Execute verificação de tipos/formatação após implementar correções (tsc, eslint, prettier, etc.)

Descoberta de Site

Se o usuário não fornecer um site para auditar:

  1. Verifique configurações de servidor de desenvolvimento local (scripts package.json, arquivos .env)
  2. Procure por links de projetos Vercel/Netlify
  3. Verifique variáveis de ambiente para URLs de implantação
  4. Pergunte ao usuário qual URL auditar

Se você tiver sites locais e ativos disponíveis, sugira auditar o site ativo para obter resultados precisos.

Fluxo de Trabalho Básico

# Auditoria rápida de página única com saída LLM
seomator audit https://exemplo.com --format llm --no-cwv

# Rastreamento de várias páginas (até 50 páginas)
seomator audit https://exemplo.com --crawl -m 50 --format llm --no-cwv

# Auditoria completa com Core Web Vitals + análise de renderização JS
seomator audit https://exemplo.com --crawl -m 20 --format llm

Opções Avançadas

Forçar novo rastreamento (ignorar cache):

seomator audit https://exemplo.com --refresh --format llm

Retomar rastreamento interrompido:

seomator audit https://exemplo.com --resume --format llm

Auditar apenas categorias específicas:

seomator audit https://exemplo.com -c core,security,js --format llm --no-cwv

Salvar relatório HTML para compartilhar:

seomator audit https://exemplo.com --format html -o relatorio.html

Saída detalhada para depuração:

seomator audit https://exemplo.com --format llm -v

Referência de Comandos

Opções do Comando Audit

OpçãoAliasDescriçãoPadrão
--format <fmt>-fFormato de saída: console, json, html, markdown, llmconsole
--max-pages <n>-mNúmero máximo de páginas para rastrear10
--crawlHabilitar rastreamento de várias páginasfalse
--categories <lista>-cCategorias separadas por vírgula para auditarTodas
--refresh-rIgnorar cache, buscar novofalse
--resumeRetomar rastreamento interrompidofalse
--no-cwvPular Core Web Vitals + renderização JSfalse
--verbose-vMostrar progressofalse
--output <caminho>-oCaminho do arquivo de saída
--config <caminho>Caminho do arquivo de configuração
--saveSalvar em ~/.seomatorfalse

Outros Comandos

seomator init              # Criar arquivo de configuração
seomator self doctor       # Verificar configuração do sistema
seomator config --list     # Mostrar todos os valores de configuração
seomator report --list     # Listar relatórios anteriores
seomator db stats          # Mostrar estatísticas do banco de dados

Formatos de Saída

FormatoFlagMelhor Para
console--format consoleSaída de terminal humano (padrão)
json--format jsonCI/CD, processamento programático
html--format htmlRelatórios independentes, compartilhamento
markdown--format markdownDocumentação, GitHub
llm--format llmAgentes de IA (recomendado)

A saída --format llm é um formato XML compacto otimizado para eficiência de tokens:

  • 50-70% menor que a saída JSON
  • Problemas classificados por severidade (críticos primeiro)
  • Sugestões de correção incluídas para cada problema
  • Saída limpa para pipe em ferramentas de IA

Exemplos

Exemplo 1: Auditoria Rápida com Saída LLM

# Usuário pergunta: "Verifique exemplo.com para problemas de SEO"
seomator audit https://exemplo.com --format llm --no-cwv

Exemplo 2: Rastreamento Profundo para Site Grande

# Usuário pergunta: "Faça uma auditoria completa com até 100 páginas"
seomator audit https://exemplo.com --crawl -m 100 --format llm --no-cwv

Exemplo 3: Nova Auditoria Após Alterações

# Usuário pergunta: "Re-audite o site, ignore resultados em cache"
seomator audit https://exemplo.com --refresh --format llm --no-cwv

Exemplo 4: Gerar Relatório Compartilhável

# Usuário pergunta: "Crie um relatório HTML que eu possa compartilhar"
seomator audit https://exemplo.com --crawl -m 20 --format html -o relatorio-seo.html

Exemplo 5: Foco em Áreas Específicas

# Usuário pergunta: "Apenas verifique minha renderização JavaScript e redirecionamentos"
seomator audit https://exemplo.com -c js,redirect --format llm

Avaliando Resultados

Faixas de Pontuação

PontuaçãoNotaSignificado
90-100AExcelente - Apenas otimizações menores
80-89BBom - Lidar com advertências
70-79CPrecisa de Trabalho - Correções prioritárias necessárias
50-69DRuim - Múltiplos problemas críticos
0-49FCrítico - Grandes problemas a resolver

Ordem de Prioridade (por peso da categoria)

Corrija os problemas nesta ordem para máximo impacto:

  1. Principal (12%) - Meta tags, canônico, H1, indexação
  2. Performance (12%) - Core Web Vitals + otimização
  3. Links (8%) - Estrutura de links internos
  4. Imagens (8%) - Performance + acessibilidade
  5. Segurança (8%) - Sinais de confiança, SSL
  6. SEO Técnico (7%) - Fundação de rastreamento
  7. Rastreabilidade (5%) - Indexabilidade, paginação
  8. Dados Estruturados (5%) - Snippets enriquecidos
  9. Renderização JavaScript (5%) - DOM renderizado, SSR
  10. Conteúdo (5%) - Qualidade do texto + duplicatas
  11. Acessibilidade (4%) - Conformidade WCAG
  12. Social (3%) - Compartilhamento social
  13. E-E-A-T (3%) - Confiança, especialização
  14. Estrutura de URL (3%) - Higiene de URL
  15. Redirecionamentos (3%) - Cadeias de redirecionamento
  16. Mobile (2%) - Viewport, fontes
  17. Internacionalização (2%) - Hreflang
  18. Validação HTML (2%) - Estrutura do documento
  19. Prontidão para IA/GEO (2%) - HTML semântico, bots de IA
  20. Conformidade Legal (1%) - Consentimento de cookies

Corrigir por Severidade

  1. Falhas (status: "fail") - Deve corrigir imediatamente
  2. Advertências (status: "warn") - Deve corrigir em breve
  3. Aprovações (status: "pass") - Nenhuma ação necessária

Resumo da Saída

Após implementar as correções, forneça ao usuário um resumo de todas as alterações feitas.

Ao planejar o escopo, organize as tarefas para que possam ser executadas simultaneamente como subagentes para acelerar a implementação.

Solução de Problemas

comando seomator não encontrado

Se você vir este erro, o seomator não está instalado ou não está no seu PATH.

Solução:

npm install -g @seomator/seo-audit

Core Web Vitals não medidos

Se as métricas CWV estiverem faltando, o Chrome/Chromium pode não estar disponível.

Solução:

  1. Instale Chrome, Chromium ou Edge
  2. Execute seomator self doctor para verificar a detecção do navegador
  3. Use --no-cwv para pular CWV se não for necessário

Tempo limite de rastreamento ou desempenho lento

Para sites grandes, as auditorias podem levar vários minutos.

Solução:

  • Use --verbose para ver o progresso
  • Limite páginas com -m 20 para resultados mais rápidos
  • Use --no-cwv para pular medições baseadas em navegador

URL inválida

Certifique-se de que a URL inclua o protocolo:

# Errado
seomator audit exemplo.com

# Correto
seomator audit https://exemplo.com

Como Funciona

  1. Buscar: Baixa o HTML da página e mede o tempo de resposta
  2. Analisar: Extrai DOM, meta tags, links, imagens, dados estruturados
  3. Enriquecer: Busca robots.txt e sitemap uma vez por auditoria
  4. Renderizar (se CWV habilitado): Captura o DOM renderizado via Playwright para análise de renderização JS
  5. Rastrear (se habilitado): Descobre e busca páginas vinculadas
  6. Analisar: Executa 251 regras de auditoria em cada página
  7. Pontuar: Calcula pontuações ponderadas por categoria e geral
  8. Relatar: Gera saída no formato solicitado

Os resultados são armazenados em ~/.seomator/ para recuperação posterior com seomator report.

Recursos

  • Referência completa das regras: Consulte docs/SEO-AUDIT-RULES.md para todas as 251 regras
  • Arquitetura de armazenamento: Consulte docs/STORAGE-ARCHITECTURE.md para detalhes do banco de dados
  • Ajuda da CLI: seomator --help e seomator <comando> --help

Individual skills in this repo

This repo contains 3 individual skills — each has its own dedicated page.

AndresOrozcoDev/website

Frontend design skill that generates, restyles, and guides UI development in mager's signature aesthetic — hot, sleek, sexy, usable, fun, and addictive interfaces with dark-first themes, terminal-inspired typography, neon accents, and visual discovery patterns. Use this skill when building or reviewing any frontend UI.

AndresOrozcoDev/website

Generate beautiful, production-ready, animated single-file HTML landing pages. Use this skill whenever the user asks to create a landing page, marketing page, product page, startup homepage, SaaS landing, app launch page, waitlist page, or any promotional single-page site. Also trigger when user says "make a landing for...", "generate landing page", "build me a homepage", "create a product page", "landing page for my startup", or asks to improve/redesign an existing landing page. Covers both "from scratch" generation and "improve/convert" workflows. Outputs one self-contained HTML file with Tailwind CSS, vanilla JS animations, responsive design, dark/light mode, and curated visual style presets. Always use this skill even for simple landing requests — it ensures premium, non-generic output.

AndresOrozcoDev/website

This skill should be used when the user asks to "write SEO content", "create a blog post", "write an article", "content writing for SEO", "draft optimized content", "write a how-to guide", "create a product description", "write a landing page", "SEO copywriting", "draft content targeting [keyword]", or "write 2000-word article about [topic]". Creates keyword-optimized content using a 12-step workflow: CORE-EEAT pre-write checklist, keyword integration, title optimization (5 formula options), meta description, H1/H2/H3 hierarchy, featured snippet targeting, internal/external linking, and readability enhancement. Produces full drafts with embedded SEO elements, title variants, meta description, FAQ section with schema, and a self-scored CORE-EEAT checklist. For AI-citation optimization, see geo-content-optimizer. For updating existing content, see content-refresher.

Habilidades Relacionadas