ml-cli es una interfaz de línea de comandos para el httpServer local de MoreLogin. Traduce los argumentos de la CLI en solicitudes HTTP y los reenvía a las API locales expuestas por el cliente MoreLogin.
¿Para quién es? Ingenieros de DevOps, ingenieros de automatización de control de calidad y desarrolladores que prefieren trabajar en la terminal o necesitan integrar MoreLogin en canalizaciones de CI/CD (como GitHub Actions, Jenkins o scripts de shell).
¿Qué puede hacer?
- Llame a las API locales de MoreLogin directamente desde una terminal sin escribir el código de solicitud HTTP.
- Administre entornos de navegador, servidores proxy, teléfonos en la nube y programaciones desde una interfaz unificada.
- Utilice indicadores CLI estables en lugar de crear cargas útiles JSON manualmente.
¿Cómo empezar?
- Lea los Requisitos previos a continuación.
- Descargue e instale la CLI para su plataforma.
- Consulte el Inicio rápido para ejecutar su primer comando.
Antes de usar ml-cli, asegúrese de que se cumplan los siguientes requisitos:
- El cliente de escritorio MoreLogin está instalado y ejecutándose en la misma máquina
- Tienes una cuenta MoreLogin activa con credenciales API (ID API + clave API)
Descargue el binario ml-cli más reciente para su plataforma:
| Plataforma | Arquitectura | Enlace |
|---|---|---|
| ventanas | x64 | descargar |
| macos | x64 (Inteligencia) | descargar |
| macos | arm64 (silicona de Apple) | descargar |
| linux | x64 | descargar |
Cree un directorio para la CLI, por ejemplo
C:\Program Files\MoreLogin\:New-Item -ItemType Directory -Force -Path "C:\Program Files\MoreLogin"Mueva el
ml-cli.exedescargado a ese directorio.Agregue el directorio a su sistema
PATH:# Add to the current user's PATH permanently $currentPath = [Environment]::GetEnvironmentVariable("Path", "User") [Environment]::SetEnvironmentVariable("Path", "$currentPath;C:\Program Files\MoreLogin", "User")Reinicia tu terminal (o abre uno nuevo) para que el cambio surta efecto.
Verificar:
ml-cli --version
Haga el binario ejecutable:
chmod +x ml-cliMuévelo a un directorio en tu
PATH:sudo mv ml-cli /usr/local/bin/Si
/usr/local/binno existe, créelo primero:sudo mkdir -p /usr/local/binEn macOS, Gatekeeper puede bloquear el binario descargado. Eliminar el atributo de cuarentena:
xattr -d com.apple.quarantine /usr/local/bin/ml-cliVerificar:
ml-cli --version
Haga el binario ejecutable:
chmod +x ml-cliMuévelo a un directorio en tu
PATH:sudo mv ml-cli /usr/local/bin/Verificar:
ml-cli --version
Una vez instalado, consulte Inicio rápido para conectarse al cliente MoreLogin y ejecutar su primer comando.
La CLI actual cubre estos grupos de recursos:
- estado del servicio e inicio de sesión
- gestión del entorno del navegador a través de
env - gestión de teléfonos en la nube a través de
cloudphone - gestión de grupos a través de
group - gestión de etiquetas a través de
tag - gestión de proxy a través de
proxy - gestión de horarios de teléfonos en la nube a través de
schedule
La CLI admite dos estilos de entrada:
- indicadores explícitos, como
--env-ido--group-name - JSON sin formato a través de
--json-data
Se pueden combinar. Las reglas de fusión son:
--json-dataproporciona el cuerpo de la solicitud base- Los indicadores CLI explícitos anulan las claves coincidentes de
--json-data
Esto es útil para puntos finales con muchos campos o cargas útiles anidadas donde las banderas dedicadas serían demasiado pesadas.
| Código | Significado |
|---|---|
| CODIGO_PH_0 | La solicitud HTTP se completó y se recibió una respuesta. Verifique el cuerpo JSON para verificar el éxito o el fracaso del negocio. |
| CODIGO_PH_0 | La validación de la CLI local falló o el comando no es compatible con la plataforma actual. |
| CODIGO_PH_0 | Error en la resolución del puerto, error en el análisis JSON o no se pudo enviar la solicitud. |
La CLI necesita encontrar el puerto httpServer local para enviar solicitudes. Comprueba en este orden:
- Bandera
--port: pasa explícitamente el puerto en cada llamada - Variable de entorno
ML_PORT: configurada una vez por sesión - Descubrimiento automático de IPC: la CLI lee el puerto desde una tubería IPC local (no se necesita configuración)
Rutas IPC predeterminadas:
| Plataforma | Camino |
|---|---|
| macOS/Linux | CODIGO_PH_0 |
| ventanas | CODIGO_PH_0 |
Si ve el error "No se pudo detectar el puerto MoreLogin", verifique:
- ¿Se está ejecutando el cliente de escritorio MoreLogin?
- Si usa
--port, ¿es correcto el número de puerto? - En Linux/macOS, ¿existe
/tmp/MoreLogin-cli?