Manual de pSEO Wizard 🧙♂️
Bienvenido a la guía técnica completa de pSEO Wizard. Esta documentación resume semanas de decisiones arquitectónicas en un solo flujo de trabajo para ayudarte a lanzar más de 1,000 páginas de forma segura.
💡 Quick Tip: Usa la navegación lateral para saltar entre secciones, o desplázate por la guía completa.
🚀 Parte 1: El Flujo de Trabajo Principal
Antes de sumergirte en el código, entiende cómo funciona la "Fábrica":
1. Configuración del Proyecto
Selecciona tu Idioma Objetivo cuidadosamente. Esto establece la bandera locale en la salida JSON.
2. Lógica de Patrones
Usa variables como {City} o {Service}. Mantén los patrones cortos para mejor SEO.
3. Generación de Datos
Usamos lógica de Producto Cartesiano. 10 Servicios × 10 Ciudades = 100 Páginas.
🛡️ 4. La Alerta de "Seguridad"
En el Paso 4, te advertimos que publiques bajo /blog. Publicar contenido programático en el dominio raíz es una forma rápida de ser desindexado por Google.
👨💻 Parte 2: Integración para Desarrolladores
El Estándar de Oro
📘 Note: La siguiente guía recomienda la mejor arquitectura para tu aplicación Next.js para manejar nuestros archivos exportados.
La Estrategia "Raw HTML"
Dado que pSEO Wizard genera páginas HTML completas y estilizadas, envolverlas en un Layout React estándar causa conflictos de estilos.
✅ La Solución: Usamos un Route Handler de Next.js para servir el HTML en crudo.
// src/app/[locale]/blog/[slug]/route.ts
export async function GET(request, { params }) {
const post = getPostBySlug(params.slug);
if (post.locale !== params.locale) return 404;
const finalHtml = `<head><script src="https://cdn.tailwindcss.com"></script></head>
<body>${post.body_html}</body>`;
return new Response(finalHtml, { headers: { 'Content-Type': 'text/html' } });
}El Sistema JSON Drop-in
Olvida las migraciones de base de datos. Construimos un sistema basado en Agregación del Sistema de Archivos.
- 📁Directorio:
src/app/data/posts-json/ - 🔄Flujo de trabajo: Simplemente "Arrastra y Suelta" tus archivos JSON exportados aquí.
- ✨Magia: El agregador blog-posts.ts lee automáticamente todos los archivos y los publica instantáneamente.
Sitemap Dinámico "Inteligente"
Tu sitemap.ts es consciente del locale. Escanea los archivos JSON y genera URLs específicas por locale.
Esto previene penalizaciones por "Contenido Duplicado" de Google.
🏛️ Parte 3: Arquitectura Técnica
¿Por qué Cryptomus?
Elegimos Cryptomus sobre Stripe por razones estratégicas específicas:
🌍 Alcance Global
Acepta pagos en cripto desde cualquier lugar (resolviendo restricciones bancarias regionales y habilitando acceso global).
⚡ Desbloqueo Instantáneo
El sistema Webhook desbloquea el botón "Exportar" instantáneamente tras la confirmación de la transacción.
Arquitectura Anti-Spam
Nuestro sistema está diseñado para proteger la autoridad de tu dominio:
- Todo el contenido programático vive bajo el subdirectorio /blog
- Cada página tiene contenido único generado por IA (sin contenido delgado)
- Los enlaces internos siguen las mejores prácticas SEO
- Atributos lang y dir correctos para contenido multilingüe
🚑 Parte 4: Solución de Problemas
Problemas comunes y sus soluciones:
❌ Pantalla Blanca / Texto Sin Estilo
Causa: El CDN de Tailwind está bloqueado.
Solución: Verifica los headers CSP en next.config.js. Permite cdn.tailwindcss.com.
⚠️ Enlaces Internos Rotos (/og/ o //)
Causa: Artefactos de generación de IA.
Solución: Asegúrate de que tu route.ts tenga el limpiador "Smart Regex".
🔍 404 en Posts Generados
Causa: Desajuste de Slug (a menudo codificación árabe).
Solución: Asegúrate de usar decodeURIComponent(slug) en tu route handler.
✅ Botones CTA Van a /blog
Causa: Regex reemplaza todos los enlaces con la ruta blog.
Solución: Usa patrones separados para enlaces de página principal vs enlaces de blog.
Hecho con ❤️ por el Equipo pSEO Wizard
Última actualización: Diciembre 2024