CLI de redes sociales: programa publicaciones desde la terminal

La CLI de Social media studio te permite gestionar publicaciones, borradores, cuentas, multimedia, la bandeja de entrada social, analíticas, generación con IA y mucho más, directamente desde la terminal. Devuelve JSON por defecto, lo que facilita encadenarla con jq o usarla en scripts y pipelines de CI/CD. El paquete incluye dos binarios:

Binario	URL de API por defecto	Caso de uso
`so-me`	`https://api.so-me.studio`	Producción (por defecto)
`so-me-dev`	`http://localhost:8000`	Desarrollo local contra un backend autoalojado

Esta página documenta la versión 2.2.0 de la CLI (@social-media-scheduler/cli). Todos los comandos usan la sintaxis con dos puntos, por ejemplo posts:list, media:upload, ai:generate. Ejecuta so-me --help para ver la lista completa de comandos, o so-me <command> --help para ver las opciones de un comando concreto.

Instalación

npm install -g @social-media-scheduler/cli

pnpm add -g @social-media-scheduler/cli

yarn global add @social-media-scheduler/cli

npx @social-media-scheduler/cli posts:list

Requiere Node.js >= 20.0.0.

Autenticación

Necesitas una clave de API para usar la CLI. Consulta Autenticación para generar una.

Clave de API (recomendado)
Inicio de sesión en el navegador (device flow)
Variable de entorno

so-me auth:login --api-key sk_live_xxxxxxxxxxxxxxxxxxxxxxxx

La clave se guarda localmente. Todos los comandos posteriores la usan automáticamente.

so-me auth:login

Inicia un flujo de autorización de dispositivo OAuth2: la CLI muestra una URL de verificación y un código de un solo uso, abre tu navegador y consulta periódicamente hasta que apruebas. Si tu plan admite acceso a la API (plan Standard, Advanced o Lifetime), se genera y guarda automáticamente una clave de API.

export SOME_API_KEY=sk_live_xxxxxxxxxxxxxxxxxxxxxxxx
so-me posts:list

Útil para pipelines de CI/CD y scripts. La variable de entorno se usa cuando no se indica ninguna clave con --api-key ni hay credenciales guardadas.

Verifica tu autenticación:

so-me auth:status        # show stored key + API URL
so-me auth:whoami        # verify the key against the API; print user + organization

Opciones globales

Todos los comandos aceptan estas opciones. Se muestran las formas larga y corta cuando existe un alias corto.

Opción	Descripción
`--api-key <key>`	Sustituye la clave de API guardada para este comando
`--api-url <url>`	Sustituye la URL base de la API (por defecto: `https://api.so-me.studio`, o `http://localhost:8000` para `so-me-dev`)
`--json`	Muestra la salida como JSON (por defecto)
`--table`	Muestra la salida como una tabla con formato
`--verbose`	Muestra información detallada de los errores
`-V, --version`	Imprime la versión de la CLI (`2.2.0`)
`-h, --help`	Muestra la ayuda de la CLI o de un comando

Formatos de salida

La salida es JSON por defecto. Pasa --table para obtener una tabla legible en los comandos que lo admiten.

JSON (por defecto)
Tabla

so-me posts:list

[
  {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "text": "Hello world!",
    "socialMedia": "TWITTER",
    "postStatus": "SCHEDULED",
    "scheduledAt": "2026-04-12T09:00:00.000Z"
  }
]

so-me posts:list --table

┌──────────────┬───────────────┬──────────┬───────────┐
│ ID           │ Text          │ Platform │ Status    │
├──────────────┼───────────────┼──────────┼───────────┤
│ 550e8400...  │ Hello world!  │ TWITTER  │ SCHEDULED │
└──────────────┴───────────────┴──────────┴───────────┘

Paginación

La mayoría de los comandos de listado aceptan opciones de paginación:

Opción	Descripción	Por defecto
`--page <n>`	Número de página que se obtiene	`1`
`--limit <n>`	Elementos por página	según el comando
`--all`	Obtiene todas las páginas (donde se admite)	desactivado

so-me posts:list --page 2 --limit 50
so-me media:list --all --table

Variables de entorno

Variable	Descripción	Por defecto
`SOME_API_KEY`	Clave de API (alternativa a la opción `--api-key` o a `auth:login`)	—
`SOME_API_URL`	URL base de la API	`https://api.so-me.studio` (`so-me`) / `http://localhost:8000` (`so-me-dev`)

Grupos de comandos

La CLI registra los siguientes grupos de comandos. Cada uno enlaza con su referencia detallada.

Auth

Inicio de sesión (clave de API o device flow), cierre de sesión, estado, whoami

Posts

Crear, programar, actualizar, reintentar, reenviar y eliminar publicaciones; vista de calendario

Drafts

Crear, actualizar y eliminar borradores y convertirlos en publicaciones programadas

Accounts

Conectar, listar, inspeccionar y eliminar cuentas sociales

Media

Subir, buscar, organizar en carpetas, renombrar, mover y eliminar archivos

Analytics

Analíticas a nivel de plataforma y por publicación

Inbox

Conversaciones, mensajes, respuestas, respuestas guardadas, resolver, suscripciones

Approvals

Listar, aprobar y rechazar publicaciones pendientes

Teams

Invitar, listar, actualizar y eliminar miembros; gestionar invitaciones

Biolinks

Crear y gestionar páginas de biolink, botones, publicaciones, temas y publicación

Settings

Perfil, organizaciones, inquilinos, claves de API, uso, facturación, código de referido

AI

Generar texto, imágenes y vídeo UGC/avatar; consultar historial, avatares, sonidos

Comments

Listar, añadir, editar, eliminar y marcar como leídos los comentarios de las publicaciones

Support

Abrir tickets, listar tickets, leer y enviar mensajes

Templates

Listar, inspeccionar y renderizar plantillas de contenido (memes, tarjetas de citas, testimonios)

Webhooks

Crear, listar, actualizar, probar, reintentar e inspeccionar entregas de webhooks

Billing

Consultar planes, funciones de los planes y complementos

Gestionar plantillas de WhatsApp Business, subir multimedia y enviar mensajes

Agent

Exportar el catálogo canónico de herramientas para OpenClaw, Hermes, OpenAI, Anthropic y MCP

Referencia de grupos de comandos

Grupo	Prefijo	Qué hace
Auth	`auth:`	Autenticarse (`auth:login`), comprobar el estado (`auth:status`), verificar la identidad (`auth:whoami`) y cerrar sesión (`auth:logout`)
Posts	`posts:`	Ciclo de vida completo de la publicación: `posts:create`, `posts:list`, `posts:get`, `posts:update`, `posts:schedule`, `posts:unschedule`, `posts:retry`, `posts:resubmit`, `posts:delete`, `posts:bulk-delete`, `posts:calendar`
Drafts	`drafts:`	`drafts:create`, `drafts:list`, `drafts:get`, `drafts:update`, `drafts:delete`, `drafts:convert`
Accounts	`accounts:`	`accounts:connect`, `accounts:list`, `accounts:get`, `accounts:get-details`, `accounts:remove`, `accounts:remove-by-id`
Media	`media:`	`media:upload`, `media:list`, `media:get`, `media:search`, `media:rename`, `media:move`, `media:delete`, `media:bulk-delete`, además de las operaciones de carpetas (`media:folders`, `media:create-folder`, `media:rename-folder`, `media:move-folder`)
Analytics	`analytics:`	`analytics:platform`, `analytics:post`
Inbox	`inbox:`	`inbox:list`, `inbox:messages`, `inbox:reply`, `inbox:read`, `inbox:resolve`, `inbox:delete`, respuestas guardadas (`inbox:saved-replies`, `inbox:create-reply`, `inbox:edit-reply`, `inbox:delete-reply`) y suscripciones de la bandeja extendida (`inbox:subscribe`, `inbox:unsubscribe`, `inbox:enable`, `inbox:disable`)
Approvals	`approvals:`	`approvals:list`, `approvals:approve`, `approvals:reject`
Teams	`teams:`	`teams:list`, `teams:invite`, `teams:invitations`, `teams:cancel-invite`, `teams:update`, `teams:remove`
Biolinks	`biolink:`	Páginas (`biolink:create`, `biolink:list`, `biolink:get`, `biolink:update`, `biolink:delete`, `biolink:publish`, `biolink:public`, `biolink:theme`, `biolink:analytics`), botones (`biolink:buttons`, `biolink:add-button`, `biolink:update-button`, `biolink:delete-button`, `biolink:reorder-buttons`) y publicaciones (`biolink:posts`, `biolink:add-post`, `biolink:update-post`, `biolink:delete-post`, `biolink:reorder-posts`)
Settings	`settings:`	Perfil (`settings:profile`, `settings:update-profile`), organizaciones (`settings:org`, `settings:create-org`, `settings:update-org`, `settings:delete-org`, `settings:leave-org`, `settings:tenants`), claves de API (`settings:api-keys`, `settings:create-api-key`, `settings:revoke-api-key`), `settings:usage`, `settings:billing`, `settings:referral-code`
AI	`ai:`	Texto (`ai:generate`, `ai:generate-and-schedule`, `ai:history`), imagen (`ai:image`, `ai:image:list`, `ai:image:get`, `ai:image:delete`), vídeo/UGC (`ai:video:generate`, `ai:video:list`, `ai:video:get`, `ai:video:delete`, `ai:video:avatars`, `ai:video:sounds`, `ai:video:hooks`)
Comments	`comments:`	`comments:list`, `comments:add`, `comments:update`, `comments:delete`, `comments:mark-read`
Support	`support:`	`support:create-ticket`, `support:list-tickets`, `support:get-ticket`, `support:list-messages`, `support:send-message`
Templates	`templates:`	`templates:list`, `templates:get`, `templates:render`
Webhooks	`webhooks:`	`webhooks:create`, `webhooks:list`, `webhooks:get`, `webhooks:update`, `webhooks:delete`, `webhooks:test`, `webhooks:retry`, `webhooks:deliveries`, `webhooks:events`
Billing	`billing:`	`billing:plans`, `billing:plan-features`, `billing:addons`
WhatsApp	`whatsapp:`	`whatsapp:templates`, `whatsapp:create-template`, `whatsapp:delete-template`, `whatsapp:upload-media`, `whatsapp:send`
Agent	`agent`	`agent export-tools`: obtiene el catálogo de herramientas MCP y lo emite en el formato de un agente de destino

Ejemplos rápidos

# Create and schedule a tweet
so-me posts:create -c "Launching today!" --platform TWITTER -s 2026-04-12T09:00:00Z

# Generate an AI caption for a platform
so-me ai:generate --prompt "Product launch announcement" --platform LINKEDIN

# Generate a caption and schedule it in one step
so-me ai:generate-and-schedule --prompt "Product launch announcement" --platform LINKEDIN

# Upload an image and list your media
so-me media:upload ./banner.png
so-me media:list --table

# Check platform analytics for the last 30 days
so-me analytics:platform acc-123 --days 30

# Show comments on a post
so-me comments:list <post-id>

# Check pending approvals
so-me approvals:list

# Export the agent tool catalog in every supported format
so-me agent export-tools --all --out ./agent-tools

# Pipe JSON output to jq
so-me posts:list | jq '.[].text'

Scripting y automatización

Aprende a usar la CLI en scripts de shell, pipelines de CI/CD y flujos de automatización.

Primeros pasos

Publicación

AI Studio

Bandeja de entrada e interacción

Analíticas

Biolink

Equipo y colaboración

Configuración y facturación

Webhooks

Soporte

CLI de redes sociales: programa publicaciones desde la terminal

Instalación

Autenticación

Opciones globales

Formatos de salida

Paginación

Variables de entorno

Grupos de comandos

Auth

Posts

Drafts

Accounts

Media

Analytics

Inbox

Approvals

Teams

Biolinks

Settings

AI

Comments

Support

Templates

Webhooks

Billing

WhatsApp

Agent

Referencia de grupos de comandos

Ejemplos rápidos

Scripting y automatización

​Instalación

​Autenticación

​Opciones globales

​Formatos de salida

​Paginación

​Variables de entorno

​Grupos de comandos

Auth

Posts

Drafts

Accounts

Media

Analytics

Inbox

Approvals

Teams

Biolinks

Settings

AI

Comments

Support

Templates

Webhooks

Billing

WhatsApp

Agent

​Referencia de grupos de comandos

​Ejemplos rápidos

Scripting y automatización

Instalación

Autenticación

Opciones globales

Formatos de salida

Paginación

Variables de entorno

Grupos de comandos

Referencia de grupos de comandos

Ejemplos rápidos