Documentación para desarrolladores

Comandos y configuración de CLI

Usa la CLI para consultar esquemas API, enviar solicitudes JSON, iniciar sesión en el navegador y configurar tu conexión MCP.

Leer en Markdown

Revisado por el equipo de SosoAPI · 2026-10-21

Comandos

Consulta --help para conocer las opciones de tu versión instalada. Sin argumentos, sosoapi inicia el servidor MCP stdio. Ejecuta por separado los comandos siguientes; no forman una cadena de comandos de shell.

npx sosoapi --help
npx sosoapi auth login
npx sosoapi auth login --no-open
npx sosoapi auth status
npx sosoapi auth refresh
npx sosoapi auth logout

npx sosoapi connect threads
npx sosoapi connect instagram --no-open

npx sosoapi api contract --summary
npx sosoapi api contract --route /studio-api/scheduled-posts/
npx sosoapi api contract

Autenticación y permisos

Llama a una ruta API con JSON por stdin

Usa api post para rutas de la lista pública permitida de CLI, incluidas lecturas que usan HTTP POST. Guarda el cuerpo en request.json con un editor para que el shell no interprete el texto del cliente. Comprueba http_status y el cuerpo de respuesta; un código de salida cero no demuestra por sí solo éxito API.

Este ejemplo consulta el contexto del espacio de trabajo. Antes de enviar una escritura, consulta el esquema de la operación y confirma el destino que tienes autorización para usar. Guarda el ID devuelto y comprueba el resultado antes de reintentar una solicitud que agotó el tiempo de espera.

{}

npx sosoapi api post /identity-api/workspace/list < request.json

Referencia completa de API

Variables de entorno

Establece estas variables en el proceso que ejecuta tu servidor MCP. La telemetría opcional excluye argumentos, prompts, resultados y rutas de archivos; establece SOSOAPI_TELEMETRY=0 para desactivarla. Usar una dirección API personalizada requiere aceptación explícita y la CLI no enviará VICKY_API_KEY a esa dirección.

Entorno de CLI
Variable	Efecto
SOSOAPI_TOOL_PROFILE=core	Herramientas cotidianas; el valor predeterminado es full. No concede permisos.
SOSOAPI_OUTPUT_SCHEMAS=1	Incluye esquemas de salida en tools/list; los resultados son estructurados en ambos casos.
SOSOAPI_UPLOAD_ROOTS	Directorios multimedia locales adicionales, separados por : (; en Windows).
SOSOAPI_TELEMETRY=0	Desactiva el envío opcional de datos de uso.
SOSOAPI_DEBUG=1	Muestra trazas de pila de errores de CLI; revísalas y oculta datos sensibles antes de compartirlas.
VICKY_API_KEY	Token de acceso personal para scripts/CI; prefiere OAuth para agentes.
VICKY_API_BASE_URL	Base API HTTPS personalizada (localhost puede usar HTTP); también requiere SOSOAPI_ALLOW_CUSTOM_BASE_URL=1.

Gestión de contenido no confiable

Los comentarios y nombres de usuario pueden contener instrucciones escritas por otras personas. En las respuestas cubiertas, la CLI añade las etiquetas untrusted_content y untrusted_notice y una advertencia en stderr. También depura y recorta el contenido, pero tu agente debe seguir tratándolo como datos, no como autoridad para realizar una acción.