Auditoría de funnel con Claude Code: de PV a productos, formación y consultoría

Un funnel que no termina en pageviews

Cuando un artículo recibe tráfico pero no genera compras, registros ni consultas, el problema no siempre es la redacción. Muchas veces el lector no encuentra el siguiente paso. Un funnel de contenido es el camino que lleva de un artículo a un PDF gratuito, un producto, una formación o una consulta. No debe sentirse como venta agresiva; debe encajar con el problema real del lector.

Los artículos sobre Claude Code atraen a lectores en fases muy distintas. Un principiante necesita comandos y hábitos seguros. Una persona que repite el mismo flujo necesita plantillas, ejemplos de configuración o una guía de Gumroad. Un responsable de equipo necesita permisos, reglas de revisión, formación, rollout y adaptación a un repositorio real. Si todos los artículos muestran el mismo CTA, esas diferencias desaparecen.

Esta guía explica cómo auditar ese camino con Claude Code. El objetivo no es mirar solo PV, sino conectar consultas de búsqueda, CTR, clics en CTA, visitas a productos, visitas a formación y solicitudes de consultoría. Para completar el contexto, combina esta lectura con implementación de analytics con Claude Code, SEO con Claude Code y A/B testing con Claude Code.

Alinear primero las métricas

Empieza por poner nombres claros a los datos. Los pageviews pueden parecer éxito aunque el artículo no tenga camino comercial. En Search Console revisa consultas, impresiones, clics, CTR y posición media. En GA4 revisa vistas de página, usuarios, sesiones, engagement, eventos, eventos clave, source/medium y landing pages.

En palabras simples, Search Console muestra cómo la gente encontró la página en Google. GA4 muestra qué hizo después de entrar al sitio. Usa como referencias primarias la guía inicial de SEO de Google Search Central, la documentación sobre Search Console y Google Analytics y los eventos recomendados de GA4.

Si el sitio pasa por Cloudflare, Cloudflare Web Analytics también ayuda con pageviews, visits, referrers y top pages. No esperes que todas las herramientas coincidan, porque miden el tráfico de formas distintas. Cloudflare documenta sus nombres en High-level metrics. La regla práctica es no inventar tasas de conversión: usa los datos reales de tu panel.

Definir el objetivo antes de pedir ayuda a Claude Code

Antes de entregar el artículo a Claude Code, decide qué debe lograr. Si solo pides “monetiza esto”, puede devolver texto demasiado vendedor o recomendaciones vagas. Define si el artículo debe llevar principalmente a un PDF gratuito, a una página de productos, a formación o a una consulta.

Un artículo para principiantes suele encajar mejor con el cheatsheet gratuito que con una venta inmediata. Un artículo sobre setup, permisos o CLAUDE.md puede enviar a /products/, porque el lector busca plantillas o una guía reutilizable. Un artículo sobre rollout de equipo, revisión, CI o seguridad encaja con /training/, porque depende de reglas internas y contexto de repositorio. Puedes usar varios CTAs, pero uno debe ser el principal.

Checklist del funnel de contenido

Usa esta tabla como briefing de auditoría. Un funnel es el camino desde búsqueda hasta artículo, registro, compra y consulta. No sirve para forzar una venta; sirve para encontrar dónde se atasca el lector.

Revisión	Dónde mirar	Criterio de aprobación
Intención de búsqueda	Consultas, título, h2	La promesa coincide con el problema
Introducción	Tres primeros párrafos	Se entiende para quién es y qué resuelve
Enlaces internos	Inicio, mitad, cierre	Aprendizaje, analytics y productos quedan conectados
Ubicación del CTA	Bajo la intro, cuerpo, cierre	CTA principal y secundario no compiten
Mapeo de producto	Tipo de artículo y catálogo	La oferta encaja con la fase del lector
Ruta de consulta	Cierre y secciones de equipo	Se entiende cuándo conviene formación
Medición	Eventos GA4, UTM, lead final	cta_click y lead completado están separados
Móvil	Dispositivo o navegador	Botones, tablas y código son utilizables

Con esta tabla, Claude Code no se limita a corregir estilo. Puede revisar intención de búsqueda, enlaces internos, ajuste del producto y ruta de consulta al mismo tiempo.

Auditar la ruta de aterrizaje

La ruta de aterrizaje es el camino desde la primera página visitada hasta la siguiente acción útil. Un usuario de búsqueda puede llegar a un artículo, abrir el PDF gratuito, mirar productos, visitar una guía concreta, entrar en formación y enviar una consulta. Audita el recorrido completo, no solo el artículo.

Empieza con los 10 artículos de mayor tráfico como landing page. Para cada uno, anota consultas, lector esperado, CTA principal, CTA secundario, enlaces internos, fuentes oficiales y eventos de medición. Luego abre la URL pública en ancho móvil y desplázate desde la introducción hasta el CTA. Pregunta si la acción siguiente es clara, si lo gratuito y lo pago se distinguen y si la consulta está dirigida al lector correcto.

Claude Code mejora cuando le das no solo el MDX, sino también los encabezados de las páginas de productos y formación. Si el artículo dice “reserva formación” pero la página de formación no explica qué se puede tratar, el lector duda. Revisa artículo y página de destino como un solo camino.

Mapear tipos de artículos a ofertas

Primer caso de uso: artículos para principiantes. Búsquedas como “cómo usar Claude Code”, “empezar” o “comandos básicos” suelen venir de lectores que todavía no están listos para comprar. El CTA principal debe ser el PDF gratuito o cheatsheet, con la página de productos al final.

Segundo caso de uso: permisos, setup, CLAUDE.md y hooks. Estos lectores ya tienen un problema real en un repositorio. El CTA principal puede ser una guía de setup, plantillas de prompts o una checklist. Explica que los materiales reutilizables están en /products/.

Tercer caso de uso: rollout de equipo, operación de reviews, CI/CD y seguridad. Una plantilla individual no basta. El lector puede necesitar políticas, límites de permisos, roles de revisión, material de formación y reglas de rollback. El CTA principal debería ser /training/, con recursos gratuitos como paso ligero.

Cuarto caso de uso: content ops y rutas de monetización como este artículo. Estos temas cruzan PV, Search Console, GA4, páginas de producto y formularios de consulta. Productos y formación son relevantes, pero con roles claros: productos para autoservicio, formación para implementación en equipo.

Reglas prácticas para CTAs

CTA significa call to action: el texto, enlace o botón que indica la siguiente acción. No es solo un botón. También puede ser una frase dentro del texto, un enlace después de una tabla, un párrafo de consulta o una caja de PDF gratuito.

En la práctica, coloca un enlace interno ligero cerca del inicio, un enlace de producto con contexto en la mitad y una acción clara al final. Si vendes antes de responder la intención de búsqueda, el lector se va. Si no aparece ningún CTA hasta el final, pierdes a quienes ya estaban listos.

En GA4 conviene separar eventos como cta_click, view_item, begin_checkout, purchase y generate_lead. Revisa los eventos ecommerce de GA4 antes de nombrar eventos de compra. Un clic en CTA no es lo mismo que un formulario enviado.

Prompt de auditoría para Claude Code

Usa este prompt junto con el MDX, la página de productos, la página de formación y notas recientes de Search Console o 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 de la revisión editorial, puedes detectar faltantes mecánicos. Guarda esto como audit-content-funnel.mjs y pasa archivos de artículos como argumentos. Solo usa módulos integrados de 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;
}

Ejemplo:

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

El script no predice ingresos. Solo detecta CTAs de producto, CTAs de formación, enlaces internos, referencias oficiales y vocabulario de funnel ausentes.

Errores comunes

El primer error es pegar el mismo CTA en todos los artículos. Un artículo inicial se siente pesado si lleva directo a consultoría. Un artículo de equipo se siente débil si solo ofrece un PDF gratuito.

El segundo error es añadir un CTA sin explicar por qué aparece. “Ver productos” es pobre. Mejor: “Si reescribes la misma checklist de permisos en cada revisión, usa las plantillas del área de productos”.

El tercer error es medir todos los clics como un único evento. Un clic de PDF, producto y formación deben distinguirse. Añade slug, tipo de CTA, destino y posición cuando sea posible.

El cuarto error es omitir revisión móvil. Una tabla o un bloque de código que desborda puede ocultar el CTA.

El quinto error es confiar en memoria antigua para términos de analytics. Search Console, GA4 y Cloudflare pueden cambiar nombres. Enlaza documentación oficial y no exageres lo que significa una métrica.

Qué debe decidir Claude Code

Claude Code sirve para encontrar enlaces faltantes, proponer textos de CTA, limpiar tablas, detectar code fences sin cerrar y alinear traducciones. No debe decidir objetivos de ingresos, prioridad de productos, capacidad de consultoría ni interpretación de conversiones reales.

Esto importa porque los pageviews pueden contar una historia cómoda. Un artículo con mucho tráfico puede atraer a lectores que solo quieren una respuesta gratuita. Un artículo menor sobre reglas internas, permisos o reviews puede valer más para consultoría. Mira la urgencia, no solo el volumen.

Siguiente paso

Si empiezas solo, usa el cheatsheet gratuito para tener cerca comandos y comprobaciones seguras de Claude Code. Para prompts reutilizables, material de setup y plantillas de revisión, visita /products/. Para content ops, medición, permisos, reglas de revisión y rollout de equipo, usa /training/.

Prueba práctica (実際に試した結果): la priorización fue mucho más clara al poner landing pages, consultas de búsqueda, CTAs del cuerpo, transiciones a productos y formularios de consulta en una sola tabla. La checklist y el script Node.js no prometen ingresos, pero encuentran brechas básicas antes de publicar.