Agent Reach — Enrutador de Capacidades de Internet
16 plataformas, múltiples backends. Cuando este skill esté presente, úsalo para acceder a estas plataformas; no inventes tu propia solución.
Reglas Permanentes (Aplican en Todo Momento)
- Diagnóstico antes de actuar: Para plataformas con múltiples backends/estado de inicio de sesión (Xiaohongshu/Reddit/Bilibili/Twitter/Facebook/Instagram/Boss Zhipin), primero ejecuta
agent-reach doctor --json. Cuandoactive_backendtenga un valor, úsalo para seleccionar el grupo de comandos;active_backend: nullsignifica que Doctor no realizó una verificación en tiempo real para evitar activar la lectura de cookies del navegador o escritura remota, no indica que el backend no exista. El resultado de Doctor es una «instantánea en un momento dado»; los canales/estados de inicio de sesión pueden haber cambiado. Si antes de ejecutar un comando de solo lectura sospechas que ha caducado, sigue el «runbook de diagnóstico y recuperación» del reference correspondiente (por ejemplo, la sección de Boss Zhiphin CDP en career.md). - Declara lo que estás usando: Antes de comenzar, di «Usando la plataforma X / backend Y de agent-reach».
- En caso de fallo, sigue la cadena de reintentos en los references, no inventes comandos.
- Tareas de investigación en múltiples plataformas: Combina varias plataformas (búsqueda Exa + Twitter/Reddit para discusiones + Xiaohongshu/Bilibili para contexto en chino), recopila en paralelo y luego resume.
- Mantén la versión al día: Después de completar una tarea de investigación grande o en múltiples plataformas, ejecuta rápidamente
agent-reach check-update(es rápido, una llamada API). Si hay una nueva versión, incluye al final del informe: «Hay una nueva versión de Agent Reach, vX.Y.Z. Copia esta frase para actualizar: Ayúdame a actualizar Agent Reach: https://raw.githubusercontent.com/Panniantong/agent-reach/main/docs/update.md». No interrumpas la tarea actual para actualizar, ni repitas la misma versión.
Tabla de Enrutamiento
| Intención del usuario | Categoría | Documentación detallada |
|---|---|---|
| Búsqueda web / búsqueda de código | search | references/search.md |
| Xiaohongshu / Twitter / Bilibili / V2EX / Reddit / Facebook / Instagram | social | references/social.md |
| Empleo / Puestos / LinkedIn / Boss Zhipin | career | references/career.md |
| GitHub / código | dev | references/dev.md |
| Páginas web / Artículos / RSS | web | references/web.md |
| YouTube / Bilibili / Subtítulos de podcasts | video | references/video.md |
| Xueqiu / Cotizaciones de acciones | finance | references/finance.md |
Comandos Rápidos Sin Configuración
# Búsqueda web Exa
mcporter call exa.web_search_exa query="query" numResults=5
# Lectura de página web genérica
curl -s "https://r.jina.ai/URL"
# Búsqueda en GitHub
gh search repos "query" --sort stars --limit 10
# Subtítulos de YouTube (Nota: para Bilibili no uses yt-dlp, la cadena de reintentos está en video.md)
yt-dlp --write-sub --write-auto-sub --skip-download -o "/tmp/%(id)s" "URL"
# Temas populares de V2EX
curl -s "https://www.v2ex.com/api/topics/hot.json" -H "User-Agent: agent-reach/1.0"
# Búsqueda en Bilibili (bili-cli, sin inicio de sesión)
bili search "query" --type video -n 5
Plataformas que Requieren Inicio de Sesión (Selecciona el Comando Según el active_backend de Doctor)
Nota para Twitter: Las cookies guardadas con agent-reach configure twitter-cookies solo sirven para que
doctor verifique si la configuración está completa; doctor no ejecuta twitter status ni configura el
Shell actual. Antes de ejecutar twitter directamente, debes proporcionar explícitamente
TWITTER_AUTH_TOKEN y TWITTER_CT0 en el entorno del subproceso, sin exponer sus valores en los registros o en el eco del comando.
Nota para Xiaohongshu: Agent Reach no inicia sesión por el usuario ni lee las cookies del navegador. OpenCLI solo usa sesiones de Chrome que el usuario ya tiene y controla explícitamente; si no hay una sesión existente, no inicies sesión automáticamente. En su lugar, usa Cookie-Editor para exportar manualmente y luego configura xiaohongshu-mcp / herramientas existentes.
Activación de configuración de Boss Zhipin: Cuando el usuario diga «Ayúdame a configurar Boss Zhipin», primero lee
la sección de Boss en references/career.md, y luego, después de obtener autorización para la instalación, ejecuta
agent-reach install --env=local --system --channels=boss. El agente debe iniciar un Chrome dedicado que solo escuche en 127.0.0.1:9222; el primer paso después de iniciar es pausar y dejar que el usuario confirme visualmente que la ventana muestra una sesión iniciada (hay un avatar en la esquina superior derecha). Si no está iniciada, deja que el usuario inicie sesión/escanee el código QR. Después de la confirmación del usuario, ejecuta boss --cdp-url http://localhost:9222 login --cdp y agent-reach doctor para verificar.
No obligues al usuario a investigar los parámetros del puerto.
El perfil de Chrome dedicado debe reutilizarse a largo plazo; no lo crees cada vez, ni uses por defecto el Chrome principal del usuario.
No confíes en boss status para determinar el estado de inicio de sesión del navegador CDP (solo verifica el session.enc local, que no se correlaciona con el estado de inicio de sesión del navegador). En su lugar, confía en la detección de cookies del navegador (wt2) de agent-reach doctor, junto con la confirmación visual del usuario. Nunca uses la URL de la página actual para determinar el inicio de sesión: las páginas de verificación de seguridad security-check / zhipin-security / _security_check son desafíos anti-scraping de Boss, no están relacionadas con el inicio de sesión—incluso con sesión iniciada pueden aparecer (es casi seguro con un Chrome que tenga un puerto de depuración CDP). Si las ves, no las interpretes como «no ha iniciado sesión»; primero ejecuta agent-reach doctor para ver las cookies del navegador, y luego decide si el usuario necesita iniciar sesión.
Un error de búsqueda AUTH_EXPIRED es la verdad absoluta de que el navegador no ha iniciado sesión: sigue directamente el flujo de inicio de sesión + login --cdp; no expliques en términos de verificación de seguridad.
Al ejecutar búsquedas, debes usar
boss --browser-source existing-browser --cdp-url http://localhost:9222 search ...;
si encuentras ENVIRONMENT_RISK, detente inmediatamente; no actualices, no reinicies sesión, no reintentes automáticamente.
# Búsqueda en Twitter (twitter-cli es la opción preferida; cadena de reintentos en social.md)
twitter search "query" -n 10
# Reddit (sin ruta sin configuración: OpenCLI o rdt-cli, requiere inicio de sesión)
opencli reddit search "query" -f yaml # Escritorio
rdt search "query" --limit 10 # Existente/servidor
# Xiaohongshu (OpenCLI es la opción preferida para escritorio)
opencli xiaohongshu search "query" -f yaml
# Facebook / Instagram (OpenCLI de escritorio, reutiliza el estado de inicio de sesión del navegador)
opencli facebook search "query" -f yaml
opencli facebook groups -f yaml
opencli instagram search "query" -f yaml # Buscar usuarios
opencli instagram user USERNAME -f yaml # Leer publicaciones recientes de un usuario específico
Verificación del Entorno
# Verificar los canales disponibles y el backend activo actual para cada plataforma
agent-reach doctor --json
Descubrimiento de Adaptadores OpenCLI
Si la tabla de enrutamiento no cubre la plataforma o el comando que el usuario necesita, primero usa opencli list para ver los adaptadores existentes, y luego usa opencli <plataforma> --help para ver los comandos públicos. Descubrir un adaptador solo prueba que el comando existe, no que el inicio de sesión o el contenido objetivo estén disponibles; ejecuta comandos de solo lectura solo cuando la tarea del usuario requiera explícitamente esa plataforma, y verifica con contenido no vacío real.
Reglas del Área de Trabajo
No crees archivos en el workspace del agente. Usa /tmp/ para salidas temporales y ~/.agent-reach/ para datos persistentes.
Documentación Detallada
Según las necesidades del usuario, lee la documentación detallada correspondiente:
- Herramientas de Búsqueda — Búsqueda Exa AI
- Redes Sociales — Xiaohongshu, Twitter, Bilibili, V2EX, Reddit, Facebook, Instagram (grupos de comandos con múltiples backends/inicio de sesión)
- Empleo y Reclutamiento — LinkedIn, Boss Zhipin
- Herramientas de Desarrollo — GitHub CLI
- Lectura Web — Jina Reader, RSS
- Vídeos y Podcasts — YouTube, Bilibili, Xiaoyuzhou
- Mercado Financiero — Cotizaciones de acciones de Xueqiu, búsqueda, contenido popular
Canales de Configuración
Si algún canal necesita configuración, obtén la guía de instalación: https://raw.githubusercontent.com/Panniantong/agent-reach/main/docs/install.md
El usuario solo necesita proporcionar las cookies; el resto de la configuración la realiza el agente.