Auditoria de funil com Claude Code: de PV a produtos, treinamento e consultoria

Um funil que não termina em pageviews

Quando um artigo recebe tráfego, mas não gera compras, cadastros ou pedidos de consultoria, o problema nem sempre é o texto. Muitas vezes o leitor simplesmente não encontra o próximo passo. Um funil de conteúdo é o caminho que leva de um artigo para um PDF gratuito, um produto, um treinamento ou uma consultoria. Ele não deve parecer venda agressiva; deve combinar com o problema atual do leitor.

Artigos sobre Claude Code atraem leitores em estágios bem diferentes. Um iniciante quer comandos e hábitos seguros. Quem repete o mesmo fluxo quer templates, exemplos de setup ou um guia no Gumroad. Um líder de equipe quer permissões, regras de revisão, rollout, treinamento e adaptação a um repositório real. Se todos os artigos mostram o mesmo CTA, essas diferenças somem.

Este guia mostra como auditar esse caminho com Claude Code. O objetivo é olhar além de PV e conectar consultas de busca, CTR, cliques em CTA, visitas a produtos, visitas a treinamento e pedidos de consultoria. Para o contexto técnico, leia também analytics com Claude Code, SEO com Claude Code e A/B testing com Claude Code.

Alinhe as métricas primeiro

Comece definindo o nome dos números. Pageviews podem parecer sucesso mesmo quando o artigo não tem caminho de negócio. No Search Console, revise consultas, impressões, cliques, CTR e posição média. No GA4, revise visualizações de página, usuários, sessões, engajamento, eventos, eventos-chave, source/medium e landing pages.

Em termos simples, Search Console mostra como as pessoas encontraram a página na busca. GA4 mostra o que aconteceu depois da entrada no site. Use como referências primárias o SEO Starter Guide do Google Search Central, a documentação sobre Search Console e Google Analytics e os eventos recomendados do GA4.

Se o site usa Cloudflare, o Cloudflare Web Analytics também ajuda com pageviews, visitas, referenciadores e páginas principais. Não espere igualdade perfeita entre ferramentas, porque cada uma mede o tráfego de um jeito. A Cloudflare documenta os nomes em High-level metrics. A regra é não inventar conversão: use os dados reais do painel.

Defina o objetivo do artigo

Antes de entregar o artigo ao Claude Code, decida o que ele deve fazer. Se você pedir apenas “monetize isto”, pode receber texto vendedor demais ou conselhos genéricos. Defina se o artigo deve priorizar cadastro no PDF gratuito, visita à página de produtos, visita ao treinamento ou pedido de consultoria.

Um artigo para iniciantes normalmente deve levar ao cheatsheet gratuito antes de vender. Um artigo sobre setup, permissões ou CLAUDE.md pode apontar naturalmente para /products/, porque o leitor procura templates ou um guia reutilizável. Um artigo sobre rollout de equipe, reviews, CI ou segurança combina com /training/, porque depende de regras internas e contexto do repositório. Vários CTAs são possíveis, mas um precisa ser o principal.

Checklist do funil de conteúdo

Use esta tabela como briefing de auditoria. Um funil é o caminho de busca, artigo, cadastro, compra e consultoria. Não é uma técnica para forçar venda; é uma forma de descobrir onde o leitor trava.

Checagem	Onde olhar	Critério de aprovação
Intenção de busca	Consultas, título, h2	A promessa corresponde ao problema
Introdução	Três primeiros parágrafos	Fica claro para quem é e o que resolve
Links internos	Início, meio, fim	Aprendizado, analytics e produtos estão conectados
Posição do CTA	Abaixo da intro, corpo, final	CTA principal e secundário não competem
Mapeamento de produto	Tipo de artigo e catálogo	A oferta combina com o estágio do leitor
Caminho de consultoria	Final e seções de equipe	O leitor entende quando treinamento faz sentido
Medição	Eventos GA4, UTM, lead final	cta_click e lead concluído são separados
Mobile	Dispositivo ou navegador	Botões, tabelas e código são usáveis

Com essa tabela, Claude Code não faz só revisão de estilo. Ele consegue avaliar intenção, links internos, encaixe do produto e caminho de consulta ao mesmo tempo.

Audite o caminho de entrada

O caminho de entrada é a rota entre a primeira página visitada e a próxima ação útil. Um usuário vindo da busca pode chegar a um artigo, abrir o PDF gratuito, ver produtos, visitar um guia específico, entrar na página de treinamento e enviar uma consulta. Audite o percurso inteiro, não só o artigo.

Comece pelos 10 artigos que mais recebem entradas. Para cada um, anote consultas, leitor esperado, CTA principal, CTA secundário, links internos, referências oficiais e eventos de medição. Depois abra a URL pública em largura mobile e role da introdução até o CTA. Pergunte se a próxima ação é clara, se gratuito e pago estão distintos, e se a consultoria é apresentada ao leitor certo.

Claude Code fica melhor quando recebe não só o MDX, mas também os títulos das páginas de produto e treinamento. Se o artigo diz “agende treinamento”, mas a página de treinamento não explica os assuntos, o leitor hesita. Artigo e destino devem ser auditados como um único caminho.

Mapeie tipos de artigo para ofertas

Primeiro caso de uso: artigos para iniciantes. Buscas como “como usar Claude Code”, “começar” ou “comandos básicos” normalmente vêm de leitores que ainda não estão prontos para comprar. O CTA principal deve ser o PDF gratuito ou cheatsheet, com a página de produtos perto do final.

Segundo caso de uso: permissões, setup, CLAUDE.md e hooks. Esses leitores já têm um problema real no repositório. O CTA principal pode ser um guia de setup, templates de prompts ou checklist. Explique que os materiais reutilizáveis ficam em /products/.

Terceiro caso de uso: rollout de equipe, operação de reviews, CI/CD e segurança. Um template individual não basta. O leitor pode precisar de políticas, limites de permissão, papéis de revisão, material de treinamento e regras de rollback. O CTA principal deve ser /training/, com recursos gratuitos como passo leve.

Quarto caso de uso: content ops e caminhos de receita como este artigo. Esses temas cruzam PV, Search Console, GA4, páginas de produto e formulários de consulta. Produtos e treinamento são relevantes, mas com papéis claros: produtos para autosserviço, treinamento para implementação em equipe.

Regras práticas de CTA

CTA significa call to action: texto, link ou botão que explica a próxima ação. Não é só um botão. Uma frase no corpo, um link depois de uma tabela, um parágrafo de consultoria ou um bloco de PDF gratuito também são CTAs.

Na prática, coloque um link interno leve no início, um link de produto contextual no meio e um próximo passo claro no final. Se o artigo vende antes de responder à intenção de busca, o leitor sai. Se nenhum CTA aparece até o final, leitores prontos antes disso podem se perder.

No GA4, separe eventos como cta_click, view_item, begin_checkout, purchase e generate_lead. Consulte os eventos de ecommerce do GA4 antes de nomear eventos de compra. Um clique em CTA não é igual a um formulário enviado.

Prompt para auditar com Claude Code

Use este prompt com o MDX, página de produtos, página de treinamento e notas recentes de Search Console ou GA4.

You are auditing a published MDX article as a content funnel.

Goal:
- Do not optimize for pageviews only.
- Connect the article to the right next step: free PDF, products, training, or consultation.
- Keep the tone helpful, not pushy.

Inputs:
- Article MDX
- Product page URL: /products/
- Training page URL: /training/
- Related internal articles
- Search Console queries, impressions, clicks, CTR, average position
- GA4 landing page, sessions, events, key events, source/medium

Check:
1. The title and opening match the likely search intent.
2. The first internal link helps the reader continue learning.
3. The main CTA matches the reader stage.
4. The product or training CTA is explained before it appears.
5. The article has at least one official external reference.
6. Mobile readers can see and tap the CTA without layout issues.
7. The final paragraph says what was actually verified.

Return:
- Severity-ranked issues
- Specific replacement copy
- Missing links
- Measurement events to add or rename
- One short summary for the editor

Script Node.js para revisar MDX

Antes da revisão editorial, rode uma checagem mecânica. Salve como audit-content-funnel.mjs e passe os artigos como argumentos. Só usa módulos nativos do Node.js.

#!/usr/bin/env node
import fs from "node:fs";

const files = process.argv.slice(2);

const rules = [
  {
    name: "products CTA",
    test: (mdx) => mdx.includes("/products/"),
  },
  {
    name: "training CTA",
    test: (mdx) => mdx.includes("/training/"),
  },
  {
    name: "internal blog link",
    test: (mdx) => /\]\(\/(?:[a-z]{2}\/)?blog\/[^)]+\)/.test(mdx),
  },
  {
    name: "official analytics or search docs",
    test: (mdx) =>
      /https:\/\/(?:developers\.google\.com\/search|support\.google\.com\/analytics|developers\.cloudflare\.com\/web-analytics)\//.test(mdx),
  },
  {
    name: "funnel vocabulary",
    test: (mdx) =>
      /(CTA|導線|funnel|ファネル|consulta|consultation|상담|咨询)/i.test(mdx),
  },
];

if (files.length === 0) {
  console.error("Usage: node audit-content-funnel.mjs <article.mdx> [...]");
  process.exit(2);
}

let failed = false;

for (const file of files) {
  const mdx = fs.readFileSync(file, "utf8");
  const missing = rules.filter((rule) => !rule.test(mdx)).map((rule) => rule.name);

  if (missing.length === 0) {
    console.log(`${file}: OK`);
    continue;
  }

  failed = true;
  console.log(`${file}: missing ${missing.join(", ")}`);
}

if (failed) {
  process.exitCode = 1;
}

Exemplo:

node audit-content-funnel.mjs site/src/content/blog-pt/claude-code-content-funnel-audit.mdx
node audit-content-funnel.mjs site/src/content/blog*/claude-code-content-funnel-audit.mdx

O script não prevê receita. Ele apenas encontra CTAs de produto, CTAs de treinamento, links internos, referências oficiais e vocabulário de funil ausentes.

Erros comuns

O primeiro erro é colar o mesmo CTA em todos os artigos. Um artigo inicial fica pesado se leva direto para consultoria. Um artigo de equipe fica raso se oferece só um PDF gratuito.

O segundo erro é colocar CTA sem explicar o motivo. “Veja produtos” é fraco. Melhor: “Se você reescreve a mesma checklist de permissões em toda revisão, use os templates da área de produtos”.

O terceiro erro é medir todos os cliques como um evento só. Clique de PDF, produto e treinamento precisam ser separados. Inclua slug, tipo de CTA, destino e posição quando possível.

O quarto erro é pular a revisão mobile. Uma tabela ou bloco de código que estoura a largura pode esconder o CTA.

O quinto erro é confiar em memória antiga para termos de analytics. Search Console, GA4 e Cloudflare podem mudar nomes. Linke a documentação oficial e não exagere o significado de uma métrica.

O que Claude Code deve decidir

Claude Code é útil para encontrar links ausentes, sugerir textos de CTA, limpar tabelas, detectar code fences abertos e alinhar traduções. Ele não deve decidir meta de receita, prioridade de produto, capacidade de consultoria ou interpretação de conversões reais.

Isso importa porque pageviews podem contar uma história confortável. Um artigo com muito tráfego pode atrair leitores que querem só uma resposta gratuita. Um artigo menor sobre regras internas, permissões ou reviews pode valer mais para consultoria. Observe urgência, não só volume.

Próximo passo

Se você está começando sozinho, use o cheatsheet gratuito para manter comandos e checagens seguras do Claude Code por perto. Para prompts de auditoria, material de setup e templates de revisão, veja /products/. Para content ops, medição, permissões, regras de revisão e treinamento de equipe, use /training/.

Teste prático (実際に試した結果): a priorização ficou muito mais clara quando landing pages, consultas de busca, CTAs no corpo, transições para produtos e formulários de consultoria ficaram em uma única tabela. A checklist e o script Node.js não prometem receita, mas encontram lacunas básicas antes da publicação.