Canvora

Instalar como habilidad

npx skills add canvora/canvora-mcp

Canvora — visuales para agentes de IA

Dale a tu agente un departamento de diseño. Convierte cualquier idea, URL, documento o PDF en visuales finales y con marca: 82 formatos (publicaciones, carruseles, presentaciones, PDFs, anuncios, infografías, kits de página de aterrizaje), generados nativamente en más de 150 idiomas — incluidos RTL y CJK. Los kits de marca mantienen cada salida en los colores, fuentes, logotipo y tono del cliente.

canvora generate --idea "5 tips for remote work" \
  --format linkedin_carousel --slides linkedin_carousel=5 \
  --brand $BRAND_ID --wait --json
# → 5 finished branded slides on CDN URLs

Tu agente escribe el brief. Canvora hace el diseño. Las salidas son URLs CDN estables listas para publicar, incrustar o entregar a un programador (funciona muy bien junto con Postiz o cualquier herramienta de publicación: generar → programar, agéntico de principio a fin).

Este repositorio es el kit de herramientas orientado a agentes para Canvora:

• Habilidades para agentes — skills/: 11 habilidades específicas para tareas, una sola npx skills add instala todas en Claude Code, Cursor, Codex, OpenCode, OpenClaw y más de 60 agentes.

  Habilidad	Para
  canvora	núcleo: configuración, bucle de generación, créditos, refinamiento
  instagram-carousel	carruseles de Instagram / publicaciones deslizables
  linkedin-carousel	carruseles de documento de LinkedIn + zonas seguras
  pitch-deck	presentaciones de propuesta/venta/capacitación, documento → diapositivas
  pdf-document	PDFs multipágina: folletos, informes, resúmenes de una página
  landing-page-visuals	el kit visual completo de una página a partir de su URL
  ad-campaign	conjuntos de anuncios de pago social + display y variantes
  blog-promo-kit	encabezado, imagen OG y conjunto promocional a partir de una publicación
  data-infographic	flujos de proceso, comparaciones, cronologías, estadísticas
  multilingual-campaign	una campaña → muchos idiomas
  product-photo-visuals	diseños basados en las propias fotos del usuario
  visual-refresh	editar, variar, localizar y revertir lo existente

• Servidor MCP remoto — para Claude, ChatGPT, Cursor y cualquier cliente MCP. No hay nada que instalar.

• CLI canvora — para agentes nativos de shell, trabajos cron y CI. Cero dependencias.

El servicio Canvora en sí está alojado; este repositorio contiene herramientas de cliente, habilidades y documentación.

Opción 1 — Habilidades + CLI (Claude Code, Cursor, Codex, OpenClaw, agentes nativos de shell)

npx skills add canvora/canvora-mcp     # installs the skills (they set up the CLI on first use)
# or just the CLI:
npm install -g @canvora/cli

export CANVORA_API_KEY=vd_...   # create at canvora.ai → Integrations → API Keys (all plans, incl. Free)

# one atomic command: generates, polls, exits with the output URLs
canvora generate \
  --idea "5 tips for remote work" \
  --format linkedin_carousel --slides linkedin_carousel=5 \
  --wait --json

Más recetas ejecutables: examples/

Comandos

Comando	Qué hace
canvora generate	Crea visuales a partir de un --idea (concepto breve, Canvora lo desarrolla), --input (tu texto de contenido completo), --url o --file-url (PDF). --wait consulta hasta completar e imprime las URLs de salida.
canvora localize <id> --language es	Mismo diseño, nuevo idioma: traduce los visuales de una generación existente, sin tocar el diseño
canvora variations <id> [--count n]	Nuevas versiones de los visuales de una generación existente
canvora edit <outputId> --prompt "..."	Edición en lenguaje natural de un visual (muestra el cambio; --yes confirma automáticamente)
canvora status <id>	Verifica una generación y lista sus URLs de salida
canvora download <id> --dir out/	Guarda todos los archivos de salida localmente
canvora formats	Los 82 IDs de formato con dimensiones (catálogo en vivo)
canvora brands	Tus kits de marca (pasa uno vía --brand <uuid>)
canvora credits	Saldo de créditos (10 créditos por visual, 15 por diapositiva de carrusel/presentación)

Todos los comandos usan --json para salida estándar legible por máquina; el progreso y los errores van a stderr, para que las tuberías se mantengan limpias. Códigos de salida: 0 éxito, 1 error, 2 error de uso.

Banderas de generación

--idea "concept"          short concept - Canvora develops it into content
--input "text"            your full content text, used as the source material
--url <url>               extract content from a webpage
--file-url <pdf-url>      extract content from a PDF
--format <id>[,<id>...]   output formats (see: canvora formats)
--slides <format>=<n>     slide count for carousel/deck formats (1-10, default 5); match it to the item count your idea promises
--brand <uuid>            apply a brand kit
--style <name>            modern | minimal | bold | elegant | playful | corporate | creative | dark
--resolution 2K|4K        4K on paid plans
--language <code-or-name> visual text language ("es", "Spanish"); default: matches your input's language
--exact                   use --input text verbatim, no rewording (quotes, taglines)
--logo                    place the brand kit's logo on the visual (needs --brand)
--cta                     end a carousel/deck on a call-to-action slide
--no-text                 pure visual, no typography (backgrounds, hero imagery)
--freeform                ignore format-specific art direction, use dimensions only
--landing-page            with --url: read the page's sections and produce a matching
                          landingPage-* visual kit (Starter plan or higher)
--project <uuid>          group outputs into a project/campaign
--workspace <uuid>        bill a team workspace pool instead of your personal credits
--wait                    poll until done (--timeout 600, --poll 5 seconds)
--json                    machine-readable output

Opción 2 — MCP (Claude, ChatGPT, cualquier cliente MCP)

Un servidor remoto, inicio de sesión OAuth, 16 herramientas que tu agente descubre al conectarse:

URL del servidor	https://api.canvora.ai/mcp (HTTP fluido)
Claude	Configuración → Conectores → Añadir conector personalizado → ID de cliente OAuth claude_mcp
ChatGPT	Configuración → Apps → Modo desarrollador → Crear app → ID de cliente OAuth chatgpt_mcp
Registro	ai.canvora/canvora en el registro oficial de MCP — también en Glama, Smithery, mcpservers.org

Paso a paso: canvora.ai/help/integrations/mcp-setup

Opción 3 — REST puro

curl -X POST https://api.canvora.ai/api/generations \
  -H "X-API-Key: vd_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "inputType": "text",
    "inputContent": "5 tips for remote work",
    "outputFormats": ["linkedin_carousel"],
    "carouselCounts": {"linkedin_carousel": 5}
  }'

Guía completa de API: canvora.ai/help/integrations/api-keys

Lo que los agentes construyen con esto

• Pipelines de contenido para clientes — brief de entrada, campaña de múltiples formatos con marca a la salida, programada por tu herramienta de publicación
• Campañas multilingües — genera una vez, canvora localize a 10 mercados; el diseño sobrevive, el texto se vuelve nativo (habilidad)
• Carruseles optimizados para guardados — estructura de gancho primero y dirección de arte por diapositiva codificadas como habilidad (habilidad)
• Documentos → presentaciones — apunta --file-url a un informe PDF, obtén diapositivas de presentación
• Conjuntos de anuncios — ad_square,ad_landscape,ad_portrait desde una URL de producto, todas las ubicaciones cubiertas

Diseñado para ser llamado por software

• Costos predecibles — precios planos en créditos (10/visual, 15/diapositiva); canvora credits antes de trabajos grandes; las generaciones fallidas se reembolsan automáticamente.
• Humano en el bucle — todo lo que tu agente crea también termina en tu panel de Canvora, listo para revisión, edición y exportación antes de que salga a cualquier lado.
• Claves con alcance y revocables — hasheadas en reposo, seguimiento de uso por clave, revocación de un clic.
• Salidas en un CDN — URLs estables que tu agente puede publicar, incrustar o entregar a un programador.
• Funciona en todos los planes — acceso API y MCP incluido en Gratis (créditos gratuitos, sin tarjeta).

Enlaces

• canvora.ai/for-agents — la descripción general para agentes
• Guía de configuración de MCP · Guía de API
• Precios

Con licencia MIT (CLI, habilidades y documentación en este repositorio).