PostNitro CLI: crea y programa publicaciones en redes sociales desde tu terminal.
Un solo comando, una publicación diseñada a medida. La CLI de PostNitro crea carruseles, publicaciones de una sola imagen y videos cortos que se ajustan a la imagen de marca, añade opcionalmente imágenes generadas por IA y las programa para LinkedIn, Instagram, TikTok y Threads, sin necesidad de un navegador, una herramienta de diseño ni un solo paso manual. Todos los comandos utilizan JSON, lo que facilita su uso tanto para agentes de IA y pipelines de CI como para el usuario.
npm install -g @postnitro/cli — y tu terminal se convertirá en un estudio de contenido.
Paquete
@postnitro/cli en npm
Interfaz
JSON de entrada, JSON de salida: seguro para scripts
Crea
Carruseles, imágenes y vídeos — PNG/PDF/MP4
Horarios para
LinkedIn, Instagram, TikTok, Threads
¿Por qué instalar un motor de contenido en tu terminal?
Publicar sin salir de la concha
"postnitro carousel generate --context '5 remote work tips' --wait" es un carrusel completo, con la imagen de marca correcta y listo para descargar. Sin pestañas, sin arrastrar y soltar, sin cuadro de diálogo de exportación.
Diseñado para agentes de IA
JSON limpio en la salida estándar, errores JSON en la salida de error estándar, sin colores ni indicaciones interactivas que dificultan el análisis. Claude Code, Cursor y cualquier agente con capacidad de shell pueden controlarlo de forma fiable; o bien, se puede instalar como una habilidad y dejar que el agente aprenda por sí mismo.
Automatizar en CI y Cron
Publica anuncios de lanzamiento desde tu canalización de despliegue o ejecuta una tarea nocturna que convierta el calendario de contenido de mañana en publicaciones programadas. Los códigos de salida y la salida JSON facilitan la detección de fallos.
La IA lo escribe, o lo haces tú.
Genera contenido a partir de un tema, la URL de un artículo o una publicación X, o importa tu propio JSON de diapositivas para un control total, incluyendo diseños de infografías con columnas de datos. Ambas opciones se visualizan a través de tus plantillas y kit de marca.
Imágenes de IA, a un paso de distancia
Añade --generate-images con una breve descripción visual y se crearán imágenes generadas por IA que se incorporarán a tus diapositivas antes de la renderización: fondos o imágenes en línea, diapositivas estratégicas o todas ellas.
Idea a publicación programada en un solo comando
generate-and-schedule escribe el contenido, espera a que se renderice y lo programa en tu calendario con subtítulos específicos para cada plataforma; import-and-schedule hace lo mismo con tus propias diapositivas. Todo un flujo de trabajo de contenido en un solo comando de línea de comandos.
Establece los valores predeterminados una sola vez y luego olvídate de ellos.
Guarda tu plantilla, marca, preajuste y formato de salida con los valores predeterminados. Los comandos posteriores solo necesitarán el contenido; si tu espacio de trabajo tiene exactamente un candidato, la interfaz de línea de comandos lo seleccionará automáticamente.
Misma clave, mismos créditos, todas las superficies
La interfaz de línea de comandos (CLI) es una capa ligera sobre la API de Embed y comparte tu clave y saldo de crédito con la API REST y el servidor MCP. Empieza en la terminal y cambia de interfaz cuando quieras.
Instalación en segundos
Requiere Node.js 18+ y una cuenta PostNitro con un plan de pago.
De cero a publicación programada en cuatro comandos
1. Autentícate una vez
Obtén tu clave API en PostNitro → Perfil → Integrar → Generar clave API y guárdala. También puedes usar la variable de entorno POSTNITRO_API_KEY o --api-key por comando (recomendado para CI).
2. Guarda tus valores predeterminados
Enumera tus plantillas, marcas y ajustes preestablecidos de IA, y luego guarda tus favoritos para que los comandos de creación solo necesiten contenido.
3. Generar y recuperar archivos
--esperar sondeos hasta que el renderizado termine e imprima el JSON final: URL de archivos, un designId para la programación y un enlace profundo editorUrl para continuar editando en PostNitro.
4. Prográmalo: PostNitro lo publica por ti.
Obtén el designId del resultado y programa la publicación en tus cuentas conectadas de LinkedIn, Instagram, TikTok o Threads, o guárdala como borrador. Ese es todo el proceso: idea → diseño → publicación programada, sin salir de la terminal.
No te limites a crear publicaciones, ¡prográmalas también!
Diseñar la publicación es solo la mitad del trabajo, así que PostNitro ahora lo completa: programa publicaciones o guarda borradores directamente en LinkedIn, Instagram, TikTok y Threads, con textos y configuraciones específicas para cada plataforma. Genera o importa un diseño, asígnalo a un espacio de tiempo y PostNitro lo publica por ti, desde la API, el servidor MCP o la CLI, sin necesidad de una herramienta de programación independiente.
Flujos de trabajo reales, listos para copiar y pegar.
Convierte una entrada de blog en un carrusel de LinkedIn.
Escribe "artículo" en una URL y la IA extraerá los puntos clave en diapositivas deslizables.
Generar y programar de una sola vez
Contenido escrito, diseño realizado, publicación reservada: un solo comando. Si la programación falla, se devuelve el ID del diseño para que puedas volver a intentarlo sin gastar créditos adicionales.
Importar y programar en un solo paso.
La contraparte para la importación: tus diapositivas exactas pasan de JSON a una publicación reservada con un solo comando. Misma garantía: si la programación falla después de que la importación se haya realizado correctamente, recuperas el designId para volver a intentarlo sin gastar créditos adicionales.
Importa tus propias diapositivas
Control editorial total: envíe sus diapositivas como JSON directamente o desde un archivo, y PostNitro las adaptará a su plantilla y marca.
Una publicación con una sola imagen y una ilustración creada con IA.
Las publicaciones de imágenes imitan los carruseles: un solo objeto de diapositiva en lugar de una matriz, con las mismas opciones de imágenes con IA disponibles.
Programa un diseño que ya tienes
Al crearlo, se le asigna un ID de diseño; al programarlo, se vincula a su calendario con etiquetas específicas para cada plataforma. Gestione toda la cola (lista, actualización, eliminación) sin salir de la consola.
Empieza ahora, recoge después.
Omitir --esperar para generaciones largas o trabajos por lotes: la creación devuelve un embedPostId inmediatamente, y status/output recoge el resultado cuando esté listo.
Diseñado para agentes de IA
La interfaz de línea de comandos (CLI) se diseñó pensando en el agente: indicadores predecibles, salida legible por máquina y acciones destructivas controladas por --yes. Instala la habilidad PostNitro y tu agente de codificación aprenderá todo el flujo de trabajo (descubrimiento, valores predeterminados, creación, programación) sin que tengas que escribir ninguna instrucción.
- JSON en la salida estándar (salida 0) si tiene éxito; errores JSON estructurados en la salida de error estándar (salida 1)
- Sin indicaciones interactivas, ruletas, colores ni tablas: nada que pueda confundir al analizador.
- Entrada JSON en línea o archivo para cargas útiles complejas; la entrada en línea siempre es preferible.
- Instálalo mediante "npx skills add postnitro/postnitro-agent" o como un plugin de Claude Code.
La superficie de mando completa
Todo lo que la API de Embed puede hacer, como comandos combinables. Ejecuta cualquier comando con --help para obtener más detalles.
| Group | Commands | What it's for |
|---|---|---|
| Configuración | autenticación establecer clave · estado de autenticación · borrar autenticación · obtener valores predeterminados · establecer valores predeterminados | Guarda tu clave API y la plantilla predeterminada, la marca, el ajuste preestablecido y el formato de salida. |
| Descubrimiento | Lista de plantillas · Lista de marcas · Lista de preajustes · Lista de redes sociales | Encuentra los identificadores de tus plantillas, kits de marca, ajustes preestablecidos de IA y cuentas sociales conectadas. |
| Carruseles | Generar carrusel · Importar carrusel · Estado del carrusel · Salida del carrusel · Plantilla de importación de carrusel | Crea publicaciones con varias diapositivas utilizando inteligencia artificial o a partir de tus propias diapositivas, y obtén resultados. |
| Publicaciones de imágenes | Generar imagen · Importar imagen · Estado de la imagen · Salida de imagen · Plantilla de importación de imagen | Los equivalentes de una sola imagen: las mismas banderas, un objeto de diapositiva en lugar de una matriz. |
| Vídeos | Generación de vídeo · Importación de vídeo · Estado del vídeo · Salida de vídeo · Plantilla de importación de vídeo | Convierte las diapositivas en un vídeo: cada diapositiva es una escena. Añade --video-duration y --audio-id; renderiza a MP4 o se detiene en el diseño. |
| Audio | lista de audio · eliminar audio | Resuelve el audioId que necesita un vídeo o reel y elimina las pistas que ya no uses. La carga se realiza en la aplicación PostNitro. |
| Kits de marca | crear marca · obtener marca · actualizar marca | Gestiona el logotipo, el nombre y el identificador que aparecen en tus diseños. |
| Programación | crear horario · listar horario · obtener horario · actualizar horario · eliminar horario | Guarda publicaciones y borradores con subtítulos y configuraciones específicas para cada plataforma; gestiona la cola de publicaciones. |
| Historias cortas | generar-y-programar · importar-y-programar | Crea, espera y programa con un solo comando, tanto para carruseles como para publicaciones de imágenes. |
| Cuentas sociales | lista social · obtener socialmente · desconexión social | Inspecciona las cuentas conectadas de LinkedIn, Instagram, TikTok y Threads. |
Errores que tus scripts realmente pueden manejar
Cada fallo se convierte en un objeto JSON estructurado en stderr con un código de salida distinto de cero; no se analiza el texto del registro ni se hacen conjeturas. La canalización se bifurca según el estado de salida; el agente lee el mensaje y corrige su propia llamada.
| Error común | Arreglar |
|---|---|
No se encontró ninguna clave API. | Pase --api-key, configure POSTNITRO_API_KEY o ejecute auth set-key |
Falta --brand-id ... varios candidatos | Pase el ID explícitamente o guarde uno con los valores predeterminados establecidos; el error enumera los candidatos. |
Programado en el pasado | Utilice una hora ISO-8601 con al menos 5 minutos de anticipación, con una Z final. |
Las diapositivas deben ser una matriz con al menos 3 entradas. | Proporcionar diapositivas de inicio, desarrollo y cierre. |
Una publicación de IMAGEN toma un solo objeto de diapositiva, no una matriz. | Utilice --slide (objeto) para imágenes, --slides (matriz) para carruseles. |
Negarse a eliminar... sin --sí | Añade --yes para confirmar las acciones destructivas; nada destructivo se ejecuta por accidente. |
Ahora tu terminal puede publicar en LinkedIn.
Instala la interfaz de línea de comandos (CLI), guarda la configuración predeterminada y convierte cualquier tema, artículo o calendario de contenido en publicaciones programadas y acordes a tu marca, ya sea desde la consola, un script o tu agente de IA.
Obtén tu clave APICuatro formatos de salida
Un único documento: la opción predeterminada y el formato adecuado para las publicaciones de documentos en LinkedIn.
Una imagen por diapositiva, lista para subirla directamente a cualquier plataforma.
Omite por completo el renderizado y devuelve el diseño editable; es la opción más rápida cuando solo necesitas programar o editar continuamente.
Vídeo renderizado: solo se aceptan vídeos en este formato. Debe tener una duración de entre 5 y menos de 60 segundos; la pista de audio es opcional.
Cada resultado final incluye un designId (el que requiere la programación) y un enlace directo editorUrl para abrir el diseño en el editor de PostNitro. El tipo de respuesta no modifica el coste de los créditos. El formato MP4 es exclusivo para publicaciones de vídeo, y un vídeo solo acepta MP4 o DESIGN.
Créditos y precios
| Plan | Price | Credits/Month | Typical Usage |
|---|---|---|---|
| Mensual | $10 al mes | 250 créditos/mes | Acceso completo a la interfaz de línea de comandos y automatización regular. |
| niveles superiores | Ver la página de planos | Más créditos | Equipos, agencias y procesos de alto volumen |
| Operation | Credits per Slide |
|---|---|
| Importación de contenido | 1 crédito por diapositiva |
| generación de IA | 2 créditos por diapositiva |
La interfaz de línea de comandos (CLI) comparte créditos con la API de incrustación y el servidor MCP. Las imágenes generadas por IA consumen una cuota de imágenes independiente de la organización y no modifican el costo de créditos de una publicación.
Get Your API KeyCLI vs MCP vs Embed API vs Embed SDK
CLI | Servidor MCP | API de integración | SDK de integración | |
|---|---|---|---|---|
| Lo mejor para | Flujos de trabajo de terminal, scripts de shell, CI y agentes que ejecutan comandos | Asistentes de IA creando publicaciones de forma conversacional | Plataformas de automatización sin código y backends personalizados | Permitir que tus usuarios diseñen carruseles dentro de tu aplicación. |
| Interfaz | Comandos con indicadores: entrada JSON, salida JSON | Lenguaje natural a través de un cliente MCP | REST sobre HTTPS | Editor visual integrable |
| Configuración | npm install -g @postnitro/cli | Un bloque de configuración o un comando CLI | Clave API + cualquier cliente HTTP | Paquete npm + clave API |
| Programación | Sí, incluyendo la generación y programación de una sola vez. | Sí, CRUD completo mediante herramientas | Sí, a través de la API de programación. | No, solo diseño |
| Misma clave y créditos | Sí | Sí | Sí | Sí |
Todos utilizan el mismo motor. Usa la interfaz de línea de comandos (CLI) en terminales y flujos de trabajo, el panel de control principal (MCP) dentro de los asistentes de IA, la API REST desde tu propio código y el SDK cuando tus usuarios necesiten un editor visual.
Frequently Asked Questions
A un comando de distancia del contenido automatizado
npm install -g @postnitro/cli — y luego genera, renderiza y programa tu primer carrusel en menos de cinco minutos.
Obtén tu clave API