← Volver al catálogo

🔤 SEO Fix Alt Text (ALT en imágenes)

Archivo: agentes/marketing/seo-fix-alt-text.ts · Plist: _(ninguno propio; OJO: com.rifai.auto-alt-text ejecuta OTRO script, agentes/auto-alt-text.ts)_ · Horario: Manual (flag LIMIT)

Qué hace

Rellena el texto ALT de las imágenes de productos que no lo tienen, para mejorar SEO y accesibilidad. Genera el ALT a partir del título y la marca del producto y la posición de la imagen (la primera lleva "vista principal", el resto "imagen N"). No usa IA: es una plantilla determinista, rápida y barata. Procesa hasta LIMIT productos por pasada.

Cómo funciona

1. Carga .env; lee LIMIT (default 100).

2. Pagina productos activos (campos id/title/images/vendor/product_type).

3. Por producto e imagen sin ALT (o con ALT ≤5 chars): construye el ALT (<título> - <vendor> - vista principal para la 1ª, <título> - imagen N para el resto) y hace PUT /products/{id}/images/{img}. Throttle 200ms.

4. Cuenta productos procesados y ALTs añadidos.

Datos/APIs

  • Shopify Admin API (2024-10): products read, product images PUT.
  • Vars .env: SHOPIFY_STORE, SHOPIFY_ACCESS_TOKEN.

Cómo probarlo

cd /Users/user/rifai-agents && LIMIT=5 npx tsx agentes/marketing/seo-fix-alt-text.ts

Espera: nº de productos cargados, progreso cada 10, y "N ALT texts añadidos en M productos". Escribe ALT real en las imágenes (solo donde faltaba).

Si se rompe / recuperar

  • Sin plist propio. El plist com.rifai.auto-alt-text apunta a agentes/auto-alt-text.ts (versión distinta), no a este. Para programar este, crear su propio plist.
  • Idempotente: re-ejecutar no toca imágenes que ya tienen ALT >5 chars.
  • Logs: stdout (redirigir a /Users/user/rifai-agents/logs/seo-fix-alt-text.log).

Cómo replicarlo

  • Paginación de productos.
  • Plantilla de ALT determinista por posición de imagen.
  • PUT de imagen con throttle; idempotencia por longitud de ALT existente.