# Instrucciones para el agente: SEO Machine: investiga y prepara contenido con Claude Code

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/TheCraigHewitt/seomachine (licencia MIT)
- Guía completa: https://lab.wisd.ai/hub/seo-machine-claude

---

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

### Preparación

Comprueba Git, Claude Code autenticado y Python con pip en un entorno separado. El README no fija una versión mínima de Python; revisa la compatibilidad de data_sources/requirements.txt con tu intérprete antes de instalar. Comprueba acceso a DataForSEO; GA4 y Search Console son integraciones opcionales.

### Paso 1: instala el espacio de trabajo

```bash
git clone https://github.com/TheCraigHewitt/seomachine.git
cd seomachine
pip install -r data_sources/requirements.txt
```

### Paso 2: añade el contexto del negocio

Completa las plantillas de context/, especialmente brand-voice.md, writing-examples.md, target-keywords.md e internal-links-map.md. Copia `data_sources/config/.env.example` a `data_sources/config/.env` y completa `DATAFORSEO_LOGIN` y `DATAFORSEO_PASSWORD` con las credenciales de API del panel DataForSEO. No son las credenciales de Claude. Para esta primera investigación puedes dejar GA4 y Search Console sin conectar; sus IDs y cuentas de servicio se configuran por separado si activas esas fuentes. Mantén el archivo fuera de Git.

### Paso 3: inicia la investigación

```bash
claude
```

Dentro de Claude Code, el ejemplo oficial:

```text
/research estrategias de marketing de contenidos para SaaS B2B
/write estrategias de marketing de contenidos para SaaS B2B
```

## Comprobación

Confirma que aparecen una investigación en research/ y un borrador en drafts/. Revisa que usa tu contexto y contrasta palabras clave y fuentes antes de avanzar a publicación.

## Si algo falla

Si faltan datos, revisa la integración específica y sus permisos. Si el texto no sigue la marca, completa las plantillas con ejemplos reales antes de volver a generar.

Fuente: [documentación oficial](https://github.com/TheCraigHewitt/seomachine#readme).