# Instrucciones para el agente: Trend Hunter CLI: construye un archivo local de tendencias públicas

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: intermedio
- Proyecto: https://github.com/mvanhorn/printing-press-library/tree/main/library/marketing/trendhunter
- Guía completa: https://lab.wisd.ai/hub/trendhunter-cli

---

## 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: prepara el acceso

Comprueba Node.js ≥22.20.0 y npm/npx para instalar el binario y su skill. Comprueba acceso de red a la fuente pública y el directorio de binarios en PATH: `~/.local/bin` en macOS/Linux o `%LOCALAPPDATA%\Programs\PrintingPress\bin` en Windows. No necesitas autenticarte; la sincronización se realiza después de instalar.

Para instalar el binario, comprueba además Go ≥1.26.10, versión de [.go-version](https://github.com/mvanhorn/printing-press-library/blob/main/.go-version) que exige el [instalador](https://github.com/mvanhorn/printing-press-library/blob/main/npm/README.md#requirements). El instalador compila con go install; si no tienes Go, utiliza la publicación precompilada de la CLI siguiendo su README. Listar y buscar en el catálogo no requieren compilar.

### Paso 2: instala la CLI

Ejecuta el comando de instalación del README:

```bash
npx -y @mvanhorn/printing-press-library install trendhunter
```

### Paso 3: prueba el flujo documentado

Ejecuta los comandos en este orden. Los términos, dominios e identificadores de ejemplo se sustituyen por los que correspondan a tu trabajo.

```bash
trendhunter-pp-cli sync
trendhunter-pp-cli search "AI clone" --json
trendhunter-pp-cli brief --category ai --top 10 --format markdown
```

## Comprobación

Comprueba que cada comando termina correctamente y que la salida corresponde a la cuenta, fuente o datos que seleccionaste. Una lista vacía no demuestra que el dato no exista: comprueba primero el alcance de la consulta y, si usas una copia local, su sincronización.

## Si algo falla

Una búsqueda vacía tras instalar suele indicar que falta sync. Si hay un 403, revisa la versión y las notas del README antes de reintentar. Consulta el [README de esta CLI](https://github.com/mvanhorn/printing-press-library/blob/main/library/marketing/trendhunter/README.md) para las opciones específicas de tu sistema y versión. No compartas credenciales en la salida de diagnóstico.