Habilidade SEO — Otimização para Sites Estáticos
Ferramenta leve de auditoria e correção SEO para sites HTML estáticos (GitHub Pages, Netlify, Vercel, etc.). Não requer ferramentas de build. Lê seu HTML, relata o que está faltando e adiciona.
Configuração
Antes do primeiro uso, informe ao Claude sobre seu site para que ele possa preencher os valores corretos:
- Domínio (ex.:
https://seudominio.com) - Páginas (ex.: index, sobre, curriculo, projetos/foo)
- Perfis sociais (LinkedIn, GitHub, Twitter, etc.)
- Pelo que você quer rankear (ex.: "joão silva engenheiro de software", "joão silva portfólio")
Claude armazena esse contexto para a sessão. Você só precisa informar uma vez.
O que fazer quando for invocado
Leia todos os arquivos HTML no diretório de origem do site. Verifique cada item abaixo. Relate uma tabela de aprovação/reprovação e depois ofereça-se para corrigir o que estiver faltando.
1. Itens essenciais do <head> por página
Toda página HTML precisa destes itens dentro de <head>:
<title>[Título da Página] — [Seu Nome]</title>
<meta name="description" content="[única, 150-160 caracteres, inclui palavras-chave alvo]">
<link rel="canonical" href="https://seudominio.com/[caminho]/">
<!-- Open Graph -->
<meta property="og:title" content="[igual ao título ou mais curto]">
<meta property="og:description" content="[igual à meta description]">
<meta property="og:image" content="https://seudominio.com/[caminho-para-imagem]">
<meta property="og:image:width" content="1200">
<meta property="og:image:height" content="630">
<meta property="og:url" content="https://seudominio.com/[caminho]/">
<meta property="og:type" content="website">
<meta property="og:site_name" content="[Seu Nome]">
<!-- Twitter Card -->
<meta name="twitter:card" content="summary_large_image">
<meta name="twitter:title" content="[igual ao og:title]">
<meta name="twitter:description" content="[igual ao og:description]">
<meta name="twitter:image" content="https://seudominio.com/[caminho-para-imagem]">
Diretrizes:
- Título: 50-60 caracteres. Nome + diferencial.
- Meta description: 150-160 caracteres, única por página, inclua seu nome + palavras-chave relevantes.
- Imagem OG: recomendado 1200x630px. Se não houver imagem personalizada por página, use uma compartilhada. Use uma imagem real do site, não um placeholder.
- URL canônica: deve corresponder exatamente à URL real implantada (consistência da barra final).
2. Dados estruturados (JSON-LD)
Adicione esquemas Person + WebSite na página inicial:
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "Person",
"name": "[Seu Nome]",
"url": "https://seudominio.com",
"jobTitle": "[Seu Cargo/Função]",
"affiliation": {
"@type": "Organization",
"name": "[Escola ou Empresa]"
},
"sameAs": [
"[URL do GitHub]",
"[URL do LinkedIn]"
],
"knowsAbout": ["[habilidade1]", "[habilidade2]", "[habilidade3]"]
}
</script>
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "WebSite",
"name": "[Seu Nome] — [Slogan do Portfólio]",
"url": "https://seudominio.com"
}
</script>
Para páginas de projetos, use CreativeWork:
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "CreativeWork",
"name": "[Nome do Projeto]",
"author": { "@type": "Person", "name": "[Seu Nome]" },
"description": "[Breve descrição do projeto]",
"url": "https://seudominio.com/[projeto]/"
}
</script>
Regras: Apenas JSON-LD (não Microdata/RDFa). Sem FAQPage (restrito a governo/saúde). Sem HowTo (obsoleto). Sem texto placeholder nos campos do schema.
3. robots.txt
Crie na raiz do site:
User-agent: *
Allow: /
Sitemap: https://seudominio.com/sitemap.xml
4. sitemap.xml
Crie na raiz do site:
<?xml version="1.0" encoding="UTF-8"?>
<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
<url>
<loc>https://seudominio.com/</loc>
<lastmod>[YYYY-MM-DD]</lastmod>
<priority>1.0</priority>
</url>
<!-- repita para cada página -->
</urlset>
Defina lastmod com as datas reais da última edição. Atualize o sitemap quando as páginas mudarem.
5. SEO de Imagens
- Todas as tags
<img>precisam de textoaltdescritivo (não "imagem1" ou "screenshot") - Use WebP quando possível, mantenha imagens abaixo de 200KB
- Adicione
loading="lazy"em imagens abaixo da dobra - A imagem OG deve ser um arquivo real, não um placeholder
6. Sinais de conteúdo e palavras-chave
- Tags H1: Uma por página, inclui nome ou nome do projeto + palavras-chave
- Hierarquia de headings: h1 > h2 > h3, sem pular níveis
- Nome no texto do corpo: Seu nome deve aparecer naturalmente em todas as páginas
- Links internos: As páginas devem linkar umas às outras (homepage para projetos, sobre para projetos, etc.)
- Links externos: Perfis sociais linkados a partir da página sobre/homepage
7. Verificações técnicas
- HTTPS: Verifique se todos os links e recursos internos usam
https:// - Consistência de barra final: Escolha um padrão e mantenha-o em todos os links, canônicos e sitemap
- Sem links quebrados: Verifique se todos os atributos
hrefesrcresolvem - Responsividade móvel: Meta tag viewport presente em todas as páginas
- Velocidade da página: Adie scripts não críticos. JS mínimo = boa base para sites estáticos.
8. Verificação pós-implantação
Após implantar:
- Visite
/robots.txte/sitemap.xmldiretamente para verificar se estão acessíveis - Teste as tags OG compartilhando um link no Discord/Slack/Twitter e verificando o card de pré-visualização
- Envie o sitemap no Google Search Console
- Pesquise
site:seudominio.comapós alguns dias para verificar a indexação - Pesquise suas consultas alvo e acompanhe o ranking ao longo do tempo
9. Configuração do Google Search Console
- Acesse o Google Search Console, adicione uma propriedade para seu domínio
- Verifique via registro DNS TXT ou método de arquivo HTML
- Envie a URL do sitemap
- Monitore o relatório de Cobertura para problemas de indexação
Saída rápida da auditoria
Ao executar uma auditoria, leia todos os arquivos HTML e produza:
| Verificação | Status | Observações |
|---|---|---|
| Meta descriptions | ... | ... |
| Tags OG | ... | ... |
| Schema JSON-LD | ... | ... |
| robots.txt | ... | ... |
| sitemap.xml | ... | ... |
| Texto alt das imagens | ... | ... |
| Tags H1 | ... | ... |
| Links internos | ... | ... |
| URLs canônicas | ... | ... |
Depois, ofereça-se para corrigir o que estiver faltando.