# Instrucciones para el agente: Open Deep Research: investiga con ciclos de búsqueda

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/dzhng/deep-research (licencia MIT)
- Guía completa: https://lab.wisd.ai/hub/open-deep-research-agent

---

## 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 tienes Node.js 22.x y npm, según el [package.json oficial](https://github.com/dzhng/deep-research/blob/main/package.json). Comprueba también Git. Descarga el código y abre su carpeta:

```sh
git clone https://github.com/dzhng/deep-research.git
cd deep-research
```

 La instalación documentada usa:

```sh
npm install
```

Configura `FIRECRAWL_KEY` y `OPENAI_KEY` en el archivo local privado `.env.local`, como indica el README. Para un modelo local sigue su alternativa `OPENAI_ENDPOINT` y `OPENAI_MODEL`; no mezcles ambas rutas. Inicia la aplicación:

```sh
npm start
```

Cuando lo pregunte, introduce un tema público acotado, amplitud 3 y profundidad 1 (dentro de los intervalos del README). Contesta las preguntas de enfoque y espera al cierre. Debe crear `report.md` o `answer.md` en esta misma carpeta, según el modo elegido; abre ese archivo para revisar las fuentes.

## Comprobación

Abre las fuentes del informe y comprueba una afirmación clave. Revisa que la investigación no haya confundido un resumen con evidencia primaria.

## Si algo falla

Si falla una búsqueda, revisa el proveedor correspondiente. Si el informe es demasiado amplio, reduce la pregunta antes de aumentar profundidad y consumo.

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