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

# Contas

> Conecte e gerencie contas de redes sociais

O grupo de comandos `accounts` permite listar, inspecionar, conectar e remover as contas
sociais do seu espaço de trabalho. Todos os comandos aceitam as flags globais (`--json` padrão,
`--table`, `--verbose`, `--api-key`, `--api-url`) e leem as credenciais de `SOME_API_KEY`
/ `SOME_API_URL` quando essas flags são omitidas.

## Plataformas compatíveis

Os comandos que recebem a flag `--platform` ou um argumento `<platform>` aceitam os seguintes
valores. `x` é um alias de `twitter`.

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

## accounts:list

Lista as contas sociais conectadas no seu espaço de trabalho. Os resultados são paginados.

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

| Opção | Descrição | Padrão |
| - | - | - |
| `--page <number>` | Número da página | `1` |
| `--limit <number>` | Itens por página | `50` |
| `--search <query>` | Filtra por nome | – |

```bash Exemplos theme={null}
# Listar a primeira página de contas
so-me accounts:list

# Exibir como tabela
so-me accounts:list --table

# Buscar por nome com uma página maior
so-me accounts:list --search acme --limit 100 --page 1
```

## accounts:get

Obtém os detalhes de uma conta específica pelo ID, nome da plataforma ou nome de usuário.

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

| Argumento | Descrição |
| - | - |
| `<id-or-platform>` | UUID da conta, nome da plataforma (`twitter`, `linkedin` etc.) ou nome de usuário / nome da conta **(obrigatório)** |

Comportamento de resolução:

* **Nome da plataforma**: retorna todas as contas dessa plataforma. Quando exatamente uma corresponde,
  a conta única é retornada; caso contrário, a lista completa de correspondências é retornada.
* **Nome de usuário / nome da conta**: comparado com o nome de usuário ou o nome de exibição da conta
  e, em seguida, buscado pelo ID resolvido.
* **UUID**: quando o argumento é um UUID válido e nenhum nome de usuário corresponde, ele é
  consultado diretamente pelo ID.

Se nada corresponder, uma mensagem informativa é exibida e nenhuma conta é retornada.

```bash Exemplos theme={null}
# Pelo nome da plataforma (retorna todas as contas correspondentes)
so-me accounts:get twitter

# Pelo nome de usuário / nome da conta
so-me accounts:get @yourhandle

# Pelo ID da conta
so-me accounts:get 550e8400-e29b-41d4-a716-446655440000
```

## accounts:get-details

Obtém todos os detalhes de uma conta social específica pelo UUID exato. Ao contrário de
[`accounts:get`](#accountsget), este comando aceita apenas um UUID e não resolve
por plataforma ou nome de usuário.

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

| Argumento | Descrição |
| - | - |
| `<id>` | UUID da conta **(obrigatório)** |

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

## accounts:connect

Conecta uma nova conta social por OAuth no navegador, usando um fluxo de autorização de dispositivo.

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

| Opção | Descrição |
| - | - |
| `--platform <platform>` | Plataforma a conectar: `twitter`, `x`, `linkedin`, `linkedin_page`, `instagram`, `facebook`, `tiktok`, `youtube`, `threads`, `pinterest`, `whatsapp`, `dribbble` **(obrigatório)** |

> [!NOTE]
>
> Você precisa estar autenticado antes de conectar uma conta. Execute `so-me auth:login` primeiro se
> a CLI informar que você não está autenticado.

Ao executar o comando, uma URL de verificação e um código de usuário são exibidos. A CLI tenta
abrir a URL no seu navegador automaticamente e depois consulta repetidamente até que a conta seja conectada
ou o código de dispositivo expire.

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

```bash Saída 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]
>
> Se o código expirar antes de você concluir o fluxo, a CLI termina com erro. Execute
> `so-me accounts:connect` novamente para obter um novo código.

## accounts:remove

Remove uma conta social conectada pelo nome da plataforma. Se houver várias contas para a
plataforma, você é solicitado a selecionar uma e, depois, a confirmar antes da exclusão.

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

| Argumento | Descrição |
| - | - |
| `<platform>` | Nome da plataforma: `twitter`, `x`, `linkedin`, `linkedin_page`, `instagram`, `facebook`, `tiktok`, `youtube`, `threads`, `pinterest`, `whatsapp`, `dribbble` **(obrigatório)** |

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

Se não houver contas para a plataforma, uma mensagem informativa é exibida e nada é
removido. Para ignorar a busca pela plataforma e a seleção interativa, use
[`accounts:remove-by-id`](#accountsremove-by-id).

## accounts:remove-by-id

Remove diretamente uma conta social usando seu UUID interno. É útil quando você tem várias
contas na mesma plataforma ou quer pular a seleção interativa.

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

| Argumento | Descrição |
| - | - |
| `<id>` | UUID da conta **(obrigatório)** |

| Opção | Descrição |
| - | - |
| `-y, --yes` | Ignora a confirmação |

```bash Exemplos theme={null}
# Confirmar de forma interativa
so-me accounts:remove-by-id 550e8400-e29b-41d4-a716-446655440000

# Ignorar a confirmação
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.