¿Qué hace opencli-oneshot?
Útil para generar rápidamente un único comando OpenCLI a partir de una URL específica y una descripción del objetivo. Proceso en 4 pasos: abrir página, capturar API, escribir adaptador TS y probar. Para exploración completa del sitio, usa opencli-explorer en su lugar.
Requisitos
- Node.js 18+
- npm o yarn
- Acceso a internet para abrir páginas web
Uso
- Abrir página: Usa un navegador headless o una herramienta como
puppeteerpara cargar la URL proporcionada. - Capturar API: Observa las solicitudes de red que realiza la página (por ejemplo, mediante la pestaña Network de las herramientas de desarrollador o usando un proxy como
mitmproxy). Identifica la API relevante para tu objetivo. - Escribir adaptador TS: Crea un archivo TypeScript que implemente la interacción con la API capturada, utilizando
axios,fetchu otras bibliotecas. El adaptador debe exportar una función principal que tome parámetros (como autenticación, consultas) y devuelva el resultado. - Probar: Ejecuta el comando generado con
npx ts-nodeo compila y prueba con Node.js. Verifica que el comando funcione correctamente.
Ejemplo
# Supongamos que la URL es https://api.ejemplo.com/users
# y el objetivo es obtener un usuario por ID.
# Crear adaptador en src/getUser.ts y probar con:
npx ts-node src/getUser.ts --id 123
Limitaciones
- Este skill está optimizado para un solo comando. Si necesitas explorar múltiples rutas de un sitio, usa
opencli-explorer. - Las APIs capturadas pueden requerir autenticación (como tokens o cookies). Asegúrate de incluir esos detalles en el adaptador.
Integración con otros skills
- Combínalo con
opencli-explorerpara análisis previo de un sitio. - Usa con
opencli-testpara generar pruebas automatizadas.
Licencia
MIT