> ## 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.

# Cuentas

> Conecta y gestiona cuentas de redes sociales

El grupo de comandos `accounts` te permite listar, inspeccionar, conectar y eliminar las cuentas
sociales de tu espacio de trabajo. Todos los comandos aceptan las opciones globales (`--json` por defecto,
`--table`, `--verbose`, `--api-key`, `--api-url`) y leen las credenciales de `SOME_API_KEY`
/ `SOME_API_URL` cuando se omiten esas opciones.

## Plataformas admitidas

Los comandos que reciben la opción `--platform` o un argumento `<platform>` aceptan los siguientes
valores. `x` es un alias de `twitter`.

| Valor | Plataforma |
| - | - |
| `twitter` (o `x`) | Twitter / X |
| `linkedin` | LinkedIn (personal) |
| `linkedin_page` | Página de LinkedIn |
| `instagram` | Instagram |
| `facebook` | Facebook |
| `tiktok` | TikTok |
| `youtube` | YouTube |
| `threads` | Threads |
| `pinterest` | Pinterest |
| `whatsapp` | WhatsApp |
| `dribbble` | Dribbble |

## accounts:list

Lista las cuentas sociales conectadas en tu espacio de trabajo. Los resultados están paginados.

```bash theme={null}
so-me accounts:list [options]
```

| Opción | Descripción | Por defecto |
| - | - | - |
| `--page <number>` | Número de página | `1` |
| `--limit <number>` | Elementos por página | `50` |
| `--search <query>` | Filtra por nombre | – |

```bash Ejemplos theme={null}
# List the first page of accounts
so-me accounts:list

# Render as a table
so-me accounts:list --table

# Search by name with a larger page size
so-me accounts:list --search acme --limit 100 --page 1
```

## accounts:get

Obtiene los detalles de una cuenta concreta por su ID, nombre de plataforma o nombre de usuario.

```bash theme={null}
so-me accounts:get <id-or-platform>
```

| Argumento | Descripción |
| - | - |
| `<id-or-platform>` | UUID de la cuenta, nombre de plataforma (`twitter`, `linkedin`, etc.) o nombre de usuario / nombre de la cuenta **(obligatorio)** |

Comportamiento de la resolución:

* **Nombre de plataforma**: devuelve todas las cuentas de esa plataforma. Cuando coincide exactamente una,
  se devuelve esa cuenta; en otro caso, se devuelve la lista completa de coincidencias.
* **Nombre de usuario / nombre de la cuenta**: se compara con el nombre de usuario o el nombre visible de la cuenta
  y luego se obtiene por su ID resuelto.
* **UUID**: cuando el argumento es un UUID válido y no se encuentra ninguna coincidencia por nombre de usuario, se
  busca directamente por ID.

Si nada coincide, se imprime un mensaje informativo y no se devuelve ninguna cuenta.

```bash Ejemplos theme={null}
# By platform name (returns all matching accounts)
so-me accounts:get twitter

# By username / account name
so-me accounts:get @yourhandle

# By account ID
so-me accounts:get 550e8400-e29b-41d4-a716-446655440000
```

## accounts:get-details

Obtiene todos los detalles de una cuenta social concreta por su UUID exacto. A diferencia de
[`accounts:get`](#accountsget), este comando solo acepta un UUID y no resuelve
por plataforma ni por nombre de usuario.

```bash theme={null}
so-me accounts:get-details <id>
```

| Argumento | Descripción |
| - | - |
| `<id>` | UUID de la cuenta **(obligatorio)** |

```bash Ejemplo theme={null}
so-me accounts:get-details 550e8400-e29b-41d4-a716-446655440000
```

## accounts:connect

Conecta una cuenta social nueva mediante OAuth en el navegador con un flujo de autorización de dispositivo.

```bash theme={null}
so-me accounts:connect --platform <platform>
```

| Opción | Descripción |
| - | - |
| `--platform <platform>` | Plataforma que se conecta: `twitter`, `x`, `linkedin`, `linkedin_page`, `instagram`, `facebook`, `tiktok`, `youtube`, `threads`, `pinterest`, `whatsapp`, `dribbble` **(obligatorio)** |

> [!NOTE]
>
> Debes estar autenticado antes de conectar una cuenta. Ejecuta primero `so-me auth:login` si
> la CLI indica que no estás autenticado.

Al ejecutar el comando se muestran una URL de verificación y un código de usuario. La CLI intenta
abrir la URL en tu navegador automáticamente y luego consulta periódicamente hasta que la cuenta se conecta
o el código de dispositivo caduca.

```bash Ejemplo theme={null}
so-me accounts:connect --platform instagram
```

```bash Salida theme={null}
  To connect your account, open this URL in your browser:

  https://so-me.studio/cli/authorize

  And enter this code:

  ABCD-1234

  Code expires in 10 minutes.
  Browser opened automatically.
  Waiting for account connection...
  Account connected!

  Connected instagram account: @yourhandle
```

> [!WARNING]
>
> Si el código caduca antes de que completes el flujo, la CLI termina con un error. Ejecuta
> `so-me accounts:connect` de nuevo para obtener un código nuevo.

## accounts:remove

Elimina una cuenta social conectada por nombre de plataforma. Si existen varias cuentas de la
plataforma, se te pide que elijas una y después que confirmes antes de eliminarla.

```bash theme={null}
so-me accounts:remove <platform>
```

| Argumento | Descripción |
| - | - |
| `<platform>` | Nombre de la plataforma: `twitter`, `x`, `linkedin`, `linkedin_page`, `instagram`, `facebook`, `tiktok`, `youtube`, `threads`, `pinterest`, `whatsapp`, `dribbble` **(obligatorio)** |

```bash Ejemplo theme={null}
so-me accounts:remove twitter
```

Si no existen cuentas de la plataforma, se imprime un mensaje informativo y no se elimina nada. Para omitir
la búsqueda por plataforma y la selección interactiva, usa
[`accounts:remove-by-id`](#accountsremove-by-id).

## accounts:remove-by-id

Elimina directamente una cuenta social usando su UUID interno; es útil cuando tienes varias
cuentas en la misma plataforma o quieres omitir la selección interactiva.

```bash theme={null}
so-me accounts:remove-by-id <id> [options]
```

| Argumento | Descripción |
| - | - |
| `<id>` | UUID de la cuenta **(obligatorio)** |

| Opción | Descripción |
| - | - |
| `-y, --yes` | Omite la confirmación |

```bash Ejemplos theme={null}
# Confirm interactively
so-me accounts:remove-by-id 550e8400-e29b-41d4-a716-446655440000

# Skip confirmation
so-me accounts:remove-by-id 550e8400-e29b-41d4-a716-446655440000 -y
```


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