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.

# Install globally from npm (recommended)
npm install -g @postnitro/cli
postnitro --help

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

postnitro auth set-key pn-xxxxxxxxxxxx   # save it once
postnitro auth status                    # check what's configured (key is masked)

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.

postnitro template list && postnitro brand list && postnitro preset list
postnitro defaults set --template-id tpl_123 --brand-id brd_456 --preset-id prs_789

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.

postnitro carousel generate --context "5 tips for remote work" --wait
# => { "designId": "dsg_abc", "editorUrl": "https://postnitro.ai/app/...", "data": [...] }

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.

postnitro schedule create \
  --status SCHEDULED --scheduled-at "2026-07-25T09:00:00Z" \
  --design-id dsg_abc \
  --selected-accounts '["acct_123"]' \
  --post-content '{"common":"5 tips for remote work 🚀 #remotework"}'

Novo

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.

Instagram

TikTok

Threads

Leia a documentação da API de agendamento.Explorar o agendamento

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.

postnitro carousel generate \
  --context "https://yourblog.com/post" --type article --wait

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.

postnitro generate-and-schedule \
  --context "How AI agents automate content" --type text \
  --status SCHEDULED --scheduled-at "2026-12-31T12:00:00Z" \
  --selected-accounts '["acct_123"]' \
  --linkedin-post-settings '{"postType":"document","postTitle":"How AI agents automate content"}' \
  --post-content '{"common":"New drop 🚀 #ai #automation"}'

Importe e agende tudo de uma vez.

A contrapartida do lado da importação: seus slides exatos passam de JSON para uma publicação agendada em um único comando. A mesma garantia de segurança — 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.

postnitro import-and-schedule \
  --slides '{"slides":[
    {"type":"starting_slide","heading":"Our 2026 Results","description":"The numbers behind the year"},
    {"type":"body_slide","heading":"+42% Revenue","description":"Year over year growth"},
    {"type":"ending_slide","heading":"Full report on our blog","cta_button":"Read it"}
  ]}' \
  --status SCHEDULED --scheduled-at "2026-12-31T12:00:00Z" \
  --selected-accounts '["acct_123"]' \
  --post-content '{"common":"Our year in numbers 📊 #growth"}'

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.

postnitro carousel import --slides '{"slides":[
  {"type":"starting_slide","heading":"Your Title","description":"Intro"},
  {"type":"body_slide","heading":"Key Point","description":"Details"},
  {"type":"ending_slide","heading":"Take Action!","cta_button":"Learn More"}
]}' --wait

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.

postnitro image generate --context "Announce our new scheduling feature" \
  --generate-images --image-context "upbeat and professional, product-focused" --wait

Agende um projeto que você já tenha.

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.

postnitro schedule create \
  --status SCHEDULED --scheduled-at "2026-12-31T13:00:00Z" \
  --design-id dsg_abc \
  --selected-accounts '["acct_123"]' \
  --post-content '{"common":"New carousel 🚀 #remotework"}'

postnitro schedule list --from "2026-12-01" --to "2026-12-31"

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.

postnitro carousel generate --context "5 tips for remote work"
# => { "success": true, "data": { "embedPostId": "post_123", "status": "PENDING" } }

postnitro carousel status post_123   # PENDING → PROCESSING → COMPLETED
postnitro carousel output post_123   # file URLs + designId + editorUrl

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 um prompt.

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

{ "success": false, "error": { "message": "PostNitro API error (422): Scheduled at is in the past", "statusCode": 422 } }

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.

Três formatos de saída

PDF

Um único documento — o padrão e o formato ideal para publicações de documentos no LinkedIn.

PNG

Uma imagem por slide, pronta para upload direto em qualquer lugar.

PROJETO

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.

Cada saída concluída inclui um designId (o que o agendamento espera) e um link direto editorUrl para abrir o projeto no editor PostNitro. O tipo de resposta não altera o custo em créditos.

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 Key

CLI 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

O que é o PostNitro CLI?

Como faço para instalar?

Preciso de um plano pago?

Como funciona a autenticação?

Os agentes de IA podem usar a CLI?

Qual a diferença entre gerar e importar?

Como faço para agendar uma publicação que acabei de criar?

A interface de linha de comando (CLI) consegue gerar imagens com inteligência artificial para meus slides?

Quais formatos de saída ele suporta?

O que acontece quando um comando falha?

A CLI é de código aberto?

Quando devo usar a CLI em vez do servidor MCP?

Related Resources

CLI Documentation MCP Server Embed API Embed SDK Pricing & Plans

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 e publicações com uma única imagem, adiciona opcionalmente imagens geradas por IA e agenda publicações no 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 e publicações de imagens, PNG/PDF

Horários para

LinkedIn, Instagram, TikTok, Threads

Read the CLI Docs Get API Key