Canvora × nanoclaw
CLI de visuales de marca para nanoclaw
nanoclaw mantiene el bucle del agente al mínimo; Canvora mantiene la superficie de herramientas igual de mínima: una variable de entorno, un comando a la entrada y visuales de marca terminados a la salida.
Créditos gratis, sin tarjeta. Mantén siempre a una persona en el bucle.
Toda la configuración
# Instala las skills (o usa la CLI a pelo: ambas opciones funcionan)
npx skills add canvora/canvora-mcp
# La autenticación es una variable de entorno
export CANVORA_API_KEY=vd_...
# Prueba rápida
canvora credits --jsonEsto es lo que entrega tu agente
Una generación, localizada dos veces. El mismo diseño, recompuesto de forma nativa en español y en árabe: escritura de derecha a izquierda bien resuelta, no un inglés en espejo.
Generado con los mismos comandos que ves en esta página.
Cómo funciona
1. Lanza
La primera línea de stdout es el id de generación, sin adornos
ID=$(canvora generate \
--input "Tres hábitos de los equipos remotos realmente eficaces..." \
--format instagram_post --style minimal | head -1)2. Consulta
Comprobaciones de estado baratas hasta completed
while true; do
S=$(canvora status "$ID" --json | jq -r .status)
[ "$S" = "completed" ] && break
[ "$S" = "failed" ] && exit 1
sleep 10
done3. Entrega
Archivos o URLs de CDN, lo que necesite el bucle
canvora download "$ID" --dir out/
canvora status "$ID" --json | jq -r '.outputs[].fileUrl'¿Qué es nanoclaw?
nanoclaw es la versión minimalista del agente de IA personal: un núcleo diminuto y auditable que se apoya en herramientas externas bien educadas en lugar de complejidad incorporada. Canvora encaja en esa filosofía: todo el pipeline visual cabe en cuatro comandos.
Superficie diminuta
generate, status, download: el bucle esencial son tres comandos. Todo imprime JSON con --json; el progreso va a stderr y los resultados a stdout.
Sin estado que gestionar
Ni sesiones, ni SDK, ni archivos de configuración. La clave de API sale del entorno; los ids de generación son cadenas simples que tu bucle se pasa de mano en mano.
Falla en seguro
El saldo se comprueba antes de cualquier deducción, los errores son JSON tipado y las generaciones fallidas se reembolsan automáticamente: un bucle minimalista no puede vaciarte la cuenta en silencio.
La herramienta completa del agente, en una pantalla
Esta es toda la integración: sin librería intermedia
#!/bin/sh
# herramienta nanoclaw: texto -> post de Instagram con tu marca -> URL del archivo
ID=$(canvora generate --input "$1" \
--format instagram_post --brand "$BRAND_ID" | head -1)
until [ "$(canvora status "$ID" --json | jq -r .status)" = "completed" ]
do sleep 10; done
canvora status "$ID" --json | jq -r '.outputs[0].fileUrl'Añade idiomas sin añadir código
El mismo bucle minimalista cubre todos los mercados
# Un comando extra localiza el visual terminado:
# mismo diseño, texto recompuesto de forma nativa
canvora localize "$ID" --language tr
canvora localize "$ID" --language ar # RTL correcto, no un espejoPor qué nanoclaw + Canvora
- Bucle esencial de tres comandos: generate, status, download
- stdout es datos, stderr es progreso: las tuberías componen limpio
- Sin SDK, sin sesión, sin configuración: una variable de entorno y cadenas simples
- Errores JSON tipados y comprobación de saldo antes de deducir: seguro en bucles desatendidos
- localize y variations amplían el bucle sin código de integración nuevo
Referencia de comandos
Añade --json a cualquier comando para obtener salida legible por máquina. El progreso va a stderr; los resultados, a stdout.
| Comando | Descripción |
|---|---|
| canvora generate | Crea visuales a partir de --idea, texto con --input, --url o --file-url; elige formatos, marca, estilo e idioma |
| canvora status <id> | Consulta una generación; --json devuelve el estado y las URLs de los archivos generados |
| canvora download <id> | Guarda los archivos generados en un directorio |
| canvora localize <id> | El mismo diseño, recompuesto de forma nativa en otro idioma (RTL incluido) |
| canvora variations <id> | Tomas alternativas de una generación terminada |
| canvora edit <outputId> | Revisa un visual con una instrucción en lenguaje natural |
| canvora formats | Lista los más de 100 ids de formato |
| canvora brands | Lista los kits de marca (colores, tipografías, logo, tono) |
| canvora credits | Muestra el saldo de créditos |
Más de 100 formatos, un solo motor
Cada formato tiene composición y zonas seguras adaptadas a su plataforma: tu agente elige por id.
Carrusel de Instagram
Hasta 20 diapositivas, del gancho al CTA
Carrusel de LinkedIn
Posts de documento deslizables
Pitch deck
Sets de diapositivas coherentes
Post y story de Instagram
Formatos de feed y verticales
Tarjeta de datos
Una cifra, diseñada para impactar
Infografía
Visuales de datos y procesos
Cabecera de blog e imagen OG
Toda la superficie de lanzamiento
Creatividades publicitarias
Anuncios display y sociales
Preguntas frecuentes
¿Por qué la generación es asíncrona? +
Generar visuales es trabajo de verdad; una llamada bloqueante ataría el bucle del agente y agotaría los tiempos de espera del shell. Lanza el trabajo, captura el id de stdout y consulta el estado. El patrón son tres líneas de sh, las de arriba, y nunca se atasca.
¿Cuánto cuesta cada llamada? +
Créditos planos: 10 por visual individual, 15 por diapositiva de carrusel o deck. canvora credits --json devuelve el saldo; una petición que lo supere falla antes de cualquier deducción, con el déficit exacto en el error.
¿Y si el bucle muere a mitad de generación? +
No se pierde nada: la generación continúa en el servidor y el id sigue siendo consultable. Si falla, los créditos se reembolsan automáticamente. Volver a ejecutar el script arranca un trabajo nuevo e independiente, así que guarda el id si prefieres retomarlo.
¿Hay que instalar algo además de la CLI? +
No. @canvora/cli es un binario de Node normal; el jq de los ejemplos es un extra opcional. La instalación de skills añade flujos listos para usar por encima, pero la CLI a pelo es plenamente capaz.
También funciona con
La próxima llamada a herramienta de tu agente es un departamento de diseño.
Crea una cuenta gratis, configura una clave y deja que nanoclaw entregue visuales de marca.