# Instrucciones SEO para la rutina de Claude

Este archivo le dice a Claude qué hacer en cada ejecución de la rutina. Modifícalo con total libertad: tono de la marca, campos que se deben reescribir, reglas propias de tu tienda. Las secciones marcadas «A adaptar» son las que cambiarás con más frecuencia.

## Regla absoluta: un solo contenido por ejecución

En cada ejecución tratas **un solo contenido** y te detienes. Aunque sobre tiempo y aunque haya otras filas pendientes. La siguiente ejecución se encargará del siguiente.

## El archivo de seguimiento

El archivo `suivi-seo.csv`, en la raíz del repositorio, lista los contenidos que hay que optimizar. Columnas:

| Columna | Contenido |
| --- | --- |
| `Type` | `product`, `collection`, `page` o `article` |
| `Handle` | el handle de Shopify del contenido |
| `Title` | el título actual, como referencia |
| `Optimized` | `YES` una vez enviada la propuesta a Vetta; si no, `NO` |
| `OptimizedAt` | fecha y hora del envío (ISO 8601, por ejemplo `2026-09-25T14:00:00Z`) |
| `WorkingNow` | `YES` mientras una ejecución trabaja en la fila; si no, `NO` |
| `WorkingSince` | fecha y hora en que `WorkingNow` pasó a `YES` |
| `VettaStatus` | estado de la propuesta en Vetta (`pending`, `approved`, `changes_requested`, `rejected`) |
| `VettaProposalUrl` | enlace de validación de la propuesta en Vetta |

## Desarrollo de una ejecución

1. Lee `suivi-seo.csv`.
2. Si una fila tiene `WorkingNow = YES` desde hace menos de 2 horas, hay otra ejecución en curso: detente sin modificar nada. Si lleva más de 2 horas, considérala abandonada y vuelve a poner `WorkingNow` en `NO`.
3. Elige la primera fila con `Optimized = NO`. Si no hay ninguna, detente e indica que todo está tratado.
4. Pon esa fila en `WorkingNow = YES`, rellena `WorkingSince` y haz enseguida un commit y un push (mensaje: `seo: inicio <handle>`).
5. Con el conector de Vetta, llama a `get_shop_context` para conocer la tienda y sus idiomas. Después localiza el contenido con `list_contents` (parámetros `type` y `query` = el handle) para obtener su identificador y léelo con `get_content`.
6. Redacta la nueva versión siguiendo las reglas de abajo. Apóyate en las recomendaciones SEO (`seo`) y, si Search Console está conectada, en las búsquedas cercanas a la primera página (`gsc.opportunities`) que devuelve `get_content`.
7. Envíala con `propose_version`. Nunca publicas: una persona revisará la propuesta en Vetta. Si la puntuación SEO devuelta muestra un problema que puedes corregir, envía una nueva propuesta: sustituye a la anterior.
8. Actualiza la fila: `Optimized = YES`, `OptimizedAt`, `WorkingNow = NO`, `WorkingSince` vacío, `VettaStatus = pending`, `VettaProposalUrl` = el enlace de validación que devuelve `propose_version`.
9. Haz un commit y un push (mensaje: `seo: <handle> propuesto en Vetta`) y detente.

Si falla algún paso (contenido no encontrado, error del conector), vuelve a poner `WorkingNow` en `NO`, deja `Optimized` en `NO`, escribe el error en `VettaStatus` y sube el archivo. No pases a otra fila.

## Qué hay que optimizar (A adaptar)

- **Título SEO**: de 50 a 60 caracteres, la palabra clave principal al principio y el nombre de la marca al final si cabe.
- **Meta descripción**: de 140 a 155 caracteres, con un beneficio concreto y una invitación a hacer clic.
- **Descripción**: estructurada con subtítulos y párrafos cortos, con la palabra clave principal en las 100 primeras palabras, sin relleno de palabras clave.
- **Handle**: no lo cambies, salvo que sea ilegible (por ejemplo `copia-de-producto-2`). En ese caso, propón un handle corto, en minúsculas y con guiones.
- **Texto alternativo de las imágenes**: describe en una frase lo que muestra la imagen.

## Reglas de redacción (A adaptar)

- Idioma: español. Trato de usted.
- Tono: [describe el tono de tu marca, por ejemplo «experto pero cercano, sin superlativos»].
- Nunca inventes características, materiales, medidas, certificaciones ni cifras. Usa solo lo que ya figura en el contenido o en la tienda. Si falta un dato importante, indícalo en tu informe.
- Conserva los enlaces internos existentes.
- Evita las fórmulas vacías («de calidad superior», «imprescindible», «descubre nuestra selección»).

## Informe al final de la ejecución

Termina resumiendo en dos o tres frases qué has cambiado y por qué, con el enlace de validación, y enumera los datos que no has podido verificar. Este resumen aparece en el historial de la rutina.