# Instrucciones para el agente: Agent Reach: conecta tu agente a fuentes de la web

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/Panniantong/Agent-Reach (licencia MIT)
- Guía completa: https://lab.wisd.ai/hub/agent-reach-web-channels

---

## 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 puede usar Python ≥3.10. El mínimo figura en el README; la ruta de instalación sigue la [guía oficial](https://github.com/Panniantong/Agent-Reach/blob/main/docs/install.md).

### Paso 1: prepara uv e instala desde la fuente oficial

La guía avisa de que el paquete homónimo de PyPI no corresponde al proyecto. Usa la URL publicada:

```bash
uv tool install https://github.com/Panniantong/Agent-Reach/releases/latest/download/agent-reach.zip
agent-reach setup
```

### Paso 2: revisa los canales

```bash
agent-reach channels
```

Lee el informe para saber qué canales están listos y cuáles necesitan configuración.

### Paso 3: prueba una lectura pública

El ejemplo de la documentación:

```bash
agent-reach read https://www.v2ex.com/t/123
```

## Comprobación

Comprueba los campos ok, result y error.hint de las respuestas JSON. Una lectura pública debe devolver contenido o un error específico del canal; no uses una sesión sensible como primera prueba.

## Si algo falla

Si no aparece la CLI, la guía documenta `uv tool update-shell` y abrir otra terminal. Para errores de canal, sigue error.hint y su documentación en lugar de activar todas las integraciones.

Fuente: [documentación oficial](https://github.com/Panniantong/Agent-Reach#readme).