# Instrucciones para el agente: OpenOutreach: encuentra y califica contactos B2B

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/eracle/OpenOutreach (licencia GPL-3.0)
- Guía completa: https://lab.wisd.ai/hub/openoutreach-b2b-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 uv está disponible y que el entorno de la herramienta usa Python ≥3.11, según el [pyproject.toml oficial](https://github.com/eracle/OpenOutreach/blob/main/pyproject.toml). Instala y ejecuta únicamente la configuración inicial documentada:

```sh
uv tool install openoutreach
openoutreach init
```

Revisa proveedores y buzón con datos de prueba. El README distingue `init`, que solo configura, de `openoutreach` sin argumentos y `openoutreach run 5`, que encuentran contactos, compran direcciones y envían correo. Usa estos últimos solo cuando hayas aprobado destinatarios, contenido y consumo.

Para comprobar búsqueda sin compra de direcciones ni envío, usa las operaciones documentadas:

```sh
openoutreach status
openoutreach find 10
```

`find 10` sin el argumento `emails` devuelve candidatos en CSV sin gastar créditos de direcciones ni enviar mensajes. Revisa esa salida antes de activar la ruta de envío.

## Comprobación

Comprueba que los contactos seleccionados cumplen el perfil y que la explicación se apoya en datos verificables. Valida los destinatarios y el texto antes de cualquier envío.

## Si algo falla

Si faltan resultados, revisa el mercado objetivo y las fuentes de datos. Si falla el correo, comprueba la conexión del buzón por separado del descubrimiento de contactos.

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