Communitygithub.com

Site pessoal: SEO para te acharem pelo nome

Uma skill de SEO leve para Claude Code feita para portfólios estáticos e sites pessoais: auditoria de 9 pontos em meta tags, Open Graph, Twitter cards, JSON-LD, robots.txt, sitemap, imagens, títulos e links, e depois aplica cada correção no seu HTML.

O que é Site pessoal: SEO para te acharem pelo nome?

Receita Site pessoal, passo 3 (ser encontrado), de aevans-eng/seo-skill. Digite /seo ou simplesmente pergunte por que seu site não aparece quando você busca seu nome. O agente lê seu HTML no GitHub Pages, Netlify ou Vercel e roda uma auditoria de 9 pontos: title, description e canonical; tags Open Graph e Twitter Card; JSON-LD Person e WebSite na home e CreativeWork nas páginas de projeto; robots.txt e sitemap.xml; texto alt, lazy loading e peso das imagens; um H1 por página, hierarquia de títulos e links internos; HTTPS e links quebrados; e os passos do Search Console depois de publicar. Mostra uma tabela de aprovado/reprovado e oferece adicionar tudo, reaproveitando suas imagens para os cards de compartilhamento. Sem ferramentas de build, sem chamadas de API.

Funciona com✓Claude Code~Codex CLI~Cursor
npx skills add aevans-eng/seo-skill

Perguntar na sua IA favorita

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

Documentação

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 texto alt descritivo (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 href e src resolvem
  • 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:

  1. Visite /robots.txt e /sitemap.xml diretamente para verificar se estão acessíveis
  2. Teste as tags OG compartilhando um link no Discord/Slack/Twitter e verificando o card de pré-visualização
  3. Envie o sitemap no Google Search Console
  4. Pesquise site:seudominio.com após alguns dias para verificar a indexação
  5. Pesquise suas consultas alvo e acompanhe o ranking ao longo do tempo

9. Configuração do Google Search Console

  1. Acesse o Google Search Console, adicione uma propriedade para seu domínio
  2. Verifique via registro DNS TXT ou método de arquivo HTML
  3. Envie a URL do sitemap
  4. 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çãoStatusObservaçõ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.

Habilidades Relacionadas