# 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…

- Página: <https://www.datafirefly.com/es/documentation/dfaimetagen/>
- Idioma: es
- Actualizado el: 2026-07-01
- Otros idiomas: [fr](https://www.datafirefly.com/documentation/dfaimetagen/index.md), [en](https://www.datafirefly.com/en/documentation/dfaimetagen/index.md), [de](https://www.datafirefly.com/de/documentation/dfaimetagen/index.md), [it](https://www.datafirefly.com/it/documentation/dfaimetagen/index.md), [pl](https://www.datafirefly.com/pl/documentation/dfaimetagen/index.md), [pt](https://www.datafirefly.com/pt/documentation/dfaimetagen/index.md), [nl](https://www.datafirefly.com/nl/documentation/dfaimetagen/index.md)
- Índice: <https://www.datafirefly.com/es/documentation/llms.txt>

## 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](https://console.anthropic.com), [OpenAI](https://platform.openai.com) o [Mistral](https://console.mistral.ai)

## 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.

Las claves API se almacenan en la tabla Configuration de PrestaShop y nunca se exponen en el front-office. El módulo no incluye créditos IA: cada generación consume tu propia cuota con el proveedor (aproximadamente 0,0005 a 0,003 € por generación).

## 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**.

Empieza siempre con un trabajo limitado a 10–20 elementos para validar el tono y el formato de los textos generados, ajusta el patrón o la plantilla si es necesario, y luego relanza sin límite.

## 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).

El token protege el endpoint: no lo compartas. En caso de duda, regenéralo desde Ajustes (botón «Regenerar token») — recuerda actualizar después tu crontab.

## 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.