agent-reach

Agent Reach (agent-reach) es una capa de capacidad de acceso a Internet orientada a agentes de IA, cuyo objetivo es permitir que un agente complete la selección de herramientas, la instalación, la verificación y la configuración de enrutamiento mediante una sola instrucción en lenguaje natural. El proyecto es de código abierto bajo licencia MIT y requiere Python 3.10+. Idea central: Agent Reach no encapsula directamente la lógica de lectura de cada plataforma, sino que el agente llama directamente a las herramientas upstream (como yt-dlp, gh CLI, feedparser, Jina Reader, OpenCLI, twitter-cli, bili-cli, etc.). Agent Reach se encarga de mantener "el método de acceso actualmente disponible para cada plataforma" y de generar SKILL.md para que lo use el agente. Cada canal está diseñado como una lista ordenada de backends de "preferido + alternativo"; durante la instalación o el diagnóstico se sondea realmente la disponibilidad, y cuando un backend previo falla se cambia al siguiente. El usuario puede consultar el estado de cada canal y la ruta actualmente efectiva mediante `agent-reach doctor`. Uso rápido: envía la instrucción de instalación (leer docs/install.md) a un agente que soporte ejecutar comandos shell (como Claude Code, OpenClaw, Cursor, Windsurf); el agente instalará paso a paso el CLI agent-reach, comprobará dependencias básicas como Node.js, gh CLI, mcporter, etc., y escribirá en el directorio skills del agente bajo autorización explícita. Seguridad por defecto: `agent-reach install` solo realiza comprobaciones de entorno en modo lectura, no modifica automáticamente el sistema ni escribe configuración; solo cuando se pasa explícitamente `--system` se instalan dependencias del sistema y se escribe configuración; además, `--dry-run` permite previsualizar todas las operaciones. La actualización también puede completarse con una sola instrucción. Los canales ya integrados incluyen: lectura web (Jina Reader), extracción de subtítulos y búsqueda de vídeos de YouTube (yt-dlp), lectura RSS/Atom (feedparser), búsqueda semántica en toda la web (Exa vía mcporter), GitHub (gh CLI, incluye lectura de repositorios y búsqueda; tras configurarlo admite repositorios privados, Issue/PR), lectura y búsqueda de tuits de Twitter/X, búsqueda y detalles de vídeos de Bilibili (bili-cli, etc.), búsqueda y lectura de publicaciones de Reddit, páginas y Feed de Facebook, usuarios y publicaciones de Instagram, búsqueda y lectura de Xiaohongshu, perfiles y búsqueda de empleo de LinkedIn, V2EX, Xueqiu, pódcast de Xiaoyuzhou (transcripción con Whisper), etc. Algunos canales funcionan sin configuración; los canales que requieren estado de sesión son guiados por el agente para que el usuario complete la configuración, por ejemplo exportando manualmente las cookies mediante Cookie-Editor, o reutilizando la sesión ya iniciada en el navegador de escritorio. Seguridad y privacidad: las cookies/tokens se guardan localmente en `~/.agent-reach/config.yaml` (permisos de archivo 600), no se suben ni se transmiten al exterior; tanto el código como las herramientas dependientes son de código abierto y auditables. El proyecto advierte claramente: las plataformas que usan inicio de sesión por cookie conllevan el riesgo de ser detectadas y provocar el bloqueo de la cuenta; se recomienda usar una cuenta secundaria dedicada en lugar de la cuenta principal. `agent-reach uninstall` puede eliminar la configuración local, los archivos skill de cada agente y la configuración MCP; admite `--dry-run` para previsualizar y `--keep-config` para conservar la configuración de cara a una reinstalación. En cuanto a su posicionamiento de diseño, Agent Reach es una "capa de capacidad" y no una herramienta concreta más: la lectura subyacente la realiza el agente llamando directamente a las herramientas upstream, mientras que Agent Reach se encarga de la selección, instalación, verificación y enrutamiento, para hacer frente a los cambios continuos en las interfaces de las plataformas, las estrategias anti-scraping y las herramientas CLI.