PostNitro CLI — Crie e agende publicações em redes sociais a partir do seu terminal.
Um único comando, uma publicação personalizada. A CLI do PostNitro cria carrosséis personalizados, publicações com uma única imagem e vídeos curtos, adiciona opcionalmente imagens geradas por IA e agenda tudo para o LinkedIn, Instagram, TikTok e Threads — sem precisar de navegador, ferramenta de design ou qualquer etapa manual. Todos os comandos são em JSON, o que torna o processo tão fácil para agentes de IA e pipelines de CI quanto para você.
npm install -g @postnitro/cli — e seu terminal se transforma em um estúdio de conteúdo.
Pacote
@postnitro/cli no npm
Interface
Entrada JSON, saída JSON — seguro para scripts
Cria
Carrosséis, imagens e vídeos — PNG/PDF/MP4
Horários para
LinkedIn, Instagram, TikTok, Threads
Por que incluir um mecanismo de conteúdo no seu terminal?
Postar sem sair da área de cobertura
"postnitro carousel generate --context '5 dicas de trabalho remoto' --wait" é um carrossel finalizado, alinhado à identidade visual da marca e pronto para download. Sem abas, sem arrastar e soltar, sem caixa de diálogo de exportação.
Desenvolvido para agentes de IA
JSON limpo na saída padrão (stdout), erros JSON na saída de erro padrão (stderr), sem cores ou prompts interativos para decifrar. Claude Code, Cursor e qualquer agente que possa executar comandos shell podem controlá-lo de forma confiável — ou instale-o como uma habilidade e deixe o agente aprender sozinho.
Automatize em CI e Cron
Publique anúncios de lançamento a partir do seu pipeline de implantação ou execute uma tarefa noturna que transforme o calendário de conteúdo de amanhã em publicações agendadas. Os códigos de saída e a saída JSON facilitam a detecção de falhas.
A IA escreve — ou você escreve.
Gere a partir de um tópico, um URL de artigo ou uma publicação X, ou importe seu próprio JSON de slides para ter controle total — incluindo layouts de infográficos com colunas de dados. Ambos os caminhos funcionam com seus modelos e kit de identidade visual.
Imagens de IA, a um passo de distância
Adicione --generate-images com uma breve descrição visual e imagens geradas por IA serão criadas e incorporadas aos seus slides antes da renderização — sejam elas de fundo, em slides estratégicos ou em todos eles.
Da ideia à publicação agendada em um único comando
O comando `generate-and-schedule` gera o conteúdo, aguarda a renderização e o agenda no seu calendário com legendas específicas para cada plataforma — e o comando `import-and-schedule` faz o mesmo para seus próprios slides. Um fluxo de trabalho de conteúdo completo em um único comando do terminal.
Defina as configurações padrão uma vez e depois esqueça-as.
Salve seu modelo, marca, predefinição e formato de saída com as configurações padrão definidas. Qualquer comando posterior precisará apenas do conteúdo — e se seu espaço de trabalho tiver exatamente um candidato, a CLI o selecionará automaticamente.
Mesma chave, mesmos créditos, todas as superfícies.
A CLI é uma interface simples que envolve a API Embed e compartilha sua chave e saldo de créditos com a API REST e o servidor MCP. Inicie no terminal e alterne entre as interfaces quando quiser.
Instalação em segundos
Requer Node.js, versão 18+ e uma conta PostNitro em um plano pago.
Do zero a uma publicação agendada em quatro comandos
1. Autentique-se uma vez
Obtenha sua chave de API em PostNitro → Perfil → Incorporar → Gerar chave de API e salve-a. Você também pode usar a variável de ambiente POSTNITRO_API_KEY ou o parâmetro --api-key por comando (recomendado para integração contínua).
2. Salve suas configurações padrão.
Liste seus modelos, marcas e predefinições de IA e salve seus favoritos para que os comandos de criação precisem apenas do conteúdo desejado.
3. Gere — e receba os arquivos de volta
--wait aguarda até que a renderização termine e imprime o JSON final: URLs de arquivos, um designId para agendamento e um link direto editorUrl para continuar editando no PostNitro.
4. Agende — o PostNitro publica para você.
Pegue o designId da saída e agende a publicação para suas contas conectadas do LinkedIn, Instagram, TikTok ou Threads — ou salve como rascunho. Esse é todo o processo: ideia → design → publicação agendada, sem sair do terminal.
Não basta criar publicações — agende-as também.
Criar o design da publicação é apenas metade do trabalho, por isso o PostNitro agora faz o resto: agende publicações ou salve rascunhos diretamente no LinkedIn, Instagram, TikTok e Threads, com legendas e configurações específicas para cada plataforma. Gere ou importe um design, associe-o a um horário e o PostNitro publica para você — pela API, pelo servidor MCP ou pela CLI, sem precisar de uma ferramenta de agendamento separada.
Fluxos de trabalho reais, prontos para copiar e colar
Transforme uma publicação de blog em um carrossel do LinkedIn
Aponte o artigo para um URL e a IA extrairá os pontos principais em slides interativos.
Gere e agende em uma única operação.
Conteúdo escrito, design renderizado, publicação agendada — um único comando. Se o agendamento falhar, você recebe o ID do design de volta para que possa tentar novamente sem gastar créditos.
Importe e agende tudo de uma vez.
A contrapartida do lado da importação: seus slides exatos são transferidos de JSON para uma publicação agendada em um único comando. A mesma segurança é garantida — se o agendamento falhar após a importação ser bem-sucedida, você recebe o designId de volta para tentar novamente sem gastar créditos.
Importe seus próprios slides
Controle editorial completo: envie seus slides como JSON embutido ou a partir de um arquivo, e o PostNitro os renderiza em seu modelo e identidade visual.
Uma publicação com uma única imagem ilustrada por IA.
As postagens de imagens espelham os carrosséis — um único objeto de slide em vez de uma matriz, com as mesmas opções de IA para imagens disponíveis.
Agende um design que você já tem.
A criação gera um ID de design; o agendamento o vincula ao seu calendário com legendas específicas para cada plataforma. Gerencie toda a fila — listar, atualizar, excluir — sem sair do terminal.
Comece agora, busque depois
Ignore --wait para gerações longas ou trabalhos em lote: a criação retorna um embedPostId imediatamente, e o status/saída recuperam o resultado quando você estiver pronto.
Feito para agentes de IA
A interface de linha de comando (CLI) foi projetada priorizando o agente: flags previsíveis, saída legível por máquina e ações destrutivas protegidas pelo parâmetro `--yes`. Instale a skill PostNitro e seu agente de codificação aprenderá todo o fluxo de trabalho — descoberta, configurações padrão, criação, agendamento — sem que você precise escrever uma única linha de comando.
- JSON na saída padrão (código de saída 0) em caso de sucesso; erros JSON estruturados na saída de erro padrão (código de saída 1).
- Sem prompts interativos, roletas, cores ou tabelas — nada que possa confundir um analisador sintático.
- Entrada JSON ou de arquivo embutida para payloads complexos; a entrada embutida é sempre a melhor opção.
- Instale através do comando "npx skills add postnitro/postnitro-agent" ou como um plugin do Claude Code.
A superfície de comando completa
Tudo o que a API Embed pode fazer, como comandos combináveis. Execute qualquer comando com --help para obter detalhes.
| Group | Commands | What it's for |
|---|---|---|
| Configurar | auth set-key · auth status · auth clear · defaults get · defaults set | Salve sua chave de API e os modelos, marcas, predefinições e formatos de saída padrão. |
| Descoberta | Lista de modelos · Lista de marcas · Lista de predefinições · Lista de redes sociais | Encontre os IDs dos seus modelos, kits de marca, predefinições de IA e contas de redes sociais conectadas. |
| Carrosséis | Gerar carrossel · Importar carrossel · Status do carrossel · Saída do carrossel · Modelo de importação de carrossel | Crie publicações com vários slides usando IA ou seus próprios slides e obtenha resultados. |
| Postagens de imagens | Geração de imagem · Importação de imagem · Status da imagem · Saída de imagem · Modelo de importação de imagem | Os equivalentes de imagem única — mesmas flags, um objeto de slide em vez de uma matriz. |
| Vídeos | Geração de vídeo · Importação de vídeo · Status do vídeo · Saída de vídeo · Modelo de importação de vídeo | Transforme slides em um vídeo — cada slide é uma cena. Adiciona os parâmetros --video-duration e --audio-id; renderiza em MP4 ou interrompe a renderização no design. |
| Áudio | lista de áudio · excluir áudio | Resolva o problema do ID de áudio necessário para um vídeo ou reel e remova as faixas que você não usa mais. O upload é feito no aplicativo PostNitro. |
| Kits de marca | Criar marca · Obter marca · Atualizar marca | Gerencie o logotipo, o nome e a identificação impressos em seus designs. |
| Agendamento | Criar agendamento · Lista de agendamentos · Obter agendamento · Atualizar agendamento · Excluir agendamento | Publique conteúdo e rascunhos com legendas e configurações específicas para cada plataforma; gerencie a fila. |
| Histórias curtas | gerar e agendar · importar e agendar | Crie, aguarde e agende em um único comando — para carrosséis ou publicações de imagens. |
| Contas de redes sociais | lista social · obter social · desconectar social | Inspecione as contas conectadas do LinkedIn, Instagram, TikTok e Threads. |
Erros que seus scripts realmente conseguem lidar
Cada falha é um objeto JSON estruturado no stderr com um código de saída diferente de zero — sem necessidade de analisar o texto do log, sem adivinhações. Seu pipeline ramifica com base no status de saída; seu agente lê a mensagem e corrige a própria chamada.
| Erro comum | Consertar |
|---|---|
Nenhuma chave de API encontrada | Passe --api-key, defina POSTNITRO_API_KEY ou execute auth set-key |
--brand-id ausente ... vários candidatos | Passe o ID explicitamente ou salve um com os valores padrão definidos — a mensagem de erro lista os candidatos. |
O horário agendado já passou. | Use um horário ISO-8601 com pelo menos 5 minutos de antecedência, com um Z à direita. |
Os slides devem ser uma matriz com pelo menos 3 entradas. | Forneça slides de abertura, desenvolvimento e encerramento. |
Uma postagem IMAGEM aceita um único objeto de slide, não uma matriz. | Use --slide (objeto) para imagens, --slides (matriz) para carrosséis. |
Recusar-se a excluir ... sem --sim | Adicione `--yes` para confirmar ações destrutivas — nada destrutivo é executado por acidente. |
Seu terminal agora pode publicar no LinkedIn.
Instale a CLI, salve suas configurações padrão e transforme qualquer tópico, artigo ou calendário de conteúdo em publicações agendadas e alinhadas à sua marca — seja pelo terminal, por um script ou pelo seu agente de IA.
Obtenha sua chave de APIQuatro formatos de saída
Um único documento — o padrão e o formato ideal para publicações de documentos no LinkedIn.
Uma imagem por slide, pronta para upload direto em qualquer lugar.
Ignora completamente a renderização e retorna o design editável — a opção mais rápida quando você só precisa agendar ou continuar editando.
Um vídeo renderizado — somente postagens em vídeo, e o único formato renderizado aceito. Precisa ter uma duração (de 5 a menos de 60 segundos); uma faixa de áudio é opcional.
Cada saída concluída inclui um designId (o que o agendamento espera) e um link direto editorUrl para abrir o design no editor do PostNitro. O tipo de resposta não altera o custo em créditos. O formato MP4 é exclusivo para postagens de vídeo, e um vídeo aceita apenas MP4 ou DESIGN.
Créditos e Preços
| Plan | Price | Credits/Month | Typical Usage |
|---|---|---|---|
| Mensal | US$ 10/mês | 250 créditos/mês | Acesso total à CLI e automação regular. |
| Níveis superiores | Veja a página de plantas | Mais créditos | Equipes, agências e fluxos de trabalho de alto volume |
| Operation | Credits per Slide |
|---|---|
| Importação de conteúdo | 1 crédito por slide |
| Geração de IA | 2 créditos por slide |
A CLI compartilha créditos com a API Embed e o servidor MCP. Imagens geradas por IA utilizam uma cota de imagens separada da organização e não alteram o custo de créditos da publicação.
Get Your API KeyCLI vs MCP vs API Embed vs SDK Embed
CLI | Servidor MCP | API de incorporação | SDK de incorporação | |
|---|---|---|---|---|
| Ideal para | Fluxos de trabalho de terminal, scripts de shell, CI e agentes que executam comandos shell. | Assistentes de IA criando posts de forma conversacional | Plataformas de automação sem código e back-ends personalizados | Permitir que seus usuários criem carrosséis dentro do seu aplicativo. |
| Interface | Comandos com flags — JSON in, JSON out | Linguagem natural por meio de um cliente MCP | REST sobre HTTPS | Editor visual incorporável |
| Configurar | npm install -g @postnitro/cli | Um bloco de configuração ou comando CLI | Chave de API + qualquer cliente HTTP | Pacote npm + chave de API |
| Agendamento | Sim — incluindo geração e agendamento únicos. | Sim — CRUD completo via ferramentas. | Sim — através da API de Agendamento. | Não — apenas design |
| Mesma chave e créditos | Sim | Sim | Sim | Sim |
Todos usam o mesmo mecanismo. Utilize a CLI em terminais e pipelines, o MCP em assistentes de IA, a API REST a partir do seu próprio código e o SDK quando seus usuários precisarem de um editor visual.
Frequently Asked Questions
A um comando de distância do conteúdo automatizado
Execute o comando `npm install -g @postnitro/cli` e, em seguida, gere, renderize e agende seu primeiro carrossel em menos de cinco minutos.
Obtenha sua chave de API