CLIAPI

Agende e publique pelo terminal

fopost é a CLI oficial do FoPost: um único binário estático, sem mais nada para instalar. Crie um post, anexe mídia, agende em todas as contas conectadas e confira cada entrega, pelo shell, por um script ou por um job de CI.

brew install fopost/tap/fopost
fopost auth login

fopost posts create \
  --account acc_9f2c4a7b \
  --account acc_1ee3d5a0 \
  --text "We shipped dark mode. Every surface, every chart." \
  --media ./screenshots/dark-mode.png \
  --schedule-at "2026-09-01 09:00"

Um só binário

macOS, Linux e Windows em amd64 e arm64. Instale com Homebrew, go install ou um arquivo de release.

Feita para scripts

Todo comando aceita --json, os erros vão para stderr e cada falha tem seu próprio código de saída.

Nada é publicado por surpresa

Um post continua como rascunho até você passar --publish, executar posts publish ou definir um agendamento.

Posts

Crie, agende e publique com um comando

posts create recebe as contas, o texto, arquivos de mídia locais e um horário. Os arquivos são enviados para sua biblioteca de mídia e anexados para você. Textos longos vêm de um arquivo ou de um pipe, e o preflight verifica um post em cada rede de destino antes de qualquer envio.

Leia os comandos de posts
Posts
git log -1 --pretty=%s | \
  fopost posts create --account acc_9f2c4a7b --text-file - --draft

fopost posts preflight post_7d2a
fopost posts publish post_7d2a
fopost posts deliveries post_7d2a

Agende ou publique

Passe um horário para agendar, --publish para enviar agora, ou nada para manter um rascunho.

Preflight

Veja quais contas estão prontas ou bloqueadas, e por quê, antes de publicar.

Status de entrega

Status por conta, tentativas e o link ao vivo assim que a rede tiver um.

Scripts

JSON na saída, códigos de saída na volta

Adicione --json a qualquer comando e envie o resultado para o jq. Um 401, um 404, um limite de requisições e uma requisição inválida saem cada um com um código diferente, para que um script os distinga sem analisar texto. Novas tentativas e backoff acontecem por baixo em toda requisição.

Leia o guia de scripts
Contas que precisam de atenção
fopost accounts health --json \
  | jq -r '.accounts[] | select(.healthStatus != "healthy") | .id' \
  | xargs -I{} fopost accounts validate {} --quiet

--json em todo lugar

O próprio recurso, indentado, em stdout. Tabelas são para pessoas.

Códigos de saída distintos

Entrada inválida, autenticação, permissão, não encontrado, limite de requisições e erros de servidor têm um cada.

Novas tentativas embutidas

Limites de requisições, erros de servidor e falhas de rede são repetidos com backoff.

CI

Publique a partir do seu pipeline

Defina sua chave de API como secret, passe o workspace e a CLI não precisa de configuração salva. Anuncie uma release, compartilhe um changelog ou bloqueie um merge quando o preflight falhar. Para o GitHub, há também uma Action oficial que envolve o mesmo fluxo.

Comece a construir
Notas de versão a cada tag
FOPOST_API_KEY=$FOPOST_API_KEY fopost posts create \
  --workspace "$WORKSPACE_ID" \
  --account "$ACCOUNT_ID" \
  --text-file release-notes.md \
  --publish --json --quiet

Chave pelo ambiente

FOPOST_API_KEY é lida automaticamente. Sem etapa de login no CI.

Qualquer sistema de CI

GitHub Actions, GitLab CI ou qualquer coisa que execute um shell.

Automações e webhooks

Acione automações e gerencie assinaturas de webhook com a mesma ferramenta.

Perguntas sobre CLI, respondidas

Como instalo a CLI?

Execute brew install fopost/tap/fopost, ou go install github.com/fopost/fopost-cli@latest, ou baixe o arquivo da sua plataforma na página de releases do GitHub e coloque fopost no seu PATH.

Preciso de uma conta?

Sim. A CLI conversa com a API hospedada do FoPost, então precisa de uma chave de API, que você cria no painel em Configurações, Chaves de API. fopost auth login a armazena, ou defina FOPOST_API_KEY.

Onde minha chave de API fica armazenada?

Na sua pasta de configuração de usuário, legível apenas por você. A CLI nunca a exibe de volta: auth status mostra um prefixo mascarado e a saída detalhada a omite.

O que ela pode fazer?

Posts, contas e sua saúde, workspaces, uploads de mídia, etiquetas, análises, automações e webhooks. Execute fopost --help ou leia a documentação da CLI para ver todos os comandos.

É open source?

Sim. A CLI tem licença MIT e o código-fonte está no GitHub em fopost/fopost-cli.

Comece a construir com CLI hoje

Começar é grátis e a API completa está incluída. Crie uma chave e faça sua primeira chamada em minutos.

Obtenha sua chave de API