Verifique a hierarquia de cabeçalhos e os erros de H1
Liste seus cabeçalhos na ordem da página e veja se a hierarquia se mantém: h1, h2, h3, h2, h3 passa, enquanto ir de h2 direto para h4 é apontado como um h3 ausente, na posição exata. É exigido um único h1. Grátis no seu navegador.
- Grátis
- Funciona no seu navegador
- Sem cadastro
- Seus dados não saem do seu aparelho
Executar grátis
Exemplo resolvido
- Títulos
- h1, h2, h3, h2, h3
- Quantidade de títulos
- 5
- Quantidade de H1
- 1
Uma hierarquia de cabeçalhos pode parecer correta na tela, enquanto as etiquetas subjacentes contam outra história. Este verificador recebe as etiquetas na ordem do documento, como h1, h2, h3 e h2, e aplica duas regras objetivas: deve haver exatamente um h1 e nenhum cabeçalho pode descer mais de um nível por vez. A resposta mostra a validade, a quantidade de h1 e a posição exata de cada salto, permitindo que equipes editoriais e sistemas de publicação corrijam os problemas.
Prepare a sequência na ordem do documento
Comece pelas etiquetas exatamente como elas aparecem no documento renderizado, não como estão em um layout ou roteiro editorial. Uma entrada comum pode ser h1, h2, h3, h2, h3. A ordem importa, pois a hierarquia é expressa pela transição entre um cabeçalho e o seguinte.
O verificador aceita etiquetas de h1 a h6, remove espaços nas extremidades e trata formas maiúsculas, como H2, da mesma maneira que as minúsculas. Ele não aceita HTML arbitrário, texto de cabeçalhos, classes CSS nem números isolados. Extraia esses elementos antes da solicitação para manter uma lista inequívoca.
Uma lista vazia é recusada como entrada inválida porque não existe estrutura para avaliar. Uma etiqueta malformada também é recusada com seu índice, facilitando o diagnóstico de uma etapa de extração defeituosa. Essa separação ajuda em pipelines: a extração determina quais etiquetas existem, enquanto esta capacidade avalia somente a ordem e os níveis delas.
Entenda as duas regras de hierarquia
A primeira regra exige exatamente um h1 na lista inteira. Um resultado sem h1 falha porque o documento não tem um cabeçalho superior único; dois ou mais também falham porque repetem o nível principal. A segunda regra compara cada par adjacente e registra um salto quando o número seguinte é mais de uma unidade maior que o anterior.
Assim, passar de h2 para h4 informa a ausência de h3. Passar de h1 para h5 informa que h2, h3 e h4 faltam nessa transição. Subir de h4 para h2 é permitido, pois encerra conteúdo aninhado e retorna a uma seção mais ampla.
Repetir o nível também é permitido, de modo que etiquetas h2 consecutivas podem abrir seções irmãs. O verificador lista todos os saltos, sem parar no primeiro. Cada registro inclui o índice de destino iniciado em zero, a transição e as etiquetas intermediárias ausentes.
O resultado só é válido quando existe um h1 e a coleção de saltos está vazia.
Use o resultado em revisões e bloqueios de publicação
Use o campo de validade para uma decisão simples de aprovação e mantenha os detalhes para fornecer orientações úteis. A contagem total confirma quantas etiquetas foram avaliadas, e a quantidade de h1 explica se a regra superior foi atendida. Cada salto aponta para o índice de destino onde ocorre a descida inválida, permitindo que um editor ou ferramenta de build localize o ponto sem interpretar uma mensagem ambígua.
A lista de problemas oferece resumos concisos em inglês para logs, comentários de revisão ou uma interface de gestão de conteúdo. Esta capacidade não avalia redação, palavras-chave, tamanho visual, texto vazio ou a quantidade ideal de seções. Também não busca uma URL nem interpreta HTML; quem começa com uma página deve extrair antes as etiquetas ordenadas.
Casos de uso
Bloquear estruturas de artigos incorretas
Recuse um rascunho quando as etiquetas extraídas não tiverem um único h1 ou pularem direto para um nível mal aninhado.
Revisar modelos depois de um redesign
Compare páginas renderizadas representativas e encontre saltos criados por componentes reutilizáveis ou mudanças de tema.
Adicionar verificações estruturais ao CI
Transforme a lista ordenada de uma build estática em um resultado determinista de aprovação ou falha antes do deploy.
Perguntas frequentes
Quanto custa a verificação?
O cálculo é determinista e não chama serviços externos.
Voltar de h4 para h2 é considerado um salto?
Não. Retornar a um nível mais amplo é permitido; somente uma descida superior a um nível é registrada.
Etiquetas maiúsculas são aceitas?
Sim. Formas como H1 e H3 são normalizadas para minúsculas após a validação, e espaços externos são ignorados.
Esta capacidade analisa uma página HTML?
Não. Ela espera uma lista já extraída de etiquetas entre h1 e h6 na ordem do documento e valida apenas essa sequência.
O que acontece se a página não tiver h1 ou tiver mais de um?
A verificação falha nos dois casos. Sem h1, o documento não tem um único cabeçalho principal; com dois ou mais, o nível de cima se repete. A contagem de h1 é informada para você ver qual dos dois casos aconteceu.
Ferramentas relacionadas
Para desenvolvedores — acesso via API
Tudo nesta página está disponível via API. Esta seção é para equipes que querem integrar a ferramenta aos próprios sistemas; quem não precisa disso pode simplesmente usar a ferramenta acima.
Endpoint
Autenticação por token Bearer. Um único POST coloca a tarefa na fila; o resultado chega por webhook ou link assinado.
Chame do seu código
curl -X POST https://api.kit.forhosting.com/seo/heading-structure-check \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"headings":["h1","h2","h3","h2"]}'const res = await fetch("https://api.kit.forhosting.com/seo/heading-structure-check", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"headings": [
"h1",
"h2",
"h3",
"h2"
]
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/seo/heading-structure-check",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"headings": [
"h1",
"h2",
"h3",
"h2"
]
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/seo/heading-structure-check", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"headings":["h1","h2","h3","h2"]}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"headings":["h1","h2","h3","h2"]}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/seo/heading-structure-check", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)Exemplo de requisição
{
"headings": [
"h1",
"h2",
"h3",
"h2"
]
}Exemplo de resposta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "seo.heading_structure_check",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}A API é assíncrona: cada chamada devolve um task_id na hora. Se preferir polling, consulte o status a até 1 requisição por segundo.
Preço
Preço publicado, sem tokens nem créditos escondidos. Tarefa que falha não é cobrada.
Erros
| HTTP | Código | O que significa |
|---|---|---|
401 | unauthorized | Token ausente ou inválido. Confira o header Authorization. |
402 | insufficient_balance | Saldo insuficiente para esta tarefa. Faça uma recarga e tente de novo. |
404 | unknown_type | Esse tipo de tarefa não existe. Confira o campo type no catálogo. |
429 | rate_limited | Muitas requisições em pouco tempo. Espere um instante e tente de novo. |
Perguntas técnicas
O que acontece quando a lista está vazia?
A solicitação retorna um erro invalid_input porque uma sequência vazia não contém estrutura que possa ser validada.