Agent-Reach no es otro buscador. Es una capa de instalación, enrutamiento y diagnóstico que elige herramientas externas para páginas web, GitHub, YouTube, RSS, Bilibili y otros canales, y muestra su estado mediante agent-reach doctor.
Para consultar un único documento oficial, un navegador normal es más sencillo. Agent-Reach resulta útil cuando Claude Code, Codex, Cursor u OpenClaw deben repetir un flujo de búsqueda, lectura y organización.
Límites que debes conocer antes de instalar
El instalador puede ejecutar pip y detectar Node.js, GitHub CLI y utilidades MCP. No empieces con una instalación automática en un servidor de producción ni en un equipo principal que almacene credenciales importantes. Es más seguro seguir este orden:
- Probar con una cuenta de usuario normal o en un entorno aislado.
- Ejecutar primero un dry run para ver qué pretende instalar o modificar.
- Usar el modo safe en servidores de producción o equipos compartidos.
- Utilizar cuentas secundarias para Twitter, Xiaohongshu, Reddit y otras plataformas que requieran sesión.
Los usuarios de OpenClaw también deben permitir que el agente ejecute comandos:
|
|
Los clientes que ya pueden ejecutar comandos de terminal, como Claude Code, Codex y Cursor, normalmente no necesitan este paso.
Proceso de instalación recomendado
Primero instala o actualiza la CLI:
|
|
Previsualiza la instalación sin modificar el sistema:
|
|
Después de revisar las dependencias, el directorio de skills y las ubicaciones de la configuración MCP, usa el modo seguro:
|
|
En un equipo personal de pruebas puedes usar la instalación automática, aunque conviene ejecutar antes el dry run:
|
|
El proyecto también ofrece instrucciones que puedes entregar directamente al agente:
|
|
Cómo validar la instalación
No basta con ver un mensaje de instalación completada. Ejecuta:
|
|
Interpreta el resultado de esta forma:
| Estado | Significado | Siguiente paso |
|---|---|---|
| Web, YouTube y RSS disponibles | Los canales sin configuración funcionan | Probar la lectura de una URL pública |
| Repositorios públicos de GitHub legibles | gh o el backend elegido funciona |
Los repositorios privados requieren gh auth login por separado |
| Twitter, Reddit o Xiaohongshu no disponibles | Suele faltar una sesión o cookies | Seguir la recomendación de doctor, sin reinstalar todo |
Empieza con tres tareas pequeñas: leer una página pública, resumir un repositorio público de GitHub y extraer subtítulos de un vídeo público. Configura las plataformas que requieren sesión solo después de superar estas pruebas.
No todas las plataformas funcionan sin configuración
La web, YouTube, RSS y algunas funciones de GitHub o Bilibili pueden funcionar sin iniciar sesión. Twitter, Reddit, Xiaohongshu, Facebook e Instagram suelen necesitar una sesión del navegador o cookies. Las reglas contra automatización cambian, por lo que tener la CLI instalada no garantiza que todos los canales funcionen para siempre.
Agent-Reach mantiene backends preferidos y alternativos para cada canal. doctor muestra la ruta activa y las recomendaciones de reparación. Si una integración deja de funcionar, actualiza y ejecuta el diagnóstico antes de cambiar opciones no relacionadas:
|
|
Solución de problemas
No se encuentra el comando agent-reach
Comprueba dónde instaló Python el paquete:
|
|
Si el paquete existe pero no aparece el comando, probablemente el directorio Scripts de Python no está en PATH. Abre de nuevo la terminal y verifica la ruta antes de instalar varias copias de Python.
El agente conversa, pero no puede instalar
Normalmente significa que el cliente no tiene permisos shell/exec, no que Agent-Reach esté averiado. Revisa los permisos de herramientas del cliente. En OpenClaw, confirma que tools.profile sea coding, reinicia el Gateway y abre una sesión nueva.
Una plataforma con inicio de sesión deja de funcionar
Las cookies pueden haber caducado, la plataforma puede haber cambiado su interfaz o la cuenta puede haber activado controles de riesgo. Ejecuta agent-reach doctor para identificar el canal y renueva únicamente la sesión correspondiente. Nunca pegues cookies de tu cuenta principal en historiales de chat, registros públicos o servidores remotos.
Desinstalación y recuperación
Previsualiza primero qué se eliminará:
|
|
La desinstalación completa elimina el directorio de configuración, los archivos de skill y la configuración MCP relacionada:
|
|
Para reinstalar solo la skill conservando tokens y cookies, utiliza:
|
|
Conclusión
Agent-Reach está pensado para usuarios de agentes de línea de comandos que investigan repetidamente en varias plataformas. El método fiable consiste en ejecutar un dry run, instalar los canales sin configuración, validarlos con doctor y añadir las plataformas con sesión solo cuando sean necesarias. Así es más fácil distinguir fallos de permisos del cliente, herramientas externas y sesiones de plataforma, y se reduce el riesgo para cuentas y credenciales.