> ## Documentation Index
> Fetch the complete documentation index at: https://docs.so-me.studio/llms.txt
> Use this file to discover all available pages before exploring further.

# CLI de redes sociales: programa publicaciones desde la terminal

> Instala la CLI de Social media studio para programar publicaciones, gestionar borradores y multimedia, y consultar analíticas desde tu terminal o tus scripts con tu clave de API.

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 |

> [!NOTE]
>
> 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

```bash npm theme={null}
npm install -g @social-media-scheduler/cli
```

```bash pnpm theme={null}
pnpm add -g @social-media-scheduler/cli
```

```bash yarn theme={null}
yarn global add @social-media-scheduler/cli
```

```bash npx (sin instalar) theme={null}
npx @social-media-scheduler/cli posts:list
```

> [!NOTE]
>
> Requiere **Node.js >= 20.0.0**.

## Autenticación

Necesitas una clave de API para usar la CLI. Consulta [Autenticación](/es/authentication.md) para generar una.

**Clave de API (recomendado)**

```bash theme={null}
so-me auth:login --api-key sk_live_xxxxxxxxxxxxxxxxxxxxxxxx
```

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

**Inicio de sesión en el navegador (device flow)**

```bash theme={null}
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.

**Variable de entorno**

```bash theme={null}
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:

```bash theme={null}
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)**

```bash theme={null}
so-me posts:list
```

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

**Tabla**

```bash theme={null}
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 |

```bash theme={null}
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](/es/cli/auth.md)**
>
> Inicio de sesión (clave de API o device flow), cierre de sesión, estado, whoami

> **[Posts](/es/cli/posts.md)**
>
> Crear, programar, actualizar, reintentar, reenviar y eliminar publicaciones; vista de calendario

> **[Drafts](/es/cli/drafts.md)**
>
> Crear, actualizar y eliminar borradores y convertirlos en publicaciones programadas

> **[Accounts](/es/cli/accounts.md)**
>
> Conectar, listar, inspeccionar y eliminar cuentas sociales

> **[Media](/es/cli/media.md)**
>
> Subir, buscar, organizar en carpetas, renombrar, mover y eliminar archivos

> **[Analytics](/es/cli/analytics.md)**
>
> Analíticas a nivel de plataforma y por publicación

> **[Inbox](/es/cli/inbox.md)**
>
> Conversaciones, mensajes, respuestas, respuestas guardadas, resolver, suscripciones

> **[Approvals](/es/cli/approvals.md)**
>
> Listar, aprobar y rechazar publicaciones pendientes

> **[Teams](/es/cli/teams.md)**
>
> Invitar, listar, actualizar y eliminar miembros; gestionar invitaciones

> **[Biolinks](/es/cli/biolinks.md)**
>
> Crear y gestionar páginas de biolink, botones, publicaciones, temas y publicación

> **[Settings](/es/cli/settings.md)**
>
> Perfil, organizaciones, inquilinos, claves de API, uso, facturación, código de referido

> **[AI](/es/cli/ai.md)**
>
> Generar texto, imágenes y vídeo UGC/avatar; consultar historial, avatares, sonidos

> **[Comments](/es/cli/comments.md)**
>
> Listar, añadir, editar, eliminar y marcar como leídos los comentarios de las publicaciones

> **[Support](/es/cli/support.md)**
>
> Abrir tickets, listar tickets, leer y enviar mensajes

> **[Templates](/es/cli/templates.md)**
>
> Listar, inspeccionar y renderizar plantillas de contenido (memes, tarjetas de citas, testimonios)

> **[Webhooks](/es/cli/webhooks.md)**
>
> Crear, listar, actualizar, probar, reintentar e inspeccionar entregas de webhooks

> **[Billing](/es/cli/billing.md)**
>
> Consultar planes, funciones de los planes y complementos

> **[WhatsApp](/es/cli/whatsapp.md)**
>
> Gestionar plantillas de WhatsApp Business, subir multimedia y enviar mensajes

> **[Agent](/es/mcp/overview.md)**
>
> 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

```bash theme={null}
# 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](/es/cli/scripting.md)**
>
> Aprende a usar la CLI en scripts de shell, pipelines de CI/CD y flujos de automatización.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.