Guía de Publicación CMS para Lápices Lectores: Configuración de Botble y agon-theme-v2 para SEO

Audiencia: Equipos web, especialistas en SEO y responsables de contenido que publican contenido en SmartReadingPen.com (o cualquier stack de Botble + agon-theme-v2). Esta guía cubre la configuración del CMS, la configuración de SEO, la plantilla de entradas del blog, el marcado de schema, la generación del sitemap y un calendario de publicación de 30 días para el programa de SEO B2B de 1,000 artículos.

Ejecutamos SmartReadingPen.com en Botble CMS con la plantilla agon-theme-v2, un stack que gestiona contenido multilingüe, entradas de blog, páginas de producto y datos estructurados correctamente, pero solo si se configura correctamente. La configuración predeterminada de fábrica es funcional, pero desaprovecha aproximadamente el 40% de la oportunidad de SEO. Esta guía es la configuración que utilizamos para publicar 1,000 artículos optimizados para SEO sin comprometer los Core Web Vitals ni la internacionalización.

Cubre los ajustes de Botble, las personalizaciones de agon-theme-v2, la plantilla por entrada (frontmatter + estructura del cuerpo), el marcado de schema (FAQ, Product, Organization), la configuración del sitemap y robots, y una cadencia de publicación de 30 días que se ajusta al ancho de banda de un equipo de contenido pequeño. Incluye un diagrama de flujo de publicación, una tabla de objetivos de Core Web Vitals, un grafo de enlaces internos y el FAQ de 5 preguntas que pegamos en cada inicio de contenido. Todos los enlaces son internos.

1. Por qué la configuración del CMS importa para el SEO B2B

Un programa de SEO B2B de 1,000 artículos no se trata solo de escribir 1,000 artículos. Se trata de configurar el CMS para que cada artículo se publique con los metadatos correctos, los datos estructurados correctos, los enlaces internos correctos, las etiquetas canónicas correctas y los Core Web Vitals correctos. Un CMS mal configurado publicará 1,000 artículos que compiten entre sí, canibalizan palabras clave y cargan lentamente — desperdiciando toda la inversión en contenido.

A continuación se muestra lo que medimos cuando reconfiguramos nuestro CMS en el Q1 2026 frente a la configuración predeterminada.

La optimización tomó 3 semanas del tiempo del equipo web y ahora se amortiza cada trimestre en volumen de leads. A continuación se muestra la configuración que implementamos.

2. Ajustes principales de Botble CMS

Los cuatro bloques de configuración son General, SEO, Blog, Rendimiento. A continuación se muestra la configuración que implementamos.

3. Personalizaciones de agon-theme-v2

La plantilla agon-theme-v2 es responsiva y optimizada para SEO de fábrica, pero se requieren cinco personalizaciones para que alcance nuestro estándar.

3.1 Navegación del encabezado

Inicio
Productos  →  B1 / B2 / F8 / K7 / KF1 / L5 / P2 / Q6 / Q8 / T2 / Y6
Guía de compra
Técnico
Aplicación
Industria
Acerca de
Contacto

3.2 Plantilla de publicación del blog

La plantilla de publicación del blog de agon-theme-v2 requiere una pequeña edición para admitir el frontmatter que utilizamos. El archivo de plantilla es platform/themes/agon-theme-v2/templates/blog.blade.php. Los campos requeridos son:

- title
- slug
- category (debe coincidir con una de las 5 categorías)
- primary_keyword
- secondary_keywords (array)
- meta_title (≤ 60 caracteres)
- meta_description (≤ 160 caracteres)
- word_count_target (valor predeterminado 3000)
- publish_date
- author
- reading_time
- featured_image (ruta bajo /images/)

3.3 Marcado de Schema

Inyectamos tres tipos de schema a través del parcial head del tema:

3.4 Sugerencia automática de enlaces internos

Activamos el módulo "Artículos relacionados" al final de cada publicación del blog. El módulo utiliza una coincidencia sencilla de categoría y etiqueta para sugerir 4 enlaces internos. También inyectamos un bloque contextual de "Guías relacionadas" en el rail derecho en escritorio y al final del artículo en móvil.

3.5 Canal de optimización de imágenes

Cada imagen cargada pasa por un canal de optimización:

1. Redimensionar a un ancho máximo de 1.600 px (conserva la calidad retina sin aumentar el peso)
2. Convertir a WebP con respaldo JPEG
3. Carga diferida de todas las imágenes excepto la imagen destacada
4. Generar srcset para 1x, 1.5x, 2x, 3x
5. Añadir ancho y alto explícitos para evitar CLS

4. La plantilla de publicación del blog (Frontmatter + Cuerpo)

Cada artículo en SmartReadingPen.com sigue una única plantilla. La consistencia es el mayor predictor individual del rendimiento SEO a escala.

---
title: "..."          # 50–60 caracteres, palabra clave principal cerca del inicio
slug: BG-XXX-...      # categoría + tema
category: BUYING-GUIDE
primary_keyword: "..."  # 2–4 palabras
secondary_keywords:
  - ...
  - ...
meta_title: "..."      # ≤ 60 caracteres
meta_description: "..." # ≤ 160 caracteres
word_count_target: 3000
publish_date: YYYY-MM-DD
author: "..."
reading_time: "12 min"
featured_image: /images/... # ≥ 1200×630 px
---

![Featured image alt text](/images/...)

# Título (H1, coincide con meta_title)

> Bloque de cita de la audiencia en cursiva — 2 oraciones, nombra a la audiencia.

[Opening paragraph, 80–120 words, hooks the reader.]

## 1. Primera sección H2
...

## 2. Segunda sección H2
...

[... 6–8 secciones H2 en total ...]

## Preguntas frecuentes (5 preguntas con JSON-LD)


## Lectura relacionada
- [Internal link 1]
- [Internal link 2]
- [Internal link 3]
- [Internal link 4]

[CTA paragraph at end]

5. Estrategia de enlaces internos

Los enlaces internos son la forma en que 1.000 artículos se convierten en una fortaleza en lugar de un pantano. La estrategia a continuación es la que implementamos.

El grafo de enlaces se construye y verifica mediante un rastreador semanal. Cualquier artículo con menos de 6 enlaces internos se marca para revisión.

6. Objetivos de Core Web Vitals

Mantenemos el sitio en los siguientes objetivos. Cualquier valor por debajo de "Bueno" activa una alerta automática de velocidad de página.

El stack agon-theme-v2 mantiene el LCP en 1,6 s en móvil y 1,1 s en escritorio con el pipeline de optimización anterior. El CLS se mantiene consistentemente en 0,00 porque definimos dimensiones explícitas en cada imagen e inserción.

7. Configuración de Sitemap y Robots

Elementos esenciales de Robots.txt:

User-agent: *
Allow: /
Disallow: /admin/
Disallow: /search
Disallow: /cart
Disallow: /checkout
Sitemap: https://smartreadingpen.com/sitemap.xml

Elementos esenciales de llms.txt:

User-agent: GPTBot
Allow: /

User-agent: Claude-Web
Allow: /

User-agent: PerplexityBot
Allow: /

User-agent: CCBot
Allow: /

Permitimos explícitamente los rastreadores LLM porque el flujo de trabajo de investigación B2B se canaliza cada vez más a través de respuestas mediadas por LLM. Bloquearlos nos excluye de una proporción creciente de la investigación de compradores cualificados.

8. Calendario de publicación a 30 días

El calendario siguiente permite 60 artículos por mes con un equipo de contenido de 2 personas (1 redactor, 1 editor). Para nuestro programa de 1.000 artículos, ejecutamos la misma cadencia 17 veces.

Cada lote sigue el mismo flujo:

El filtro de QA es una verificación de 12 puntos (consulte Reading Pen CMS QA en las preguntas frecuentes). Todo lo que no supere la QA regresa a edición antes de publicarse.

9. Lista de verificación QA del CMS (por artículo)

[ ] 1. Título ≤ 60 caracteres y contiene la palabra clave principal
[ ] 2. Meta descripción de 120–160 caracteres, contiene la palabra clave principal
[ ] 3. El slug coincide con la convención BG-XXX / PR-XXX / TC-XXX / AP-XXX / IN-XXX
[ ] 4. Imagen destacada ≥ 1200×630 px, texto alternativo definido, lista para lazy-load
[ ] 5. Recuento de palabras entre 2.800 y 3.500 (objetivo 3.000)
[ ] 6. 6–8 secciones H2, cada una con palabra clave principal o secundaria en el encabezado
[ ] 7. ≥ 3 tablas de datos, ≥ 2 gráficos SVG, ≥ 8 puntos de datos numéricos
[ ] 8. ≥ 6 enlaces internos, 0 enlaces externos
[ ] 9. ≥ 2 ubicaciones de CTA (1 en línea + 1 en el pie)
[ ] 10. Sección de preguntas frecuentes con 5 preguntas y script JSON-LD
[ ] 11. Sección de artículos relacionados con 4 enlaces internos
[ ] 12. Tiempo de lectura calculado correctamente

La lista de verificación de QA se aplica mediante un hook de pre-publicación en Botble. Los artículos que no superen cualquier verificación se devuelven al editor con un informe de la lista de verificación.

10. Mapa de enlaces internos para la documentación de tu CMS

Cuando publiques esta guía, intervinúlala con el resto de tu contenido B2B:

• Reading Pen Localization
• Reading Pen Brand Building
• Reading Pen Marketing for Schools
• Reading Pen Subscription Box Model
• Reading Pen Data Privacy Compliance

11. Las 5 preguntas frecuentes del CMS

{
  "@context": "https://schema.org",
  "@type": "FAQPage",
  "mainEntity": [
    {
      "@type": "Question",
      "name": "¿Cuál es la configuración recomendada del CMS Botble para un sitio B2B de lápices lectores?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "La configuración recomendada abarca cuatro áreas: General (título del sitio, descripción, imagen OG predeterminada, correo del administrador), SEO (separador de guion largo, canonical autorreferenciado, valores predeterminados de schema), Blog (autor predeterminado, 5 categorías, imagen destacada obligatoria) y Rendimiento (caché con TTL de 1 hora, lazy-load de imágenes, minificar HTML/CSS/JS, CDN). La plantilla agon-theme-v2 incluye valores razonables por defecto, pero se beneficia de cinco personalizaciones: navegación del encabezado, campos de la plantilla de entradas del blog, inyección de schema, sugerencia automática de enlaces internos y optimización de imágenes."
      }
    },
    {
      "@type": "Question",
      "name": "¿Cómo evito la canibalización de palabras clave en 1.000 artículos?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "Mantén una sola palabra clave principal por artículo, aplica slugs únicos (convenciones BG-XXX, PR-XXX, TC-XXX, AP-XXX, IN-XXX) y ejecuta un crawler semanal que marque cualquier par de artículos que apunten a la misma palabra clave principal. Usa palabras clave secundarias para diferenciarlos; un programa de 1.000 artículos debe apuntar al menos a 800 palabras clave principales distintas."
      }
    },
    {
      "@type": "Question",
      "name": "¿Debería permitir que crawlers de LLM como GPTBot indexen mi contenido?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "Sí. La investigación de compradores B2B recurre cada vez más a respuestas mediadas por LLM. Bloquear los crawlers de LLM te excluye de una proporción creciente de investigación cualificada. Permitimos explícitamente GPTBot, Claude-Web, PerplexityBot y CCBot en /llms.txt. Esta es una jugada de visibilidad de marca a largo plazo: cuanto más aparezca tu contenido en respuestas de LLM, más inbound obtendrás de compradores que usan estas herramientas."
      }
    },
    {
      "@type": "Question",
      "name": "¿Cómo mantengo Core Web Vitals en el rango 'Bueno' a medida que publico 1.000 artículos?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "Tres reglas: (1) cada imagen debe tener atributos explícitos de ancho y alto para evitar CLS, (2) cada artículo debe hacer lazy-load de todas las imágenes excepto la imagen destacada, (3) cada embed (SVG, gráfico) debe declarar su tamaño por adelantado. Con estas reglas y nuestra configuración de CDN y caché, mantenemos LCP en 1.6 s en móvil y 1.1 s en escritorio en todo el corpus de 1.000 artículos."
      }
    },
    {
      "@type": "Question",
      "name": "¿Cuántos enlaces internos debe tener cada artículo?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "Al menos 6 enlaces internos por artículo, y cada artículo debe estar enlazado desde al menos otros 3 artículos. El modelo hub-and-spoke funciona mejor: cada categoría tiene una página hub que enlaza a todos los artículos de la categoría, y cada artículo enlaza de vuelta a su hub más 5 artículos temáticos hermanos. Un crawler semanal marca cualquier artículo que caiga por debajo del umbral de 6 enlaces."
      }
    }
  ]
}

12. Lecturas relacionadas en el blog Smart Reading Pen

• Reading Pen Localization
• Reading Pen Brand Building
• Reading Pen Marketing for Schools
• Reading Pen Subscription Box Model
• Reading Pen Data Privacy Compliance