CubeLabs

1. El problema: tu agente no ve internet

Los agentes de IA han dominado el código, los documentos y los proyectos. Pero cuando les pides algo que requiere mirar la web, empiezan los fallos en cadena. No es que sean tontos: es que cada plataforma tiene su propia barrera de entrada.

Cada barrera se resuelve por separado: una API de pago aquí, un bloqueo anti-bot allá, un login de por medio y un parseo de datos al final. Hacer que un agente lea un simple tweet puede llevarte horas de configuración.

2. Qué es Agent Reach: una capa de capacidad, no otra herramienta

La idea central del proyecto es que Agent Reach es una capa de capacidad (capability layer), no un wrapper más. Está un nivel por encima de cualquier herramienta concreta: se encarga de seleccionar, instalar, diagnosticar y enrutar, pero no de la lectura en sí. La lectura la hace tu agente llamando directamente a las herramientas originales (yt-dlp, gh CLI, feedparser…), sin intermediarios.

channels/
├── web.py          → Jina Reader
├── twitter.py      → twitter-cli ▸ OpenCLI ▸ bird
├── youtube.py      → yt-dlp
├── github.py       → gh CLI
├── bilibili.py     → bili-cli ▸ OpenCLI ▸ API de búsqueda
├── reddit.py       → OpenCLI ▸ rdt-cli
├── facebook.py     → OpenCLI (sesión de navegador)
├── instagram.py    → OpenCLI (sesión de navegador)
├── xiaohongshu.py  → OpenCLI ▸ xiaohongshu-mcp ▸ xhs-cli
├── linkedin.py     → linkedin-mcp ▸ Jina Reader
├── rss.py          → feedparser
├── exa_search.py   → Exa vía mcporter
└── __init__.py     → registro de canales (para doctor)

Cada plataforma es una lista ordenada de backends: el preferido y sus alternativas. Si un método deja de funcionar, se cambia el orden de la lista — no se reescribe código. Un ejemplo real: cuando yt-dlp fue bloqueado por el anti-bot de Bilibili (junio 2026), Agent Reach cambió la ruta a bili-cli y los usuarios ni se enteraron.

Las ventajas frente a "instalar herramientas a mano":

• Selección experta — cada canal elige el backend más estable probado en producción real
• Instalación automática — dependencias, binarios y configuración sin intervención
• Salud continua — doctor detecta qué canal se rompió y da la receta para arreglarlo
• Compatibilidad total — cualquier agente que ejecute comandos (Claude Code, OpenClaw, Cursor, Windsurf) puede usarlo

3. Instalación en un comando

La instalación está diseñada para que la haga tu propio agente. Solo tienes que copiarle esta frase:

Ayúdame a instalar Agent Reach:
https://raw.githubusercontent.com/Panniantong/agent-reach/main/docs/install.md

Si prefieres hacerlo a mano, los pasos son igual de simples:

# Opción A: pipx (la más limpia)
pipx install https://github.com/Panniantong/agent-reach/archive/main.zip

# Opción B: venv (Python de Homebrew / PEP 668)
python3 -m venv ~/.agent-reach-venv
source ~/.agent-reach-venv/bin/activate
pip install https://github.com/Panniantong/agent-reach/archive/main.zip

agent-reach install --env=auto

agent-reach doctor

Qué hace el instalador automáticamente:

1. Instala el CLI agent-reach (incluye yt-dlp y feedparser)
2. Detecta e instala infraestructura base: Node.js, gh CLI y mcporter
3. Configura el buscador Exa vía MCP (gratis, sin API key)
4. Detecta si estás en local o en servidor y da recomendaciones
5. Registra el SKILL.md en los skills del agente
6. Pregunta qué canales opcionales quieres (los que requieren login se instalan solo si los pides)

4. Leer cualquier página web con Jina Reader

El canal más básico y útil: leer cualquier URL como texto limpio. Agent Reach usa Jina Reader (https://r.jina.ai/URL), gratuito y sin API key. Tu agente solo hace:

curl -s "https://r.jina.ai/https://es.wikipedia.org/wiki/Inteligencia_artificial"

El resultado es el contenido de la página convertido a texto legible — sin menús, sin scripts, sin montañas de HTML. Es la diferencia entre "leer" una página y recibir un volcado ilegible de etiquetas.

En la práctica, no necesitas recordar el comando: el SKILL.md instalado por Agent Reach le dice a tu agente que use curl https://r.jina.ai/URL cuando le pidas "mira qué pone en esta página".

5. YouTube: subtítulos y búsqueda con yt-dlp

Para YouTube, Agent Reach usa yt-dlp (154K ⭐, el estándar de facto). Tu agente puede extraer subtítulos de cualquier vídeo y buscar vídeos sin necesidad de API keys de Google:

# Obtener metadatos y subtítulos de un vídeo
yt-dlp --dump-json "https://www.youtube.com/watch?v=VIDEO_ID"

# Listar los subtítulos disponibles
yt-dlp --list-subs "https://www.youtube.com/watch?v=VIDEO_ID"

Con los subtítulos en la mano, el agente puede resumir el vídeo, extraer las ideas clave o citar partes exactas. Es uno de los superpoderes más demandados: "¿Qué dice este tutorial?" deja de ser un callejón sin salida.

6. GitHub con gh CLI

Para el ecosistema GitHub, Agent Reach usa el cliente oficial gh. Con él, tu agente explora repositorios, lee issues y busca código sin configurar tokens de API a mano:

# ¿Qué hace este repositorio?
gh repo view Panniantong/Agent-Reach

# Buscar repositorios
gh search repos "agente mcp" --limit 10

# Leer issues de un proyecto
gh issue list -R Panniantong/Agent-Reach

Después de que tu agente se autentique (le dices "ayúdame a iniciar sesión en GitHub"), también puede acceder a repositorios privados, abrir issues, hacer pull requests y forkear proyectos — todo desde la conversación.

7. Suscripciones RSS con feedparser

Para fuentes de noticias y blogs, feedparser es la librería estándar de Python. Agent Reach la incluye de serie, así que tu agente puede leer cualquier feed RSS/Atom sin configurar nada:

python3 -c "
import feedparser
feed = feedparser.parse('https://cubelabs.co/feed.xml')
for entry in feed.entries[:5]:
    print(entry.title)
    print(entry.link)
    print()
"

Esto convierte a tu agente en un vigilante de fuentes: puedes pedirle "revisa estos 10 feeds cada mañana y dime solo lo importante". Combinado con la búsqueda semántica de la siguiente lección, es la base de un sistema de monitorización completo.

8. Búsqueda semántica con Exa vía MCP

La búsqueda en internet tradicional devuelve enlaces; la búsqueda semántica de Exa entiende la intención y devuelve contenido relevante y actual. Agent Reach la integra vía MCP con mcporter, gratis y sin API key:

# Configurar el buscador (lo hace el instalador automáticamente)
mcporter config add exa ...

# Búsqueda semántica desde el agente
mcporter call 'exa.web_search_exa(query="mejores frameworks de agentes 2026", numResults=5)'

¿Por qué es importante? Cuando tu agente necesita información actual ("¿cuál es el estado del arte de X?"), un buscador semántico le da respuestas con contexto en vez de una lista de URLs. Además, se conecta por MCP, el protocolo estándar de herramientas para agentes, así que cualquier cliente compatible lo puede usar.

9. Canales con login: Twitter, Reddit y redes sociales

Las plataformas sociales (Twitter/X, Reddit, Facebook, Instagram, Xiaohongshu) no tienen ruta de cero configuración: exigen autenticación. Agent Reach las resuelve con dos estrategias complementarias.

OpenCLI: reutilizar la sesión de tu navegador

En el escritorio, el camino recomendado es OpenCLI, una extensión de Chrome que reutiliza tu sesión ya iniciada. No guarda contraseñas: usa el login que tú ya tienes en el navegador.

# Instalar el canal OpenCLI (una sola vez)
agent-reach install --channels opencli

# Ejemplos de uso directo
opencli facebook search "cubelabs" -f yaml
opencli instagram user nasa -f yaml
opencli reddit search "mcp" -f yaml
opencli xiaohongshu search "agente ia" -f yaml

twitter-cli: cookies exportadas con Cookie-Editor

Para Twitter/X, el método es exportar tus cookies desde el navegador con la extensión Cookie-Editor y pasárselas al agente. Las cookies se guardan solo en tu máquina, en ~/.agent-reach/config.yaml con permisos 600 (solo tú puedes leerlas).

# El agente guarda la cookie para el diagnóstico de doctor
agent-reach configure twitter-cookies "PASTED_STRING"

# Para llamar directamente a twitter-cli, define las variables de entorno
export TWITTER_AUTH_TOKEN="..."
export TWITTER_CT0="..."
twitter search "llm" -n 10

No tienes que memorizar nada: le dices a tu agente "ayúdame a configurar Twitter" y él te guía paso a paso.

10. Diagnóstico y mantenimiento: agent-reach doctor

El comando estrella del proyecto. agent-reach doctor te dice el estado de cada canal, qué backend se está usando en este momento y qué hacer si algo está roto:

$ agent-reach doctor
✅ Web        → Jina Reader
✅ YouTube    → yt-dlp
✅ GitHub     → gh CLI
✅ RSS        → feedparser
✅ Exa Search → MCP (gratis, sin API key)
🐦 Twitter    → twitter-cli ▸ OpenCLI   (falta configurar cookies)
⚠️ Reddit     → requiere login (OpenCLI o rdt-cli)

Cada canal prueba sus backends de verdad (no solo comprueba si el comando existe): el primero que funciona completamente es el elegido, y los que fallan muestran la receta para arreglarlos.

Para monitorización diaria puedes programar un cron con agent-reach watch: solo te avisa si algo se rompe o hay versión nueva, sin molestar cuando todo va bien. Y si un día un canal cae, recuerda: el proyecto cambia la ruta automáticamente al siguiente backend disponible.