O portão de links pré-publicação: bloquear, manter ou aprovar
Uma chamada bulk nos hosts para os quais um rascunho faz link, seguida por uma árvore de quatro perguntas. A árvore decide se o post é publicado, aguarda uma pessoa ou é interrompido.
Equipe de pesquisa do SEOBlogBot ·
Nota sobre nomenclatura
As pessoas digitam "verificador de backlinks href" quando querem dizer Ahrefs. O portão abaixo funciona com qualquer fonte de classificação de domínio, e aqui usamos nossa própria ação bulk_dr. Ferramentas reais neste espaço incluem Ahrefs, Semrush e Moz; o Google Search Console mostra apenas seus próprios links.
O que o portão analisa
O portão lê apenas links de saída. Ele não analisa rankings, tráfego ou dados do Search Console, e nunca precisa dos seus dados de análise.
Um script extrai cada <a href> do HTML renderizado e reduz cada URL ao seu host. Ele remove duplicatas e envia a lista para bulk_dr em uma única chamada. Nada mais sai do seu build. Isso custa um crédito para até 2.000 hosts, então mesmo um post com sessenta referências custa uma fração de centavo.
Execute-o no HTML renderizado, não no Markdown. Shortcodes, embeds e plugins adicionam links que você nunca digitou. Verifique o que os visitantes veem.
Onde ele é executado
Coloque o portão o mais tarde possível. O melhor local é a última etapa do build antes do agendador, depois que o CMS ou o gerador estático produziu o HTML final. A mesma chamada bulk em todos os lugares.
WordPress
Conecte a mudança de status ao agendamento e execute o portão dentro desse hook. O post só deve permanecer agendado após o veredito PASS. Um hook, uma regra.
Hugo
Adicione uma etapa após hugo build que lê o HTML gerado na pasta public. Envie a lista de hosts para a chamada bulk antes que a etapa de deploy seja executada.
Ghost
Inscreva um webhook no evento de postagem agendada. O manipulador extrai os links do HTML do post e faz a mesma chamada, para que o Ghost e os sites estáticos compartilhem uma única regra.
A árvore, uma pergunta de cada vez
01
Algum host retorna com classificação 0 ou sem linha?
Um zero significa que nosso índice não possui domínios de referência para ele. Isso é normal para um site novo e um aviso para qualquer coisa que você cite como autoridade. Vá para a pergunta 2.
02
O host zero é uma fonte que você nomeou no texto?
Se o post o chamar de estudo, relatório ou página oficial, MANTENHA o post e envie-o para um editor. Se for uma ferramenta de nota de rodapé ou uma menção de marca, APROVE.
03
Três ou mais hosts estão abaixo do seu próprio piso?
Escolha o piso com base no seu histórico (veja a seção abaixo). Três ou mais hosts fracos em um post geralmente significam uma lista raspada ou um rascunho de IA colado. MANTENHA.
04
O mesmo host é vinculado mais de cinco vezes?
Links repetidos para um único domínio externo parecem um padrão de afiliado. Reduza-os à primeira menção. Se o script não puder decidir, MANTENHA.
Por que a árvore faz perguntas nessa ordem
As perguntas vão do sinal mais barato ao mais subjetivo. Cada resposta reduz o que a próxima pergunta precisa decidir, para que uma pessoa leia menos rascunhos.
A ordem também protege o tempo de um editor. Um HOLD com um motivo claro leva um minuto para ser acionado, enquanto um sinal vago é ignorado até o final da semana.
Zero primeiro, depois contexto
Um zero é o sinal mais barato, então vem primeiro. Sozinho, ele diz pouco. A próxima pergunta decide se o zero importa, é por isso que a árvore nunca bloqueia apenas com um zero.
Pense em um host que é novo no índice. Ele pontua zero, e ninguém na equipe ouviu falar dele. Se o post apenas o cita de passagem, a resposta é APROVE.
Pisos antes de contagens
Um host fraco sozinho é geralmente ruído. Vários hosts fracos em um rascunho formam um padrão, e um padrão é para o que um piso serve. Defina o piso com base no seu histórico antes de contar qualquer coisa, para que a contagem tenha um significado.
Repetições vêm por último
Links repetidos para um host são uma questão de estilo, não de qualidade. Pergunte por último, depois que as perguntas de qualidade forem respondidas. Uma contagem de repetições por si só raramente deve decidir o destino de um post.
O que cada saída faz no pipeline
Códigos de saída são uma sugestão; mapeie-os para o seu CI.
Saída
Significado
Ação no pipeline
Quem analisa
APROVE
Nenhuma regra acionada
O post vai para o agendador
Ninguém
MANTER
Uma regra suave acionada
Status definido como Pendente de revisão, mensagem no Slack com a lista de hosts
Um editor
BLOQUEAR
Erro de API 401/402 ou lista malformada
O trabalho falha, o post permanece como rascunho
Quem é responsável pelo pipeline
O que um editor deve ver em um MANTER
O título do post e o slot que ele estava prestes a ocupar na programação.
Cada host sinalizado com sua classificação e a regra que foi acionada.
A frase onde o host aparece, para que ninguém procure o rascunho inteiro.
Uma razão de uma linha quando o script não pôde decidir.
Uma maneira clara de liberar o post ou devolvê-lo ao escritor.
Escolhendo o piso sem emprestar um
Comece com seu próprio histórico. Pegue trinta posts publicados dos quais você está satisfeito e execute seus hosts de saída através do bulk_dr uma vez. Ordene as classificações e, em seguida, observe o décimo percentil.
Esse percentil é um primeiro piso sensato, porque sinaliza o décimo mais fraco do que você já aceita. Nossa classificação é uma escala logarítmica de 0 a 100, e Ahrefs DR e Moz DA permanecem escalas separadas. Limites de fóruns não são transferíveis.
Mantenha a amostra de trinta posts em seu repositório, com a data ao lado, para que o piso possa ser recalculado quando a amostra mudar.
Revise o piso a cada trimestre. O grafo de links cresce, e o índice é atualizado aproximadamente uma vez por mês. Um host que pontuou 8 na primavera pode ler 15 após uma atualização. O glossário explica os termos por trás desses números.
O portão em trinta linhas
Um esboço em shell e jq. Substitua pela sua linguagem; a estrutura permanece a mesma.
bash
HOSTS=$(grep -o 'href="https\?://[^/"]*' post.html | sed 's|.*//||' | sort -u | paste -sd, -)
RES=$(curl -s -H "Authorization: Bearer $SBB_KEY" \
"https://seoblogbot.com/api.php?action=bulk_dr&domains=$HOSTS")
case $(echo "$RES" | jq -r '.ok') in
true) ;;
*) echo "BLOCK: api error"; exit 2 ;;
esac
# inspect the response once and adapt the jq path to its shape
echo "$RES" | jq '.'
Quando uma chamada de portão falha
Nem todo erro é um veredito sobre o rascunho. Uma chamada falhada é um problema no trabalho, e os três casos HTTP abaixo precisam de três respostas diferentes. Escreva essas respostas antes do lançamento. Ninguém deve improvisar uma à noite.
Um 401 é um problema de configuração
Um 401 significa que a chave está faltando ou errada. Trate-o como um trabalho quebrado, não como um julgamento sobre o post. O post permanece como rascunho, e o proprietário do pipeline recebe a mensagem.
Um 402 é um problema de orçamento
Um 402 significa que o crédito acabou, e tentar novamente não resolve isso. Pare o trabalho e alerte uma pessoa. Adicione créditos na página da conta, em seguida, execute o lote falhado novamente.
Uma resposta malformada é um bug
Se o JSON não for analisado ou ok for falso, registre a resposta bruta no log e pare. Não adivinhe campos ausentes. Uma classificação adivinhada pode aprovar um post que deveria ter sido mantido.
Registre cada falha com o ID do post, o status HTTP e o horário, para que a mesma falha não se repita silenciosamente.
Verificando o resultado, não apenas a chamada
Uma resposta bem-sucedida significa que a chamada funcionou. Não prova que o post está agendado com o status correto. Leia de volta. Após o portão definir Agendado, confirme o status e o horário de publicação antes que o trabalho seja considerado concluído.
Caso contrário, um portão pode aprovar no papel enquanto o CMS silenciosamente descarta a alteração. Escreva essa leitura de volta no mesmo trabalho. Essa verificação é barata. Deixe-a falhar claramente quando o status não corresponder.
A leitura de volta também mostra qual etapa se desviou. Se o status estiver errado, o portão pode ter sido executado antes do build final. Saiba disso antes do próximo lançamento.
Mantenha o resultado da leitura de volta no log ao lado do veredito do portão. Os dois juntos mostram se o portão e o CMS concordaram em um determinado dia.
Perguntas que as equipes fazem antes de adicionar um portão
Um verificador de backlinks href é o mesmo que este portão?
Não. As pessoas digitam essa frase quando querem dizer Ahrefs. Este portão é um script que lê dados de links por meio de uma API, e ele é executado dentro do seu pipeline, não em uma aba do navegador.
Um portão atrasa a publicação?
O custo extra é uma ida e volta para a API por rascunho. Meça-o na sua própria rede antes de decidir que é lento demais, porque a resposta depende da sua configuração de build.
Como escolher o piso no primeiro dia?
Use a amostra de trinta posts da seção acima. Até ter uma, execute o portão no modo apenas de log, onde ele registra vereditos e não altera nenhum status.
O portão substitui um editor?
Não. Ele classifica rascunhos em APROVE, MANTER e BLOQUEAR para que um editor leia menos deles. Uma pessoa ainda decide o que um MANTER significa para esse post.
O portão pode ser executado em um rascunho que não é final?
Pode, mas o veredito descreve apenas os links naquele momento. Execute-o novamente no HTML final, porque uma edição tardia pode adicionar ou remover um link.
Um zero sempre significa que a fonte é ruim?
Não. Um zero significa que nosso índice não possui domínios de referência para esse host. É normal para um site novo, e torna-se um aviso apenas quando o post apresenta esse host como uma autoridade.
Nossa posição
Mantenha mais do que bloqueie
Um portão que bloqueia facilmente demais é desligado pelo terceiro editor irritado. Mantenha BLOQUEAR para infraestrutura quebrada e deixe os acionamentos de regra se tornarem um MANTER com um motivo claro.
Registre a lista de hosts com o veredito para que os recursos levem um minuto.
