Creación masiva de páginas SEO en WordPress

Proyecto: Motor de creación masiva de PÁGINAS SEO desde Google Sheets → WordPress (Divi) con exportación final a SQL importable

1) Qué necesito construir

Quiero un sistema automático que convierta una lista de keywords (en Google Sheets) en páginas publicadas de WordPress (post_type=page, NO posts), con contenido SEO único, diseño uniforme tipo Divi, y que entregue como salida un archivo .sql que al importarlo cree todas las páginas con sus metadatos y estructura.

Debe funcionar a gran escala: 500 / 5.000 / 10.000 keywords sin duplicados, sin slugs rotos y con registro de errores.

⸻

2) Fuente de datos: Google Sheets (estructura obligatoria)

Hoja de cálculo con estas columnas mínimas:
• A: keyword (entrada principal)
• B: status (PENDING / DONE / ERROR)
• C: slug_final
• D: url_final
• E: error_log
• F: created_at
• (Opcional) G: updated_at / retries / batch_id

Reglas:
• Solo se procesan filas en PENDING o sin status.
• Si está en DONE, jamás se vuelve a generar (idempotencia real).
• Si está en ERROR, debe poder reintentarse con control de reintentos.

⸻

3) Lógica del sistema (cola + lotes configurables)

El sistema debe incluir un job queue (cola) con batch configurable:
• Tamaños típicos: 50 / 100 / 200 (editable)
• Control de rate limits de OpenAI (backoff automático)
• Logs por keyword y por batch
• Recuperación tras cortes (si el proceso se cae, al reanudar continúa donde iba)

Resultado por fila:
• DONE → guarda slug_final y url_final
• ERROR → guarda error_log y no rompe el batch completo

⸻

4) Tipo de contenido WordPress (no negociable)

Cada keyword genera una página (WordPress Pages):
• post_type = page
• post_status = publish

No se admiten “posts”, “drafts” ni creación manual posterior.

⸻

5) Diseño visual (Divi): forma de implementación

Todas las páginas deben respetar un diseño base idéntico.

Opción A (preferida): Divi Library Layout
• Yo creo un layout en Divi Library con módulos “placeholders”
• El sistema reemplaza campos/módulos concretos (Hero, secciones, FAQ, CTA, etc.)
• Debe quedar 100% consistente en estilo

Opción B (aceptable): HTML estructurado compatible
• Generación de HTML limpio, bonito y consistente con el theme/Divi
• Manteniendo bloques equivalentes a secciones Divi

Mínimos visuales por página:
• Hero superior
• Bloques de valor con listas
• Secciones H2/H3
• Módulo “beneficios/servicios”
• CTA visible (botón o bloque destacado)
• FAQ (mínimo 3 preguntas)

⸻

6) Contenido SEO por keyword (OpenAI) – requisitos estrictos

Para cada keyword, el sistema debe producir contenido original (sin duplicación), con esta estructura:
• SEO Title: 60–65 caracteres aprox.
• Meta description: 140–160 caracteres aprox.
• H1 único (no repetido)
• Estructura H2/H3 semántica + términos relacionados (LSI)
• 1.200 a 1.800 palabras de texto útil (no “thin content”)
• FAQ: 3–5 preguntas mínimo (con respuestas completas)
• CTA optimizada
• Enlazado interno automático: 2–5 links por página
(usaré una lista/mapa de enlaces que aportaré o un CSV)

Prohibiciones:
• Contenido duplicado o casi idéntico
• Plantillas spintax / relleno / texto genérico repetido
• Párrafos “vacíos” sin intención de búsqueda real

⸻

7) Slug generator robusto (obligatorio, sin fallos)

Necesito que el sistema genere slugs perfectos para WordPress y hosting.

Reglas:
• minúsculas
• sin acentos: áéíóú → aeiou
• ñ → n
• sin símbolos raros (¿?¡!@#$%…)
• espacios → -
• múltiples guiones → 1 solo
• sin guion inicial/final
• recomendado: máximo 80 chars
• duplicados: sufijo incremental -2, -3…
• si queda vacío: fallback pagina-<id> o kw-<hash-corto>

Además:
• wp_posts.post_name debe quedar con el slug único final
• Guardar el slug final en Sheets (C) y la URL final en Sheets (D)

Ejemplos:
• “reparación audi en madrid” → reparacion-audi-en-madrid
• “taller año 2026: revisión” → taller-ano-2026-revision
• “cambio aceite bmw ñ” → cambio-aceite-bmw-n

⸻

8) Imágenes: solo reutilización (no generar nuevas)

No se crean imágenes con IA.

Se usará material existente:
• URLs fijas o IDs de media de WordPress (los aportaré)
• Por página:
• 1 imagen principal (hero)
• 2–4 imágenes dentro del contenido
• ALT dinámico: incluye keyword y variante natural
• Debe quedar integrado “bonito” con el layout

⸻

9) SEO técnico obligatorio

Cada página debe incorporar:
• slug limpio y único
• interlinking interno
• Schema FAQ en JSON-LD
• Integración de metadatos con RankMath o Yoast (el freelancer debe indicar cómo)
• compatible con import SQL sin romper serializaciones/meta

⸻

10) Salida final: archivo SQL importable (entregable crítico)

Debe entregarse un .sql que al importarlo cree:
1. wp_posts

• page publicada, título, contenido/layout

2. wp_postmeta

• metas necesarias para:
• Divi (layout/shortcodes/estructura)
• plugin SEO (RankMath o Yoast)
• schema FAQ (si se guarda como meta o dentro del contenido)
• imágenes (featured + refs internas, según método acordado)

Requisito: importación sin errores y páginas navegables al terminar.

⸻

11) Software del sistema (también entregable)

Además del SQL, necesito el sistema que lo genera. Puede ser:
• Python (preferido) o Node.js
• Alternativa: Make o n8n si el freelancer lo justifica y queda estable a 10.000

Obligatorio:
• cola de procesamiento + batch
• logs
• control de rate limit OpenAI
• reintentos
• idempotencia total
• detección de duplicados (keyword y slug)

⸻

12) Documentación paso a paso (obligatoria)

El freelancer debe entregar guía clara:
• cómo añadir keywords al Sheet
• cómo lanzar la generación por lotes
• cómo obtener/importar el .sql en WordPress
• cómo reintentar las filas en ERROR sin duplicar páginas DONE
• cómo cambiar batch size / enlaces internos / imágenes
• cómo estimar coste y consumo por lote (OpenAI)

⸻

13) Pruebas y fases (criterio de validación)

Necesito este pipeline de verificación:
1. Piloto (20 keywords)
Validar: layout, slugs, metas SEO, schema, imágenes, import SQL
2. Escalado (500 páginas)
Validar: performance, idempotencia, logs, duplicados, reintentos
3. Producción (10.000 páginas)
Validar: estabilidad total y coste controlado

⸻

14) Antes de empezar: puntos que el freelancer debe responder

El freelancer debe explicar con detalle:
1. Cómo construirá el SQL y qué campos/meta exactos toca en wp_posts y wp_postmeta
2. Cómo aplicará Divi: Library Layout (ideal) vs HTML compatible (alternativa)
3. Cómo garantizará el escalado a 10.000 (cola, lotes, recuperación, reintentos)
4. Cómo implementará SEO (RankMath o Yoast) + JSON-LD de FAQ

⸻

15) Condiciones de aceptación (lo que debe cumplirse sí o sí)

Se considera “entregado” cuando:
• cargo 500–10.000 keywords en Sheets
• el sistema genera 1 página por keyword sin duplicados
• importo el .sql y se crean páginas publicadas (page)
• slugs correctos, únicos y sin caracteres inválidos
• diseño consistente tipo Divi
• SEO completo (title, meta, headings, schema FAQ, interlinks, ALT)
• errores registrados y reintento posible sin repetir DONE
• el programa puede reutilizarse ilimitadamente (no “one-shot”)

⸻

Nota final

Quiero que el texto, el diseño y las estructuras generadas sean de calidad, orientadas a posicionar (no contenido de relleno), y que el sistema sea “industrial”: estable, repetible y auditable.

⸻