# Habilidade de Agente de Auditoria de SEO > Uma habilidade leve de Agente de Auditoria de SEO para Claude Code, OpenClaw e Codex. Execute auditorias rápidas de SEO em páginas únicas, verifique problemas centrais de SEO on-page e em nível de site e gere um relatório estruturado de SEO com correções acionáveis. - Canonical: https://nanoskill.ai/pt/skills/seo-audit - Markdown: https://nanoskill.ai/pt/skills/seo-audit.md - Author: JeffLi1993 - Published: 2026-05-11T01:05:35.771Z - Updated: 2026-07-25T04:34:17.896Z - Language: pt - Source type: github - Popularity signal: 382 ## Sources - https://github.com/JeffLi1993/seo-audit-skill ## Install ```shell npx skills add JeffLi1993/seo-audit-skill ``` ## About SEO Audit é uma habilidade leve de Agente de Auditoria de SEO para agentes de codificação de IA como Claude Code, OpenClaw e Codex. Ele ajuda um agente a inspecionar uma única URL, verificar problemas centrais de SEO e gerar um relatório de auditoria estruturado com evidências, impacto e correções recomendadas. A habilidade concentra-se em verificações de SEO de primeira passagem, incluindo tags de título, meta descrições, tags H1, tags canônicas, texto alternativo de imagens, posicionamento de palavras-chave, robots.txt, sitemap.xml, tratamento de erros 404, canonicalização de URL, páginas de confiança E-E-A-T e validação de esquema JSON-LD. Utilize-o quando precisar de uma verificação rápida de saúde de SEO antes de publicar uma página, revisar uma página de destino, diagnosticar problemas básicos de classificação ou decidir se é necessária uma auditoria técnica de SEO mais aprofundada. ## Key features - **Auditoria Rápida de SEO para Página Única**: Execute uma auditoria de SEO rápida para qualquer URL e obtenha uma visão de primeira passagem da saúde de SEO da página sem configurar um rastreador completo ou fluxo de trabalho de análise. - **Verificações Essenciais de SEO On-Page**: Verifique tags de título, meta descrições, tags H1, tags canônicas, texto alternativo de imagens, estrutura de cabeçalhos, posicionamento de palavras-chave, links internos e contagem de palavras. - **Noções Básicas de SEO de Nível de Site**: Revise os sinais fundamentais de SEO, como robots.txt, sitemap.xml, tratamento de erros 404, canonicalização de URLs, i18n / hreflang e páginas de confiança E-E-A-T. - **Validação de Schema JSON-LD**: Detecte se a página possui os dados estruturados corretos, valide os tipos de schema comuns e sinalize campos JSON-LD ausentes ou incompletos. - **Relatório de Auditoria de SEO Estruturado**: Gere um relatório de auditoria de SEO limpo com status de aprovação, aviso e reprovação, além de evidências, impacto e correções específicas para cada problema importante. ## Use cases - **Auditar uma Página de Destino Antes da Publicação**: Use esta habilidade antes de lançar uma página inicial, página de produto, página de ferramenta ou página de destino de SEO para detectar problemas básicos de SEO antecipadamente. - **Executar uma Verificação Rápida de Saúde de SEO**: Verifique se uma página possui o título, meta descrição, H1, tag canônica, schema, links internos e outros sinais básicos de SEO corretos. - **Revisar Páginas Existentes com Problemas de Classificação**: Use-o quando uma página está indexada, mas não está bem classificada, ou quando você deseja identificar rapidamente problemas óbvios on-page e de nível de site. ## Result preview Veja um resultado real de auditoria de SEO gerado por esta Habilidade de Agente. ![seo-audit-demo](https://file.nanoskill.ai/seo-audit-demo-1.png) ![seo-audit-demo-2](https://file.nanoskill.ai/seo-audit-demo-2.png) ![seo-audit-demo-3](https://file.nanoskill.ai/seo-audit-demo-3.png) ## Result walkthrough ### Passo 1：Instalar Adicione a habilidade ao seu agente ![seo-audit-step-1](https://file.nanoskill.ai/seo-audit-step-1.png) ### Passo 2：Tarefa de Auditoria Use uma URL e solicite uma auditoria priorizada. ![seo-audit-step-2](https://file.nanoskill.ai/seo-audit-step-2.png) ### Passo 3：Revisar Resultado Obtenha correções de SEO priorizadas que você pode implementar imediatamente. ![seo-audit-step-3](https://file.nanoskill.ai/seo-audit-step-3.png) ## Skill definition # seo-audit — Auditoria SEO Básica Uma habilidade de agente SEO leve, projetada para auditorias rápidas e padrão de página única. Desenvolvida com OpenClaw. Adequada para verificações iniciais de página ou quando é necessária uma avaliação rápida sem profundidade técnica total. --- ## Quando Usar Esta Habilidade Use `seo-audit` quando: - O usuário disser: "audite esta página", "verifique o SEO", "analise minha URL", "verificação rápida de SEO", "o que há de errado com minha página" - Nenhuma profundidade específica for solicitada — este é o ponto de entrada padrão - O usuário precisar de um resumo rápido e legível, em vez de uma análise técnica abrangente Se o usuário quiser mais profundidade, atualize para `seo-audit-full`: > **Dica:** Para auditorias técnicas profundas, SEO on-page avançado ou relatórios completos, use a habilidade `seo-audit-full`. --- ## Entrada Esperada | Entrada | Obrigatória | Observações | |-------|----------|-------| | URL da página | Sim | A página a ser auditada | | HTML bruto ou conteúdo da página | Opcional | Permite uma análise on-page mais precisa | | Dados do GSC / analytics | Opcional | Não necessários para auditoria básica | Se apenas uma URL for fornecida e nenhum código-fonte ou dados de rastreador estiverem disponíveis, declare claramente: > **Limitação:** Esta auditoria baseia-se apenas no conteúdo visível da página e em sinais publicamente disponíveis. Código-fonte, dados do GSC, logs de rastreamento e métricas de desempenho não estão disponíveis para esta auditoria. --- ## Saída Produza um **Relatório de Auditoria SEO Básica** preenchendo o modelo em [assets/report-template.html](assets/report-template.html), e **salve-o em um arquivo — nunca imprima HTML bruto no terminal**. **Nomeação do arquivo:** `reports/--audit.html` ``` https://exemplo.com/blog/melhores-ferramentas → reports/exemplo-com-blog-melhores-ferramentas-audit.html https://exemplo.com/ → reports/exemplo-com-audit.html ``` **Após salvar, informe ao usuário:** ``` ✅ Relatório salvo → reports/exemplo-com-audit.html Abri-lo agora? (sim / não) ``` Se sim → execute: `open reports/exemplo-com-audit.html` --- **Placeholders do modelo** — preencha cada um independentemente: | Placeholder | Conteúdo | |---|---| | `{{summary_verdict}}` | Uma frase: total de verificações executadas, quantas falharam/avisaram/passaram | | `{{summary_critical_html}}` | `
  • ` por item crítico (falha), ou `
  • Nenhum
    • ` | | `{{summary_warnings_html}}` | `
  • ` por item de aviso, ou `
  • Nenhum
    • ` | | `{{summary_passing_html}}` | `
  • ` por verificação aprovada, ou `
  • Nenhum
    • ` | --- ## Scripts Execute estes scripts antes de escrever quaisquer descobertas. Eles produzem JSON estruturado — use o JSON diretamente como evidência; não refaça a busca das mesmas URLs manualmente. **Dependências:** `pip install requests` (a análise de HTML usa a biblioteca padrão do Python) ```bash # Passo 1: verificações no nível do site (robots.txt + sitemap.xml) python scripts/check-site.py https://exemplo.com # Passo 2: verificações no nível da página (H1, título, meta descrição, canônico) python scripts/check-page.py https://exemplo.com # Com palavra-chave primária (recomendado — habilita verificação de presença de palavra-chave no H1) python scripts/check-page.py https://exemplo.com --keyword "tênis de corrida" # Opcional: buscar HTML bruto da página para inspeção adicional python scripts/fetch-page.py https://exemplo.com --output pagina.html # Passo 3: validação de esquema JSON-LD python scripts/check-schema.py https://exemplo.com # Ou de HTML previamente buscado (evita busca redundante): python scripts/check-schema.py --file pagina.html ``` Cada script sai com código `0` (todos passam/avisam) ou `1` (qualquer falha/erro). **ESCOPO ESTRITO — não adicione nenhuma verificação não listada abaixo. Sem exceções.** Verificações permitidas no nível do site (em `{{site_checks_html}}`): - robots.txt · sitemap.xml · Tratamento de 404 · Canonicalização de URL · i18n / hreflang Verificações E-E-A-T permitidas (em `{{eeat_checks_html}}`): - Sobre Nós · Contato · Política de Privacidade · Termos de Serviço · Mídia/Parceiros (apenas se presente) Verificações permitidas no nível da página (em `{{page_checks_html}}`), saída nesta ordem exata: Slug da URL · Tag de Título · Meta Descrição · Tag H1 · Tag Canônica · Texto Alt da Imagem · Contagem de Palavras · Posicionamento de Palavra-chave · Estrutura de Cabeçalhos · Links Internos · Schema (JSON-LD) Lógica de Texto Alt da Imagem: - Analise tags do HTML estático - Passa: todas as imagens têm alt não vazio (imagens decorativas com alt="" são OK) - Aviso: qualquer imagem de conteúdo sem atributo alt - Não verificado (status-info): 0 imagens encontradas no HTML estático → provavelmente renderizadas por JS, não é possível verificar ⛔ REGRA RÍGIDA — Produza APENAS as linhas de verificação definidas em report-template.html. Se uma verificação não estiver nas listas permitidas acima, NÃO a produza — mesmo que encontre problemas. Sem exceções. Sem verificações "bônus". Sem improvisação. O modelo é a única fonte da verdade. Trate-o como uma lista de permissões estrita. Ainda PROIBIDO (pertence ao seo-audit-full): Tags OG · Twitter Card · Tags sociais · Peso da Página · Core Web Vitals · Robots Meta **Como usar a saída JSON:** - Mapeie o `status` de cada campo → `pass` / `warn` / `fail` / `error` diretamente para a tabela de verificação do relatório - Use a string `detail` de cada campo como ponto de partida para a linha de Evidência nas descobertas - Não contradiga a saída do script, a menos que tenha evidência observável adicional - Separe os grupos de verificação com `
    Rótulo
    ` dentro de `{{site_checks_html}}`: `Rastreabilidade` · `Canonicalização de URL` · `i18n / hreflang` · `Schema (JSON-LD)` e `
    Páginas de Confiança E-E-A-T
    ` antes de `{{eeat_checks_html}}` **Revisão LLM — obrigatória quando `llm_review_required: true`:** O script sinaliza campos que exigem julgamento semântico ou de qualidade que ele não pode realizar. Nunca deixe `llm_review_required: true` sem resolver — sempre faça um julgamento explícito. **H1 — acionado quando `keyword_match == "partial"`:** ``` h1_text : (de h1.values[0]) keyword : (a --keyword passada para o script) Julgue: Este H1 cobre semanticamente a intenção de pesquisa da palavra-chave? - Considere sinônimos, variantes naturais, cobertura do tópico - sim → rebaixe para "pass", observe a variante - não → mantenha "warn" ou atualize para "fail", explique a lacuna ``` **Título — acionado quando `keyword_match == "partial"` OU `keyword_position != "start"`:** ``` title : (de title.value) keyword : (a --keyword passada) Julgue: 1. O título cobre semanticamente a intenção de pesquisa da palavra-chave? 2. O título está gramaticalmente correto e naturalmente legível? 3. Posição da palavra-chave — aplique padrões diferentes por tipo de página: - Página inicial: Marca + palavra-chave central está correto (ex. "Acme | Automação de Fluxo de Trabalho com IA") Não sinalize marca em primeiro lugar como um problema. - Páginas internas: A palavra-chave central deve liderar (ex. "Automação de Fluxo de Trabalho com IA para Equipes — Acme") Sinalize se a palavra-chave estiver enterrada no meio do título sem um bom motivo. IMPORTANTE — NÃO sinalize estes como negativos: - Anos (ex. "2026") → sinalizam frescor, aumentam o CTR — trate como positivo, a menos que a página seja explicitamente de conteúdo perene, onde a data prejudicaria a longevidade. - Números (ex. "5 melhores", "Top 10", "3 passos") → definem expectativas claras, superam consistentemente títulos não numéricos em CTR — sempre trate como um plus. - Qualificadores específicos ("Código Aberto", "Auto-Hospedado", "Grátis") → restringem a intenção e atraem cliques de maior qualidade — não penalize. ``` **Slug da URL — acionado quando `keyword_match != "full"` ou `is_homepage == false`:** ``` slug : (de url_slug.slug) keyword : (a --keyword passada) Julgue: 1. O slug contém a palavra-chave primária ou uma variante natural? 2. A hierarquia do caminho é lógica? (/categoria/palavra-chave é o ideal) 3. É conciso e legível por humanos? Página inicial (is_homepage: true): pule — nenhum julgamento necessário. ``` **Meta Descrição — sempre acionada quando o conteúdo está presente:** ``` meta_description : (de meta_description.value) keyword : (a --keyword passada) Julgue todos os quatro: 1. Frase(s) completa(s)? (1-2 frases, sem fragmentos) 2. Menciona um resultado concreto — não é vago? Bom: "Reduza o tempo de design em 60% com modelos alimentados por IA" Ruim: "A melhor ferramenta para todas as suas necessidades de design" 3. Palavra-chave ou sinônimo natural usado uma vez — não empilhado? 4. Mais específico do que o que um concorrente típico escreveria? IMPORTANTE — NÃO sinalize estes como negativos: - Anos (ex. "2026") → sinalizam frescor, melhoram o CTR para consultas sensíveis ao tempo. Apenas observe o ano se a página for explicitamente de conteúdo perene, onde a data prejudica. - Números (ex. "5 melhores", "3 passos") → especificidade concreta, forte sinal de CTR. - "e mais." no final → no máximo uma nota de estilo menor, nunca um Aviso ou Falha. ``` --- ## Fluxo de Trabalho Recomendado Siga estes passos em ordem: 1. **Reconheça o escopo** — confirme que esta é uma auditoria básica; observe quaisquer dados ausentes 2. **Inferir a palavra-chave primária** — busque a página com `fetch-page.py`, então determine a palavra-chave primária: - Se o usuário forneceu explicitamente uma palavra-chave → use-a diretamente - Se não → leia o H1, título e primeiro parágrafo da página, então infira a frase de palavra-chave alvo mais provável (o que um pesquisador digitaria para encontrar esta página?) - Declare a palavra-chave inferida explicitamente antes de executar as verificações: > "Palavra-chave primária inferida: **alternativas de código aberto ao claude**" 3. **Execute `check-site.py`** — analise a saída JSON para robots, sitemap, tratamento de 404 e canonicalização de URL **Verificação de 404:** busque `/esta-pagina-definitivamente-nao-existe-verificacao-seo-audit` - Retorna 404 → Passa · Retorna 200 (soft 404) → Falha · Retorna 301 para a página inicial → Aviso **Verificações de Canonicalização de URL** (cada uma é uma subverificação separada): - **HTTP→HTTPS:** busque `http://` — deve 301 para `https://`. Retorna 200 → Falha. - **Consistência de www:** busque ambos `https://www.` e `https://` — um deve 301 para o outro. Ambos retornam 200 → Aviso. - **Barra final:** compare a URL realmente servida com a tag canônica na página. Incompatibilidade → Aviso. - **Correspondência canônica:** o href da tag canônica deve corresponder exatamente à URL final após todos os redirecionamentos. Incompatibilidade → Aviso. 4. **Verificação de infraestrutura E-E-A-T** — para cada página de confiança abaixo, verifique duas camadas: - **Camada 1 — Existe:** busque a URL, verifique o status HTTP (200 = existe, 404/redirecionamento = ausente) - **Camada 2 — Alcançável:** busque o HTML da página inicial, verifique se o rodapé ou a navegação contém um link para esta página | Página | Obrigatória | |---|---| | Sobre Nós | Sim | | Contato | Sim | | Política de Privacidade | Sim | | Termos de Serviço | Sim | | Mídia / Parceiros | Não — inclua apenas se presente | Regras de status: - Página ausente (não 200) → **Falha** - Página existe, mas não está vinculada no rodapé/navegação → **Aviso** - Página existe e está vinculada no rodapé/navegação → **Passa** - Página opcional ausente → pule, não inclua linha 5. **Execute `check-page.py --keyword ""`** — analise a saída JSON para H1, título, meta descrição, canônico e slug da URL 6. **Verificação de i18n / hreflang** — execute apenas se a página contiver tags hreflang ou `` sugerir multilíngue: - **Pule completamente (N/A)** se nenhuma tag hreflang for encontrada e o site parecer de idioma único - Se hreflang tags estiverem presentes, verifique: - **Simetria recíproca**: cada URL referenciada deve vincular de volta a todas as outras variantes — qualquer link quebrado = Falha - **Códigos de idioma**: devem ser BCP 47 válidos (ex. `zh-CN` não `zh`, `en-US` não `en-us`) — código incorreto = Aviso - **x-default**: deve estar presente para páginas de seletor de idioma ou fallback — ausente = Aviso - **Atributo html[lang]**: deve corresponder ao hreflang primário da página — incompatibilidade = Aviso - **Estrutura de URL**: padrão recomendado — idioma padrão (geralmente `en`) na raiz sem prefixo, outros idiomas em subcaminhos (`/zh/`, `/es/`). - `/pagina` (en) + `/zh/pagina` + `/es/pagina` → Passa - `/en/pagina` + `/zh/pagina` → Aviso (prefixo en é redundante, desperdiça profundidade de rastreamento) - Sinalize apenas se o padrão for claramente inconsistente ou o en estiver desnecessariamente prefixado 7. **Execute `check-schema.py`** — analise a saída JSON para tipos de esquema e validação de campo ```bash python scripts/check-schema.py https://exemplo.com # Ou de HTML previamente buscado: python scripts/check-schema.py --file pagina.html ``` O script extrai blocos JSON-LD, valida `@type` e campos obrigatórios de acordo com a especificação Schema.org. `llm_review_required: true` está sempre definido — confirme se `inferred_page_type` corresponde ao conteúdo real da página. Tipo de página → referência de `@type` esperado: | Tipo de Página | @type Esperado | Campos obrigatórios mínimos | |---|---|---| | Página Inicial | WebSite + Organization | name, url, logo | | Blog / Artigo | Article ou BlogPosting | headline, datePublished, author, image | | Produto | Product | name, image, offers (price, priceCurrency) | | FAQ | FAQPage | mainEntity[].name, acceptedAnswer.text | | How-to | HowTo | name, step[].text | | Negócio Local | LocalBusiness | name, address, telephone | | Landing page genérica | — | N/A — pule, sem tipo amplamente suportado | - Passa: @type correto presente, todos os campos obrigatórios válidos, sem conflitos - Aviso: @type presente, mas faltando campos recomendados - Falha: @type esperado completamente ausente - N/A: página de destino genérica — não penalize 8. **Resuma as descobertas** — cada descoberta deve seguir o formato Evidência / Impacto / Correção 9. **Ações prioritárias** — liste as 3 principais correções de maior impacto 10. **Renderize o relatório** — salve em `reports/--audit.html`, depois pergunte ao usuário se deseja abrir 11. **Sugestão de atualização** — se problemas além do escopo básico forem encontrados, sugira `seo-audit-full` --- ## Regras de Redação de Detalhes do Relatório **A célula de Detalhe nas tabelas de verificação deve seguir estas regras — sem exceções:** **Passa → uma frase curta. Sem listas, sem elaboração.** ``` Bom: "Conjunto de URL XML válido · 104 URLs · referenciado em robots.txt." Ruim: "Conjunto de URL XML válido com 104 URLs. Corretamente referenciado em robots.txt. Postagens do blog provavelmente são indexadas através deste sitemap." ``` **Aviso → um `
    ` com ≤2 marcadores. Um `
    ` com a correção.** ``` Bom:
    · Título com 48 caracteres — 2 abaixo do mínimo. · Ano "2026" datará a página.
    Expanda para 50–60 caracteres; remova o ano se for perene.
    Ruim: prosa de três frases explicando o que é uma tag de título e por que o comprimento importa. ``` **Falha → mesmo que Aviso. Lidere com a falha exata. Sem explicações de fundo.** NÃO explique o que é uma verificação, NÃO repita informações já visíveis no selo de status, NÃO trate o leitor como não familiarizado com conceitos básicos de SEO. --- ## Formato Obrigatório de Descoberta Toda descoberta importante **deve** seguir esta estrutura: ``` **Descoberta: [Título da Descoberta]** - **Evidência:** [O que foi observado — citação direta, referência de captura de tela ou dados mensuráveis] - **Impacto:** [Por que isso importa para SEO ou UX] - **Correção:** [Recomendação específica e acionável] ``` Não escreva conclusões vagas. Se a evidência for insuficiente, declare as suposições explicitamente. --- ## Sugestão de Atualização Inclua isto no final de cada relatório de auditoria básica: > **Deseja uma análise mais profunda?** > Esta foi uma auditoria SEO básica cobrindo sinais no nível do site e verificações on-page centrais. > Para SEO técnico avançado, pontuação de qualidade de conteúdo, análise de dados estruturados e descobertas completas baseadas em rastreamento, use a habilidade `seo-audit-full`. --- ## Arquivos de Referência - Escopo detalhado da auditoria e definições de campo: [references/REFERENCE.md](references/REFERENCE.md) - Modelo final do relatório HTML: [assets/report-template.html](assets/report-template.html) - Script de verificação no nível do site: [scripts/check-site.py](scripts/check-site.py) - Script de verificação no nível da página: [scripts/check-page.py](scripts/check-page.py) - Buscador de página bruta: [scripts/fetch-page.py](scripts/fetch-page.py) - Script de validação de esquema: [scripts/check-schema.py](scripts/check-schema.py) ## FAQ ### O que é uma habilidade de Agente de Auditoria de SEO? Uma habilidade de Agente de Auditoria de SEO é um fluxo de trabalho reutilizável que ajuda um agente de IA a inspecionar uma página da web, verificar problemas de SEO e gerar um relatório de auditoria estruturado. Essa habilidade é projetada para auditorias rápidas de SEO em uma única página dentro dos fluxos de trabalho do Claude Code, OpenClaw e Codex. ### O que a habilidade de Auditoria de SEO verifica? Ela verifica os principais sinais de SEO on-page e de nível de site, incluindo tags de título, meta descrições, tags H1, tags canônicas, texto alternativo de imagens, posicionamento de palavras-chave, links internos, robots.txt, sitemap.xml, tratamento de erros 404, canonicalização de URLs, páginas de confiança e schema JSON-LD. ### Isso é uma auditoria técnica completa de SEO? Não. Esta é uma auditoria de SEO leve e de primeira passagem para uma única página. É útil para verificações rápidas e detecção de problemas básicos. Para auditorias baseadas em rastreamento, Core Web Vitals, diagnósticos de indexação, análise de logs e SEO técnico avançado, use um fluxo de trabalho de auditoria de SEO completa. ### Quem deve usar esta habilidade de Agente de Auditoria de SEO? É útil para operadores de SEO, fundadores de SaaS, hackers independentes, profissionais de marketing, equipes de conteúdo e desenvolvedores que desejam uma maneira rápida de verificar uma página antes de publicá-la ou melhorá-la. ### Que tipo de relatório ele gera? Ele gera um relatório de auditoria de SEO estruturado com status de aprovação, aviso e reprovação. As descobertas importantes incluem evidências, impacto de SEO e correções específicas, tornando o relatório mais fácil de passar para desenvolvedores ou equipes de conteúdo. ### Ele pode auditar qualquer URL? Sim, ele pode auditar uma URL pública com base no conteúdo visível da página e nos sinais de SEO disponíveis publicamente. Se o código-fonte, os dados do GSC, os dados de análise, os logs de rastreamento ou os dados de desempenho não estiverem disponíveis, o relatório deve declarar claramente essas limitações. ### Como isso é diferente de uma lista de verificação de SEO normal? Uma lista de verificação de SEO normal diz o que revisar. Esta habilidade de Agente de Auditoria de SEO fornece a um agente de IA um processo repetível para executar verificações, interpretar resultados e produzir um relatório estruturado com evidências e correções. ### Quando devo usar uma auditoria de SEO completa? Use uma auditoria de SEO completa quando precisar de uma análise técnica mais profunda, rastreamento em todo o site, Core Web Vitals, verificações de indexação, revisão da qualidade do conteúdo, arquitetura de links internos, análise de logs ou diagnósticos avançados de classificação.