CLIAPI

Programa y publica desde la terminal

fopost es la CLI oficial de FoPost: un único binario estático sin nada más que instalar. Crea un post, adjunta contenido multimedia, prográmalo en todas las cuentas conectadas y comprueba cada entrega, desde tu shell, un script o un trabajo 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"

Un solo binario

macOS, Linux y Windows en amd64 y arm64. Instala con Homebrew, go install o un archivo de release.

Pensada para scripts

Cada comando acepta --json, los errores van a stderr y cada fallo tiene su propio código de salida.

Nada se publica por sorpresa

Un post sigue siendo borrador hasta que pasas --publish, ejecutas posts publish o fijas una programación.

Posts

Crea, programa y publica con un solo comando

posts create recibe las cuentas, el texto, los archivos multimedia locales y una hora. Los archivos se suben a tu biblioteca multimedia y se adjuntan por ti. El texto largo puede venir de un archivo o de una tubería, y preflight comprueba un post en cada red de destino antes de enviar nada.

Consulta los 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

Programa o publica

Indica una hora para programar, --publish para enviar ahora, o nada para mantener un borrador.

Preflight

Comprueba qué cuentas están listas o bloqueadas, y por qué, antes de publicar.

Estado de entrega

Estado por cuenta, intentos y el enlace en vivo cuando la red ya lo tiene.

Scripting

JSON de salida, códigos de salida de vuelta

Añade --json a cualquier comando y canaliza el resultado a jq. Un 401, un 404, un límite de frecuencia y una solicitud incorrecta terminan con códigos distintos, así que un script puede distinguirlos sin analizar texto. Los reintentos y el backoff ocurren por debajo en cada solicitud.

Lee la guía de scripting
Cuentas que necesitan atención
fopost accounts health --json \
  | jq -r '.accounts[] | select(.healthStatus != "healthy") | .id' \
  | xargs -I{} fopost accounts validate {} --quiet

--json en todas partes

El recurso en sí, con sangría, en stdout. Las tablas son para personas.

Códigos de salida distintos

Entrada incorrecta, autenticación, permisos, no encontrado, límite de frecuencia y errores del servidor tienen cada uno el suyo.

Reintentos incluidos

Los límites de frecuencia, los errores del servidor y los fallos de red se reintentan con backoff.

CI

Publica desde tu pipeline

Guarda tu clave de API como secreto, indica el workspace y la CLI no necesita configuración guardada. Anuncia una versión, comparte un changelog o bloquea un merge cuando preflight falle. Para GitHub también hay una Action oficial que envuelve el mismo flujo.

Empieza a crear
Notas de versión en 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

Clave desde el entorno

FOPOST_API_KEY se lee automáticamente. Sin paso de login en CI.

Cualquier sistema de CI

GitHub Actions, GitLab CI o cualquier otro que ejecute un shell.

Automatizaciones y webhooks

Activa automatizaciones y gestiona suscripciones de webhooks desde la misma herramienta.

Preguntas sobre CLI, respondidas

¿Cómo instalo la CLI?

Ejecuta brew install fopost/tap/fopost, o go install github.com/fopost/fopost-cli@latest, o descarga el archivo para tu plataforma desde la página de releases de GitHub y añade fopost a tu PATH.

¿Necesita una cuenta?

Sí. La CLI se comunica con la API alojada de FoPost, así que necesita una clave de API, que creas en el panel en Ajustes, Claves de API. fopost auth login la guarda, o define FOPOST_API_KEY en su lugar.

¿Dónde se guarda mi clave de API?

En la carpeta de configuración de tu usuario, legible solo por ti. La CLI nunca la muestra de nuevo: auth status enseña un prefijo enmascarado y la salida detallada la omite.

¿Qué puede hacer?

Posts, cuentas y su estado, workspaces, subidas de multimedia, etiquetas, analíticas, automatizaciones y webhooks. Ejecuta fopost --help o consulta la documentación de la CLI para ver cada comando.

¿Es de código abierto?

Sí. La CLI tiene licencia MIT y su código está en GitHub, en fopost/fopost-cli.

Empieza hoy a construir con la CLI

Empezar es gratis y la API completa está incluida. Crea una clave y haz tu primera llamada en minutos.

Obtén tu clave de API