Otimização On-Page (on-page-seo)

SEO On-page

Requer: Python 3.10+. page_audit.py precisa de acesso à rede para a página ao vivo; text_stats.py é offline e lê um arquivo.

Aqui está o que eu mudaria primeiro: o título, depois a descrição, depois o H1. Eles são baratos, são o que as pessoas leem nos resultados e são fáceis de errar de maneiras que um script pode detectar.

Entradas

• A URL da página e uma consulta primária mais até duas secundárias. Se o usuário não tiver nenhuma, use as principais frases de text_stats.py, proponha uma e peça confirmação.
• O texto atual, para que o novo texto mantenha a voz da página.

Executando os scripts

Escreva cada script (shared/scripts/page_audit.py, shared/scripts/text_stats.py) sem alterações em um arquivo temporário, execute-o e depois o exclua. page_audit.py usa a rede apenas para ler a página que você nomear e não lê nenhum arquivo local. text_stats.py não faz chamadas de rede; ele lê um arquivo de texto ou a entrada padrão.

A="$(mktemp "${TMPDIR:-/tmp}/page_audit.XXXXXX")"   # cole shared/scripts/page_audit.py nele, inalterado
T="$(mktemp "${TMPDIR:-/tmp}/text_stats.XXXXXX")"   # cole shared/scripts/text_stats.py nele, inalterado
python3 "$A" https://example.com/page --json                # evidências: snippet, conteúdo, links-imagens, informações básicas
python3 "$T" copy.md --keyword "frase primária" --top 15    # voz, legibilidade, posicionamento de palavras-chave
rm -f "$A" "$T"

Saídas 0 e 1 acompanham a auditoria (1 significa uma lacuna alta ou crítica). Saída 2 significa entrada inválida. text_stats.py sai com 2 em caso de arquivo ausente, entrada vazia ou binária, ou uma opção fora do intervalo.

Passos

1. Execute a auditoria. Cite as evidências de snippet, content e basics: comprimentos do título e descrição, contagem de H1, palavras.
2. Meça o texto existente com text_stats.py. Observe a facilidade de leitura, palavras por frase e a contagem de "você" versus "nós". Iguale esses valores.
3. Escreva o título: 30 a 60 caracteres, frase primária perto do início, um motivo para clicar, marca por último. Único no site.
4. Escreva a descrição: 70 a 160 caracteres, a resposta ou promessa, um ponto de prova, sem aspas. Veja padrões.
5. Escreva um H1 que declare o tópico nas palavras do visitante. Construa os H2s como as perguntas que a página responde, em ordem, nunca pulando um nível.
6. Adicione ou corrija as tags de compartilhamento (og:title, og:description, og:image, twitter:card) e lang e viewport se estiverem faltando.
7. Verifique o posicionamento com --keyword: a frase deve aparecer no título, no H1 e nas primeiras 100 palavras, e soar natural.
8. Execute ambos os scripts novamente. Compare as partes perdidas antes e depois.

Saída

Uma tabela de antes e depois para título, descrição, H1 e esboço de H2 com contagens de caracteres; a marcação exata do cabeçalho para colar; quaisquer edições no corpo como frases de substituição; as leituras de text_stats.py antes e depois; as partes recuperadas da auditoria.

Critérios de saída

• Título de 30 a 60 caracteres; descrição de 70 a 160; exatamente um H1; dois ou mais H2s; nenhum nível de cabeçalho pulado.
• --keyword relata a frase primária em um cabeçalho e nas primeiras 100 palavras.
• Nenhuma frase é repetida até soar mal. Regra prática: mais de 3 usos por 100 palavras é excesso.
• A facilidade de leitura não piorou em relação ao original, a menos que o usuário tenha solicitado um registro diferente.
• Uma reauditoria mostra que as partes de snippet e content foram recuperadas, sem regressões em outros lugares.

Casos extremos e erros

• Página é de preços, contato ou login: 300 palavras podem não se aplicar. Diga que a parte de contagem de palavras é uma regra prática e deixe como está.
• Título já ranqueia e o usuário está nervoso: mude um elemento de cada vez e anote a data.
• Duas páginas competem pela mesma frase: pare e use keyword-clusters. Não reescreva ambas.
• Página não-inglesa: as listas de perguntas e verbos dos scripts estão em inglês. Relate essas partes como não aplicáveis.
• Mecanismos de busca reescrevem títulos e snippets. Diga que os novos são uma proposta que o mecanismo pode sobrescrever.

Regras

• Corresponda à voz da página. Se ela diz "você", você diz "você".
• Não invente fatos, preços ou provas para uma descrição. Use apenas o que está na página ou o que o usuário forneceu.
• Contagens de palavras-chave detectam excesso; não são um alvo. Nunca atinja uma densidade.
• Nunca prometa um ranking. Diga o que você mudou e o que isso deve tornar mais claro.