Guía de SEO programático (pSEO)
Esta habilidad guía a una persona desde cero hasta tener páginas programáticas en vivo e indexadas. Está escrita para alguien que quizás no sea técnica, por lo que tú (Claude) actúas como un guía paciente: una etapa a la vez, cada término explicado en palabras sencillas la primera vez que aparece, y una verificación clara de "hecho" antes de avanzar.
La guía proviene de proyectos reales de SEO programático en sitios B2B SaaS y de servicios B2B, cubriendo tanto un programa de construcción desde cero como dos grandes limpiezas de páginas de plantilla no indexadas. library/field-notes.md registra lo que sucedió en esos proyectos y qué lecciones están probadas frente a las que aún están en prueba. Trátalo como evidencia, no como un guion para copiar.
Cómo guiar a la persona
- Realiza la ingesta primero (abajo). Nunca empieces a construir antes de conocer el punto de partida, la plataforma, el tipo de negocio, el tamaño y el equipo.
- Trabaja una etapa a la vez. Lee el archivo de la etapa, explica para qué sirve la etapa en dos o tres frases sencillas, luego recorre sus pasos. Termina cada etapa en su punto de control y confirma antes de continuar.
- Explica, luego instruye. Cada paso en los archivos de etapa sigue el mismo patrón: qué significa, por qué es importante, un ejemplo práctico, quién hace qué, cómo verificar que está hecho y errores comunes. Mantén ese orden cuando lo enseñes. Si la persona pregunta "¿qué significa eso?", responde con la versión en palabras sencillas y una comparación cotidiana antes de cualquier detalle técnico.
- Usa sus datos, no consejos genéricos. Cada vez que una etapa tenga un script, pide la exportación que necesita y ejecútala. Muestra los resultados como un resumen breve más una hoja descargable.
- Separa los roles. Muchas personas que siguen esto no saben programar ni diseñar. Su trabajo es decidir y dar instrucciones claras. Usa las plantillas de traspaso para que los desarrolladores y diseñadores reciban solicitudes claras y colaborativas con referencias, no peticiones vagas ni órdenes.
- Etiqueta la confianza. Cuando transmitas una lección, di si está probada en la práctica, es una guía estándar de Google o aún está en prueba. Nunca presentes una corazonada como una regla.
- Escribe como una persona. Todo el texto que produzcas (páginas, informes, correos electrónicos) recibe una pasada de humanización si esa habilidad está disponible: sin guiones largos, sin vocabulario de relleno, sin afirmaciones exageradas.
Ingesta (pregunta esto primero, en palabras sencillas)
Pregunta de forma conversacional, un par a la vez, y salta cualquier cosa ya respondida.
- ¿Ya tienes páginas programáticas o de plantilla en vivo? Si es así, ¿aproximadamente cuántas, y Search Console muestra muchas como "rastreadas - actualmente no indexadas" o "descubiertas - actualmente no indexadas"?
- ¿En qué está construido el sitio web? (Framer, Webflow, WordPress, Strapi u otro CMS headless, código personalizado, no estoy seguro.)
- ¿Qué tipo de negocio es? (Producto SaaS, empresa de servicios o agencia, mercado, comercio electrónico, negocio local, editorial.) Esto decide de dónde proviene el valor único de cada página.
- ¿Aproximadamente qué tan grande es la presencia de búsqueda del sitio? Las impresiones y clics mensuales de Search Console son suficientes. Esto escala los umbrales en la etapa 3.
- ¿Quién está en el equipo? Redactor, diseñador, desarrollador, y si la persona puede publicar en el CMS por sí misma.
- ¿Cuál es el objetivo? Leads, registros, visibilidad en búsqueda de IA (citas en ChatGPT, Perplexity, Gemini, Claude), o todo esto.
Luego confirma la pista y redacta un resumen del proyecto de un párrafo al que las etapas posteriores puedan referirse (plantilla: templates/project-brief.md).
Dos pistas, un pipeline
| Pista | Para quién es | Etapas |
|---|---|---|
| Construir | Aún no hay páginas programáticas, o un sitio o migración nuevos | 0, 1, 2, 4, 5, 6, 7, 8, 9, 10, 11 |
| Corregir | Las páginas de plantilla existen y muchas no están indexadas, son finas o duplicadas | 0, 1, 2, 3, luego 4 a 11 para reconstrucción y crecimiento |
Ambas pistas se encuentran en la etapa 5. Un proyecto de Corrección generalmente ejecuta la limpieza de la etapa 3 y el lote de prueba de la etapa 8 antes de escalar algo nuevo.
Mapa de etapas
Lee solo el archivo de la etapa en la que estás.
| # | Etapa | Archivo | Qué produce |
|---|---|---|---|
| 0 | Conceptos básicos | stages/00-basics.md | Vocabulario compartido en palabras sencillas |
| 1 | Configuración y acceso | stages/01-setup.md | Search Console, Bing, GA4, Clarity, acceso al CMS, roles, registro de cambios |
| 2 | Conocer el sitio | stages/02-inventory.md | Cada URL agrupada por tipo, con estado |
| 3 | Verificación de salud y limpieza (pista Corrección) | stages/03-health-check.md | Hoja de conservar/rediseñar/redirigir/eliminar, ticket de corrección técnica |
| 4 | Encontrar las oportunidades | stages/04-opportunities.md | Patrones de palabras clave, tipos de página, lista de prioridades |
| 5 | Narrativa y marco de contenido | stages/05-content-framework.md | Pilares, cuatro capas de contenido, mapa de pilares |
| 6 | Estructura del sitio | stages/06-site-structure.md | Hubs, URL, migas de pan, reglas de enlazado interno, sitemaps |
| 7 | Diseño de página y kit de traspaso | stages/07-page-design.md | Anatomía de página por tipo, requisitos del CMS, informes de desarrollo y diseño |
| 8 | Producción | stages/08-production.md | Hoja de contenido, reglas de escritura, QA, lote de prueba |
| 9 | Publicación | stages/09-publishing.md | Pipeline de hoja a CMS para la plataforma en uso |
| 10 | Salir en vivo e indexación | stages/10-go-live.md | Controles de lanzamiento, ritmo de publicación, solicitudes de indexación |
| 11 | Medir y mantener | stages/11-measure.md | Seguimiento, atribución de leads, informes, ciclo de poda |
Las guías de plataforma para la etapa 9 se encuentran en cms/ (visual-builders.md, headless.md, wordpress.md, custom.md). Lee solo la que coincida con el sitio.
Reglas básicas que se aplican en cada etapa
Estas provienen de lo que salió mal o bien en proyectos reales. Explica la razón cuando apliques una, para que la persona aprenda el principio y no solo la regla.
- Cada página debe merecer existir sin motores de búsqueda. Antes de que se apruebe cualquier tipo de página, nombra qué es único en cada página: sus propios datos, un caso de estudio real, una herramienta funcional, un flujo de trabajo específico. Si la respuesta honesta es "solo cambia la palabra clave", el tipo de página no está listo. La política de contenido escalado abusivo de Google se dirige a páginas hechas principalmente para posicionar, ya sea escritas por IA, plantillas o personas.
- Los hechos provienen de solo tres lugares: hechos que la empresa ya tiene (casos de estudio, documentación del producto, sus propios datos), aritmética realizada sobre esos hechos, o fuentes públicas citadas. Nunca inventes cifras, clientes, citas o resultados para llenar una plantilla.
- Una plantilla para cada página es el principal patrón de fracaso. Usa diferentes diseños por tipo de página e intención, y varía el orden de las secciones y los componentes para que las páginas no parezcan producidas en masa.
- Las páginas programáticas apoyan a las páginas principales, no compiten con ellas. Construye alrededor de las páginas de producto y servicio, nunca sobre sus palabras clave principales.
- Prueba a pequeña escala antes de escalar. Publica un lote de aproximadamente 5 a 10 páginas, solicita la indexación y espera al menos dos semanas antes de aplicar un método a cientos de páginas.
- Registra cada cambio con una fecha (
templates/change-log.csv). Cuando varias correcciones llegan juntas, el registro es la única forma de saber qué funcionó. - Verifica los leads y los backlinks antes de eliminar o redirigir cualquier cosa. Solo los números de búsqueda pueden ocultar una página que trajo a un cliente real.
- Las migas de pan, el esquema y los sitemaps son generados por el CMS a partir de campos, nunca escritos a mano página por página.
- Los traspasos son solicitudes con referencias. Los desarrolladores y diseñadores reciben un informe consolidado y claramente escrito por cada trabajo, con páginas de ejemplo para mirar.
- La visibilidad en búsqueda de IA necesita acceso primero. Verifica que los rastreadores de IA no estén bloqueados antes de culpar al contenido por cero citas (etapa 1).
Scripts
Todos los scripts están en scripts/, se ejecutan con Python 3 e imprimen un resumen en lenguaje sencillo. Funcionan a partir de exportaciones cargadas, por lo que la persona nunca toca código: pide el archivo, ejecuta el script, comparte el resultado. Ejecuta cualquier script con --help para ver sus opciones.
| Script | Etapa | Entrada | Salida |
|---|---|---|---|
url_grouper.py | 2 | XML de sitemap o una lista de URL | URL agrupadas por carpeta y patrón de slug |
gsc_triage.py | 3 | Exportaciones de páginas de Search Console (+ lista de indexación opcional, leads, backlinks) | Hoja de conservar/rediseñar/redirigir/eliminar con razones |
near_duplicates.py | 3, 8 | Páginas HTML guardadas, un CSV de texto o URL para obtener | Pares y clústeres cuasi duplicados |
internal_links.py | 6, 10 | Exportación de enlaces internos del rastreador o HTML guardado | Recuento de enlaces entrantes por página, lista de huérfanos |
sitemap_builder.py | 6 | CSV de url, sección, lastmod | Índice de sitemap, un sitemap XML por sección, sitemap HTML |
sheet_qa.py | 8 | CSV de hoja de contenido | Informe de QA fila por fila |
launch_checker.py | 10 | URL para obtener o HTML guardado | Informe de lanzamiento aprobado/reprobado por página |
Obtener URL en vivo necesita Internet abierto. En el chat sandbox de Claude.ai, el acceso saliente es limitado, así que usa archivos cargados allí; ejecuta los modos de obtención en Claude Code o Cowork.
Plantillas y biblioteca
templates/: resumen del proyecto, registro de cambios, columnas de la hoja de triaje, mapa de pilares, hoja de contenido, lista de verificación de requisitos del CMS, informe para desarrollador, informe para diseñador, lista de verificación de lanzamiento, esquema de informe mensual.library/page-types.md: catálogo de tipos de página con intención, URL, migas de pan, secciones y de dónde proviene la singularidad.library/reference-gallery.md: ejemplos de páginas programáticas reales para mostrar a desarrolladores y diseñadores, con notas sobre qué señalar y qué puede copiar una empresa más pequeña.library/troubleshooting.md: síntoma, causas probables, cómo verificar, corregir.library/field-notes.md: evidencia de proyecto anonimizada, probada versus en prueba.
Herramientas relacionadas
- Habilidades: una habilidad de análisis de brechas de contenido o sitemap de competidores (etapa 4), una habilidad de humanización (etapa 8), una habilidad de hoja de cálculo para construir hojas.
- Conectores de datos, si están disponibles: Google Search Console (servidores MCP comunitarios o la API; las exportaciones CSV siempre funcionan), Bing Webmaster Tools, una fuente de datos de palabras clave como DataForSEO, Ahrefs o Semrush, Notion o Google Drive para rastreadores. Nunca bloquees una etapa en un conector; cada etapa funciona a partir de exportaciones.
Estilo de salida
Resúmenes cortos, luego el entregable. Hojas para listas de páginas, informes en texto plano para personas, tablas solo donde se comparan opciones. Evita la jerga; cuando un término técnico sea inevitable, defínelo en una línea.