Checagem de conversão antes de publicar: evite perder leitores com o Claude Code

Numa manhã, abri o painel de análise e travei. O artigo que eu tinha publicado no dia anterior estava com o triplo do PV de sempre. Mesmo assim: zero cadastros no PDF grátis, zero cliques no material pago. Aquela sensação de “bombou, mas não rendeu um centavo”.

Quando fui investigar, a causa era boba. O botão de inscrição no fim do artigo apontava para uma página de produto antiga, que eu tinha desativado seis meses antes. Para piorar, a versão em inglês trocava de idioma no meio do texto, e os leitores de fora abandonavam ali. O corpo do artigo estava bem escrito, mas eu perdia tudo nas últimas linhas.

Desde então separei de vez “escrever o artigo” de “conferir se ele está pronto para publicar”. Como fazer a segunda parte na mão sempre acaba em preguiça, eu transformei isso num roteiro fixo dentro do Claude Code. Hoje vou mostrar esse roteiro inteiro, em formato que você copia e cola.

Pontos principais

• Quando o PV cresce mas a inscrição não acompanha, a causa quase sempre é um erro que dava para pegar antes de publicar: link quebrado, página de produto antiga, ou texto que continua em inglês.
• Fixe nove itens para conferir antes de publicar e revise sempre na mesma ordem. As perdas despencam.
• O que o Claude Code faz é “abrir a página e conferir cada item de forma mecânica”. Qual botão é o protagonista, quem decide é você.
• Reduzir o botão de inscrição para um por artigo já basta para o leitor não se perder e seguir para a próxima ação.
• Registre o que foi conferido num log. Depois dá para rastrear “com base em quê eu publiquei isso”.

Defina os nove itens que você confere antes de publicar

“Confira direitinho” não faz nem pessoa nem IA agir. Conferir é uma lista de itens concretos. Os nove que eu deixo fixos são estes.

#	Item a conferir	O que olhar
1	A página abre	O servidor retorna 200 (e não 404 ou 500)
2	O título está certo	O h1 no topo da página bate com o título do artigo
3	URL canônica	A URL canônica aponta para a própria URL do artigo
4	Imagem de destaque	A imagem aparece (e não é a antiga, nem fica em branco)
5	Idioma do corpo	Cada versão está escrita no idioma certo desde o começo
6	Aviso do PDF grátis	O botão de cadastro existe e o destino do link está vivo
7	Link do material	O destino é a página de produto certa (não cai em outro produto)
8	Caminho até a consultoria	O link leva mesmo à página de consultoria
9	Visual no celular	Não aparece scroll horizontal (nada estoura a tela)

O segredo está nos itens 3 e 7. Se a URL canônica aponta para a home ou para outro artigo, o buscador trata aquela outra página como a oficial e o seu artigo não pontua. A troca de destino do link acontece mais justamente nos artigos feitos no copia-e-cola.

O que delegar à IA e o que você decide

Misturar essas duas coisas dá acidente. Vamos deixar a fronteira clara.

O que delegar ao Claude Code são as verificações que dá para julgar de forma mecânica. Abrir a página, ler o h1, buscar o destino do link, ver se a imagem aparece, conferir o layout na largura de celular. Isso é chato de fazer na mão, e quando é chato a gente pula. Então deixe a IA fazer toda vez.

O que você decide é a parte que exige julgamento. Qual botão será o protagonista neste artigo. Se o jeito de escrever soa natural. Se você não está divulgando um produto antigo. E a decisão final: “este artigo pode mesmo ir ao ar?”. Largar isso na mão da IA produz artigos com links vivos, mas com conteúdo desalinhado.

O critério na dúvida é simples: se a resposta é única, é IA; se envolve gosto ou estratégia, é pessoa. Se o link retorna 200 é uma resposta única, então é IA. Qual dos três botões destacar é estratégia, então é você.

Modelo de prompt para copiar e colar

Este é o prompt que você cola direto no Claude Code. Troque só o nome do repositório e as URLs que quer conferir pelos seus.

Para cada uma das URLs a seguir, execute a checagem de pré-publicação.
Confirme: a página abre com 200, o h1 bate com o título do artigo,
a URL canônica aponta para o mesmo artigo, a imagem de destaque aparece,
o corpo está escrito no idioma daquela versão, o botão de cadastro do
PDF grátis está vivo, o link do material leva à página de produto certa,
o link para a consultoria está correto, e na largura de celular não
aparece scroll horizontal.

Para cada URL, reporte em uma linha separando os itens aprovados dos
reprovados. Não considere aprovado só por "abriu com 200". Se houver
item reprovado, escreva também a provável causa e qual arquivo corrigir.

As duas últimas frases são o coração. Se você parar em “abriu com 200 = OK”, deixa passar a troca de link, que é o erro mais comum. Force a IA a sempre separar os itens reprovados e a dizer onde corrigir, e você já entra direto no conserto.

Script de avaliação que roda na hora

A parte que junta os resultados e devolve de forma mecânica “pode publicar ou não” vale deixar em código, para não variar a cada vez. Esta é a versão mínima que roda em Node.js.

// Os 9 itens que precisam passar antes de publicar
const requiredChecks = [
  "a página abre com 200",
  "o h1 bate com o título do artigo",
  "a URL canônica aponta para o mesmo artigo",
  "a imagem de destaque aparece",
  "o corpo está escrito no idioma certo",
  "o botão de cadastro do PDF grátis está vivo",
  "o link do material leva à página de produto certa",
  "o link para a consultoria está correto",
  "sem scroll horizontal na largura de celular",
];

// passed recebe o array com os nomes dos itens aprovados
function summarizeSmokeResult(passed) {
  const missing = requiredChecks.filter((check) => !passed.includes(check));
  return {
    ok: missing.length === 0,
    missing,
    nextAction: missing.length === 0 ? "pode publicar" : "corrigir e reconferir",
  };
}

// Exemplo: só o link do material reprovou
const passed = requiredChecks.filter((c) => c !== "o link do material leva à página de produto certa");
const result = summarizeSmokeResult(passed);

console.log(result.ok ? "PUBLICAR OK" : "PUBLICAR NÃO");
console.log("Itens reprovados:", result.missing);
console.log("Próxima ação:", result.nextAction);

Ao rodar esse script, ele mostra PUBLICAR NÃO, o nome dos itens reprovados e o que fazer em seguida. Se faltar um único item, ok vira false, então não acontece aquele acidente de publicar achando que “está mais ou menos OK”. Basta preencher o array passed com o resultado que a IA te devolveu usando o prompt acima.

Três situações em que isso funcionou de verdade

1. Dias em que publico vários artigos Nos dias em que solto três de uma vez, a conferência tende a ficar relaxada. Abra cada artigo no celular, um por um, e role até perto do título, do começo do corpo e do botão de inscrição. Se numa versão fora do inglês o corpo continuar em inglês, pare a publicação ali mesmo. Quanto mais corrido o dia, mais a lista fixa salva.

2. Quando você só troca o botão de um artigo popular Mesmo que seja só mudar um botão no fim de um artigo muito lido, pedir “ache as partes relacionadas e conserte” é amplo demais. Antes, defina: quais arquivos pode tocar, quais não, quais URLs conferir e o destino de cada link. Só isso já muda a conferência de “parece bom” para “com essa prova dá para publicar”.

3. Controle de qualidade de artigos multilíngues Mesmo que a marcação de idioma esteja correta, se o corpo continua em inglês não é qualidade de publicação. Em cada idioma, olhe o h1, o começo do corpo e a região do botão, e confirme se o leitor daquele idioma entende qual é o próximo passo. Para o leitor brasileiro, a explicação do PDF grátis, o convite ao material e o caminho até a consultoria precisam soar naturais em português.

Armadilhas comuns e como corrigir

Armadilha 1: reportar “publiquei” só porque o build passou local O build passar na sua máquina não garante que a página publicada apareça corretamente. Para corrigir, faça o alvo da conferência ser “a URL pública de verdade”, não “o resultado do build local”. Diga à IA, com todas as letras, “abra a URL pública e confira”.

Armadilha 2: enfileirar todos os botões de inscrição Colocar PDF grátis, material A, material B e consultoria no mesmo tamanho deixa o leitor sem saber qual apertar, e no fim ele não aperta nenhum. Para corrigir, escolha um botão protagonista por artigo e deixe o resto como apoio discreto.

Armadilha 3: o link cai em outro produto Escrever “PDF grátis” e o clique levar ao material pago é frequente em artigos de copia-e-cola. Para corrigir, faça a IA sempre buscar o destino do link do item 7 e confira o ID do produto a olho.

Armadilha 4: fazer mudanças grandes sem definir como voltar atrás O pior cenário é reescrever uma área enorme pouco antes de publicar e, quando dá ruim, não conseguir voltar ao estado anterior. Para corrigir, limite cada rodada ao escopo em que você consiga preparar antes “o passo para desfazer, se ficar estranho”. Tarefa cujo desfazer você não sabe escrever está grande demais para aquela rodada.

Perguntas frequentes

P. O PV subiu, mas a inscrição não. O que olho primeiro? R. Olhe primeiro o destino do botão de inscrição e o idioma do corpo. As duas maiores causas são: o link apontando para uma página de produto antiga, ou a versão voltada ao público de fora que não está no idioma certo. Isso corresponde aos itens 5, 6 e 7 da checagem.

P. Preciso fazer isso toda vez? É chato. R. Toda vez. Justamente por isso, não faça na mão: passe o prompt deste artigo ao Claude Code e deixe-o fazer de forma mecânica. Quanto mais chata a conferência, mais a gente pula nos dias corridos. E é exatamente no dia em que você pulou que o acidente acontece.

P. Reduzir para um botão não diminui as entradas para os outros produtos? R. Mais que o número de entradas, importa se o leitor consegue apertar uma sem se perder. Várias opções enfileiradas levam ao abandono por indecisão. Escolha um protagonista e deixe um ou dois links de apoio de forma natural ao longo do texto: esse é o equilíbrio certo.

P. Por que a URL canônica é tão importante? R. O buscador avalia como “oficial” a página indicada na URL canônica. Se isso aponta para outro artigo ou para a home, é a outra página que é avaliada no lugar do seu artigo, e o ranking de busca também se concentra ali.

P. Para que serve guardar o log de conferência? R. Para depois rastrear “com base em quê eu publiquei”. Quando surge um problema, fica mais fácil isolar onde a coisa falhou: no corpo, no botão, no link ou no caminho até a consultoria. Sem o log, na próxima operação você confere tudo do zero.

Registre o que conferiu em uma folha só

Deixar uma anotação curta depois de publicar deixa a próxima conferência muito mais leve. Um formato como este já basta.

- artigo: claude-code-revenue-smoke-test
- data de publicação: 2026-06-14
- provas conferidas: URL pública, h1, URL canônica, imagem de destaque, idioma do corpo, destino dos botões
- botão protagonista: link do material (para o leitor que caminha sozinho)
- próximos números a olhar: PV, cadastros no PDF, cliques no material, visitas à consultoria

Na hora de olhar os números, também não decida só pelo PV. Coloque lado a lado, na mesma data, os cadastros no PDF grátis, os cliques no material e as visitas à página de consultoria. Confronte com a hipótese: em artigo para iniciantes os cadastros no PDF devem subir; em artigo sobre configuração ou permissões, os cliques no material. Com esse hábito, a postagem diária deixa de ser “só publicar” e vira “um sistema para ajustar a conversão aos poucos”.

Essa fronteira entre “conferência que se delega à máquina” e “julgamento que a pessoa decide” vale o mesmo raciocínio além da checagem de receita. A visão geral de como um não-engenheiro usa o Claude Code está em Como não-engenheiros usam o Claude Code. Os pequenos truques para acelerar o trabalho diário estão em Dicas de produtividade no Claude Code. E como pedir bem a conferência à IA depende da precisão do prompt, vale ler junto Técnicas avançadas de prompt no Claude Code.

A base de como a IA lê arquivos e confere links você consulta na documentação oficial em Claude Docs. Quando sentir que o comportamento mudou, ver a fonte primária primeiro acaba sendo o caminho mais rápido.

O que aconteceu quando testei de verdade

Rodei esse roteiro no meu próprio site por umas duas semanas. O que eu queria confirmar era: “a checagem dos nove itens antes de publicar reduz mesmo as perdas?”.

O resultado: apareceram vários problemas que passavam batido quando eu só olhava se a página abria com 200. Em concreto, dois artigos prestes a sair com a imagem de destaque reaproveitada de outro post, um artigo com o botão de inscrição apontando para um produto antigo, e um caso em que a versão em inglês trocava de idioma no meio. Todos esses passariam como aprovados se o critério fosse só “abriu com 200”.

O que mais funcionou foi reduzir o botão de inscrição para um por artigo. Em artigos onde eu enfileirava PDF grátis, material e consultoria com o mesmo peso, reorganizei tudo em torno de um protagonista, e a taxa de clique no botão subiu visivelmente. Senti nos números aquilo de que o leitor age mais quando tem menos opções.

Por outro lado, descobri que essa conferência não se sustenta no trabalho manual. Nos primeiros dias eu fazia na mão, mas num dia corrido pulei sem pensar. Só depois de transformar em prompt e script, rodando sempre o mesmo procedimento, é que o hábito pegou.

Transformar em sistema a conferência sem graça de antes de publicar foi o seguro mais barato que encontrei para converter PV em receita. Se você quer encaixar isso na operação do blog da sua empresa ou no fluxo de publicação do time, na consultoria e treinamento dá para desenhar juntos um roteiro ajustado à sua operação real.