# Instrucciones para el agente: Obscura: un navegador sin interfaz gráfica para agentes y extracción

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/h4ckf0r0day/obscura (licencia Apache-2.0)
- Guía completa: https://lab.wisd.ai/hub/obscura-headless-browser

---

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

Comprueba que usas Linux x86_64 con glibc ≥2.35 (las releases se compilan para Ubuntu 22.04) y que tienes curl y tar. Para esta ruta con binario no necesitas Node.js ni Chrome. El README documenta:

```sh
curl -LO https://github.com/h4ckf0r0day/obscura/releases/latest/download/obscura-x86_64-linux.tar.gz
tar xzf obscura-x86_64-linux.tar.gz
./obscura fetch https://example.com --eval "document.title"
```

Para otra plataforma, usa el archivo correspondiente de las releases oficiales.

## Comprobación

Comprueba que el título coincide con la página. Después prueba una página de tu flujo y compara el contenido extraído con un navegador habitual.

## Si algo falla

Si falla la ejecución, revisa la arquitectura del binario. Si una página no se procesa igual, registra el caso y verifica las limitaciones del motor.

Consulta [el README oficial](https://github.com/h4ckf0r0day/obscura#readme) para requisitos y variantes de instalación.