# Instrucciones para el agente: OpenSEO: consulta datos de búsqueda desde tu agente

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/every-app/open-seo (licencia MIT)
- Guía completa: https://lab.wisd.ai/hub/open-seo-platform

---

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

Comprueba que Docker Engine o Docker Desktop con Compose está funcionando y tiene al menos 4 GiB de memoria asignada. Prepara las credenciales de DataForSEO para el paso siguiente. Sigue docs/SELF_HOSTING_DOCKER.md; desde una carpeta donde puedas clonar, sus comandos iniciales son:

```sh
git clone https://github.com/every-app/open-seo.git
cd open-seo
export COMPOSE_FILE=deploy/standalone/compose.yaml
cp deploy/standalone/.env.example deploy/standalone/.env
```

### Paso 2: configura y arranca

En el archivo privado indicado por la guía, configura STORAGE_SECRET_KEY con un valor aleatorio propio y DATAFORSEO_API_KEY con tus credenciales codificadas en Base64 como `login:password`, según la guía oficial. No las pegues en el chat. Para uso en esta máquina conserva la URL local documentada.

```sh
docker compose pull
docker compose up -d
docker compose logs -f init
```

### Paso 3: crea tu cuenta y conecta MCP

Espera el mensaje de inicialización, abre http://localhost:3001 y crea la cuenta administradora antes de exponer la instancia. Comprueba que Claude Code abre una sesión autenticada. Adapta el comando de la [guía MCP](https://openseo.so/docs/mcp) sustituyendo el servidor alojado por tu instancia:

```sh
claude mcp add --transport http --scope local openseo http://localhost:3001/mcp
```

Desde el mismo proyecto abre una sesión nueva de Claude Code y aprueba OAuth con tu cuenta local de OpenSEO. Pide comprobar la conexión y listar los proyectos. Después elige un proyecto devuelto y consulta una sola palabra clave con el país y el idioma de tu ensayo. Contrasta el resultado con la interfaz y revisa el consumo de DataForSEO. Si usas una clave de Settings → API keys en vez de OAuth, configura el encabezado oficial `Authorization: Bearer` en el cliente; no lo confundas con la clave del proveedor de datos.

## Comprobación

Comprueba que puedes iniciar sesión, ejecutar una consulta pequeña y obtener el mismo tipo de datos desde el cliente MCP. Revisa el consumo del proveedor y qué credenciales usa la instancia.

## Si algo falla

Si Docker no inicializa, lee los logs de init. Si faltan datos, revisa la configuración de DataForSEO en su guía. Para fallos MCP, comprueba autenticación y compatibilidad de registro del cliente; el despliegue documentado no admite CIMD.

Fuente: [documentación del proyecto](https://github.com/every-app/open-seo/blob/89ad06cfe08c291f2f4b2c99c5c3433d1bb45ce7/README.md).