# Instrucciones para el agente: Competitive Intel Monitoring: interpreta cambios de competidores

Pega este texto a tu agente (Claude Code, Codex, OpenCode, Hermes o el que uses) y dile «ayúdame a montarlo». Son los pasos para ponerlo en marcha; el porqué de cada pieza está en la guía completa.

- Dificultad: avanzado
- Proyecto: https://github.com/saas-anna/competitive-intel-monitoring
- Guía completa: https://lab.wisd.ai/hub/competitive-intel-monitoring

---

## Para el agente: cómo acompañar al usuario

1. Pregunta primero para qué lo quiere. Si su objetivo no necesita algún paso, sáltalo.
2. Antes de instalar, comprueba lo que ya tiene (versiones, claves, sistema operativo).
3. Avanza un paso cada vez: explica en una frase qué vas a hacer y deja que el usuario lo ejecute o lo apruebe.
4. Tras cada paso, comprueba que funcionó antes de seguir. Si falla, para y explica el error.
5. No inventes comandos ni opciones: si la documentación del proyecto contradice estos pasos, manda la documentación.
6. Al terminar, haz una prueba real con el objetivo del usuario y dile dónde profundizar.

---

## Pasos de configuración

### Paso 1: completa los requisitos

Lee [PREREQUISITES.md](https://github.com/saas-anna/competitive-intel-monitoring/blob/HEAD/PREREQUISITES.md). Comprueba Docker y Compose. Prepara competidores, URLs, contexto estratégico, Google Alerts y F5Bot con una etiqueta de Gmail. Crea la hoja con las pestañas State, PreviousSignals, History y, si la usas, Changedetection; compártela con la cuenta de servicio. Verifica acceso a Anthropic, Gmail OAuth y Sheets antes de importar el flujo.

### Paso 2: inicia la infraestructura

Con una copia del repositorio y desde su raíz, BUILD-GUIDE.md indica:

```bash
docker-compose up -d
docker ps
```

### Paso 3: importa y adapta

Abre n8n en `http://localhost:5678` e importa `workflow/competitive-intel.json`. Completa los nodos que enumera BUILD-GUIDE.md:

- En Credentials crea Google Sheets por cuenta de servicio, Gmail por OAuth2 y Header Auth para Anthropic con nombre de cabecera `x-api-key`; guarda los valores solo en las credenciales privadas de n8n y asigna cada credencial a sus nodos.
- Sustituye `YOUR_GOOGLE_SHEET_ID` en Run Metadata y en los siete nodos de Sheets. Conserva las columnas exactas de la sección Step 6 del montaje.
- En Build Request List completa `COMPETITORS` con nombres, dominios y URLs verificadas. En Build LLM Prompt incorpora tu contexto estratégico y en Read Gmail Alerts usa `label:<etiqueta-real>`.
- Configura destinatario de prueba y los demás marcadores de correo según el montaje. En Fetch CD Watches configura el acceso a changedetection; en `http://localhost:5555` añade las páginas que necesiten navegador y elige Playwright.
- En `http://localhost:8888/preferences` activa los motores de noticias necesarios y configura salida JSON, como indica el montaje.

Mantén desactivado el horario y pulsa Execute Workflow para una primera ejecución manual. Esta establece las huellas iniciales de las páginas; los cambios web solo pueden comprobarse desde una segunda ejecución.

## Comprobación

Comprueba los cuatro contenedores descritos por el autor y ejecuta un caso reducido. Revisa que las señales enlazan con las fuentes, que el resumen llega al destinatario de prueba y que el estado evita repetirlo.

## Si algo falla

Si una fuente devuelve solo una página vacía o un bloqueo, verifica la URL y el método de captura. Si llegan resúmenes irrelevantes, corrige primero competidores, palabras clave y contexto estratégico.

Consulta el [README oficial](https://github.com/saas-anna/competitive-intel-monitoring#readme) para el procedimiento completo y los cambios de versión.