dfaimetagen — Generador IA masivo de meta titles, descriptions y ALT

Presentación

dfaimetagen genera en masa tus meta titles, meta descriptions y etiquetas ALT de imágenes con IA (Anthropic Claude, OpenAI GPT o Mistral) en PrestaShop 8 y 9. El módulo cubre 6 tipos de entidades (productos, categorías, páginas CMS, fabricantes, proveedores, imágenes de producto), aplica patrones CTR probados, produce variantes A/B, controla las longitudes SERP y rechaza duplicados mediante similitud de Jaccard.

Requisitos

• PrestaShop 8.0 a 9.x
• PHP 8.1, 8.2, 8.3 u 8.4
• Extensiones PHP: curl, json, iconv
• MySQL 5.7+ o MariaDB 10.3+
• Una clave API de al menos un proveedor: Anthropic, OpenAI o Mistral

Instalación

1. Descarga dfaimetagen.zip desde tu cuenta de cliente.
2. En el back-office de PrestaShop, ve a Módulos > Gestor de módulos > Subir un módulo.
3. Sube el ZIP y haz clic en Instalar.
4. El módulo crea 6 tablas en base de datos (prefijo df_aimeta_), instala 11 patrones CTR por defecto y genera un token CRON aleatorio.
5. Aparece una nueva pestaña AI Meta Generator bajo el menú Catálogo.

Configuración del proveedor IA

1. Ve a Catálogo > AI Meta Generator > Ajustes.
2. Selecciona tu proveedor activo: Anthropic, OpenAI o Mistral.
3. Pega tu clave API en el campo correspondiente.
4. Haz clic en el botón Test junto al campo para verificar la conectividad — debes recibir la respuesta «OK».
5. Los modelos por defecto son claude-sonnet-4-5, gpt-4o-mini y mistral-large-latest. Puedes cambiarlos si prefieres otro modelo del mismo proveedor.

Ajustes de generación

También en Ajustes puedes configurar:

• Límites de longitud — alineados por defecto con las recomendaciones Google SERP: meta title 35–60 caracteres, meta description 120–158, ALT 25–125. Si la IA se pasa, el texto se trunca limpiamente en una frontera de palabra.
• Variantes A/B por elemento — de 1 a 5 alternativas generadas por entidad y por idioma.
• Umbral anti-duplicación — porcentaje de similitud de Jaccard a partir del cual se rechaza una variante (85 % por defecto). La comparación es insensible a los acentos.
• Tamaño de lote — número de elementos procesados por tick AJAX o CRON (10 por defecto, hasta 100).
• Timeout HTTP — espera máxima de una respuesta del proveedor (60 s por defecto).
• Sobrescribir / Ignorar no vacíos — comportamiento por defecto ante meta ya rellenadas.

Lanzar una generación masiva

1. Ve a Catálogo > AI Meta Generator > Bulk Generation.
2. Entidad: productos, categorías, páginas CMS, fabricantes, proveedores o imágenes de producto.
3. Campo: meta title, meta description o ALT de imagen (los ALT se aplican a las imágenes de producto).
4. Patrón CTR: elige un patrón concreto o deja Auto para usar el patrón por defecto del campo.
5. Idiomas: selección múltiple — la generación se multiplica (elementos × idiomas).
6. Alcance: todas las entidades, por lista de IDs, o por filtro categoría / fabricante.
7. Límite: fija 10 o 20 para una prueba, 0 para procesarlo todo.
8. Haz clic en Crear trabajo.

Seguir y ejecutar los trabajos

La página Jobs lista todos los trabajos con su progreso, estadísticas (exitosos / fallidos / ignorados) y estado. Tres modos de ejecución:

• Ejecutar hasta completar (página de detalle del trabajo) — procesa los lotes en bucle vía AJAX con barra de progreso en directo. Mantén la pestaña abierta.
• Ejecutar un lote — procesa un solo lote y recarga la página.
• CRON — procesamiento en segundo plano, recomendado para catálogos grandes (ver más abajo).

Un trabajo puede cancelarse en curso, relanzarse desde el principio o eliminarse. El historial completo de cada generación (estado, tokens de entrada/salida, error eventual) se conserva en la pestaña Historial del detalle del trabajo.

Configurar el CRON

1. En Ajustes, sección CRON, copia la URL mostrada. Tiene la forma:
   https://tu-tienda.com/modules/dfaimetagen/cron.php?token=TU_TOKEN
2. Añádela a tu crontab del servidor, por ejemplo cada 5 minutos:
   */5 * * * * curl -s "https://tu-tienda.com/modules/dfaimetagen/cron.php?token=TU_TOKEN" >/dev/null
3. Cada pasada procesa hasta 5 lotes del trabajo pendiente más antiguo. Parámetros opcionales: &batch=20 (tamaño de lote) y &loops=10 (lotes por pasada).

Variantes A/B y activación

Cada generación produce el número de variantes configurado (1 a 5). La primera variante válida se escribe en la entidad y se marca como Activa. Las demás quedan en reserva en la página de detalle del trabajo:

• Haz clic en Activar junto a una variante para escribirla inmediatamente en la entidad.
• Las demás variantes del mismo triplete (entidad, campo, idioma) se desactivan automáticamente.
• El contador de caracteres de cada variante permite verificar la conformidad SERP de un vistazo.

Patrones CTR

Los 11 patrones preinstalados cubren tres familias:

• Meta titles: beneficio + año, lista numerada, USP entre corchetes, pregunta gancho, palabras de poder.
• Meta descriptions: apilado de beneficios, prueba social, problema-solución, CTA directo.
• ALT de imágenes: descriptivo, contextual.

Para crear tus propios patrones, ve a Catálogo > AI Meta Generator > Patterns. La plantilla acepta tokens dinámicos:

• {NAME}, {BRAND}, {CATEGORY}, {PRICE}, {YEAR}, {NUMBER}, {LANG_NAME} — rellenados automáticamente por el módulo;
• {BENEFIT}, {USP}, {CONTEXT} — rellenados por la IA en el momento de la generación.

Los patrones marcados como «sistema» vienen con el módulo y se conservan en las actualizaciones.

Plantillas de prompts avanzadas

Para un control total del comportamiento de la IA, crea plantillas en Catálogo > AI Meta Generator > Prompt Templates. Cada plantilla apunta a un triplete (entidad, campo, idioma — o todos los idiomas) y define:

• el system prompt — rol, tono, restricciones globales;
• el user prompt — con los tokens {NAME}, {BRAND}, {CATEGORY}, {DESCRIPTION}, {PRICE}, {PATTERN}, {LANG_NAME}, {MIN_LENGTH}, {MAX_LENGTH}, {AB_VARIANTS}, {EXISTING}.

Marca una plantilla como «por defecto» para que se aplique automáticamente a su triplete.

Anti-duplicación

Antes de conservar una variante, el módulo la compara con las variantes ya almacenadas:

1. Hash exacto (sha1 de la versión normalizada) — rechazo inmediato en caso de duplicado perfecto.
2. Similitud de Jaccard sobre los conjuntos de palabras normalizadas (minúsculas, sin acentos) — rechazo si la similitud supera el umbral configurado.

Una variante rechazada se regenera automáticamente por la IA (dentro del límite de reintentos del lote).

Panel de control

La página Dashboard agrega: número de trabajos (total, pendientes, completados), variantes generadas y activas, generaciones exitosas / fallidas, tokens consumidos (entrada + salida), últimos trabajos y últimas generaciones. Úsala para vigilar el presupuesto IA y detectar errores del proveedor.

Multi-tienda

El módulo lee y escribe los valores teniendo en cuenta el contexto de tienda cuando la tabla *_lang correspondiente posee una columna id_shop. Selecciona la tienda objetivo en el formulario de generación masiva si tu instalación es multi-tienda.

Solución de problemas

• «FAIL» en el test de conectividad — verifica la clave API, el saldo de créditos del proveedor, y que tu servidor permita conexiones HTTPS salientes (cURL) hacia api.anthropic.com, api.openai.com o api.mistral.ai.
• Trabajo bloqueado en «running» — relanza un lote manualmente desde la página de detalle, o espera la próxima pasada CRON. Un trabajo siempre puede cancelarse y relanzarse.
• Variantes vacías o truncadas — aumenta el timeout HTTP en Ajustes, o elige un modelo más rápido.
• 403 en la URL CRON — el token de la URL ya no coincide (quizás fue regenerado). Copia de nuevo la URL desde Ajustes.
• No se genera nada para algunas entidades — si «Ignorar no vacíos» está activo, las entidades ya rellenadas se saltan a propósito. Marca «Sobrescribir» para forzar.

Desinstalación

La desinstalación elimina las 6 tablas del módulo y sus claves de configuración. Las meta generadas y ya escritas en tus productos, categorías e imágenes se conservan: forman parte de tu catálogo.