---
title: "AdaptlyPost CLI"
description: "Instale o CLI do AdaptlyPost, inicie sessão com um token de API e comande todo o AdaptlyPost do seu terminal ou de um script. Saída JSON e códigos de saída..."
url: "https://adaptlypost.com/pt/features/cli/docs"
---

[Voltar aos agentes de IA](https://adaptlypost.com/pt/features/agents)

# AdaptlyPost CLI

Comande o AdaptlyPost do seu terminal ou de um script. Um binário só, sem runtime para manter, e cada comando pode imprimir JSON.

## Instalação

Escolha a que servir à sua máquina. O Homebrew e o script curl instalam um binário autónomo, por isso não é preciso Node.

npm

```
npm install -g @adaptlypost/cli
```

Homebrew (macOS, Linux)

```
brew trust adaptlypost/tap && brew install adaptlypost/tap/adaptlypost
```

Script de instalação (macOS, Linux)

```
curl -fsSL https://adaptlypost.com/install.sh | sh
```

Executar uma vez, sem instalar

```
npx -p @adaptlypost/cli adaptlypost --help
```

O Homebrew 7 recusa carregar uma fórmula de um tap de terceiros enquanto não a aprovar, que é o que o brew trust faz. Sem esse passo, install e upgrade param com «Refusing to load formula from untrusted tap».

A instalação deixa dois nomes para o mesmo programa. O curto é `apost`.

## Autenticação

Crie um token de API e passe-o ao login. Os tokens ficam nas definições do seu espaço de trabalho: [API e agentes de IA](https://adaptlypost.com/pt/api-tokens).

```
adaptlypost login
```

O comando abre a página de tokens, lê o token num campo oculto, verifica localmente o prefixo `adaptly_` e confirma-o com uma chamada à API antes de o gravar em disco com modo 0600\. Se a verificação falhar, nada é guardado.

Em CI, passe o token por um pipe e salte a pergunta

```
echo "$MY_SECRET" | adaptlypost login --token-stdin
```

Ou não guarde nada e passe-o em cada comando

```
ADAPTLYPOST_API_TOKEN=adaptly_your_token adaptlypost whoami
```

## Começar depressa

Agendar uma publicação em duas plataformas. Os identificadores de conta vêm de adaptlypost accounts list.

```
adaptlypost post --caption "Shipping today"   --accounts acc_123 --platforms LINKEDIN,TWITTER   --schedule "2026-10-02T09:00:00Z"
```

## Comandos

Todos os comandos aceitam --help, e quase todos aceitam --json. Corra adaptlypost doctor se algo parecer errado.

Entrar

| adaptlypost login  | Guardar um token de API nesta máquina, depois de confirmar que funciona |
| ------------------ | ----------------------------------------------------------------------- |
| adaptlypost logout | Remover o token guardado                                                |
| adaptlypost whoami | Mostrar que token está em uso e a que dá acesso                         |

Trabalho do dia a dia

| adaptlypost post      | Criar, agendar, publicar, editar e apagar publicações      |
| --------------------- | ---------------------------------------------------------- |
| adaptlypost accounts  | Listar as contas sociais ligadas e os seus identificadores |
| adaptlypost analytics | Alcance, interação e repartição por plataforma             |
| adaptlypost media     | Carregar imagens e vídeo para uma publicação               |

Saídas de emergência

| adaptlypost api  | Enviar um pedido autenticado a qualquer endpoint da API   |
| ---------------- | --------------------------------------------------------- |
| adaptlypost mcp  | Imprimir a configuração do servidor MCP para o seu editor |
| adaptlypost open | Abrir uma página da aplicação web no seu navegador        |

Esta máquina

| adaptlypost config     | Ler e alterar as preferências do CLI                         |
| ---------------------- | ------------------------------------------------------------ |
| adaptlypost doctor     | Verificar esta máquina, os ficheiros de configuração e a API |
| adaptlypost completion | Imprimir o script de conclusão da shell                      |

Cada comando lista as suas próprias opções em `adaptlypost <command> --help`.

## Scripts

Junte --json a qualquer comando e recebe um invólucro estável com ok, command e data, pronto para o jq.

```
adaptlypost whoami --json
```

Raramente precisa da opção. A saída passa a JSON sozinha quando o stdout não é um terminal ou quando CI está definido, por isso um comando num pipe já devolve JSON.

Códigos de saída

| 0 | Sucesso                                                            |
| - | ------------------------------------------------------------------ |
| 2 | Erro de utilização, por exemplo uma opção em falta ou desconhecida |
| 3 | O token foi recusado ou falta                                      |
| 4 | Nada corresponde a esse identificador                              |
| 5 | A API recusou os dados                                             |
| 7 | Pedidos a mais                                                     |
| 8 | Falha de rede ou tempo esgotado                                    |
| 9 | Limite do plano ou da quota atingido                               |

## Próximos passos

Crie um token, ou ligue a mesma conta a um agente de IA.

[Criar um token de API](https://adaptlypost.com/pt/api-tokens)[Agentes de IA e MCP](https://adaptlypost.com/pt/features/agents)