Canvora

Instalar como habilidade

npx skills add canvora/canvora-mcp

Canvora — visuais para agentes de IA

Dê ao seu agente um departamento de design. Transforme qualquer ideia, URL, documento ou PDF em visuais finalizados e alinhados à marca: 82 formatos (posts, carrosséis, apresentações, PDFs, anúncios, infográficos, kits de landing page), gerados nativamente em mais de 150 idiomas — incluindo RTL e CJK. Kits de marca mantêm cada saída nas cores, fontes, logotipo e tom do 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

Seu agente escreve o briefing. A Canvora faz o design. As saídas são URLs estáveis de CDN, prontas para postar, incorporar ou entregar a um agendador (funciona muito bem a montante do Postiz ou de qualquer ferramenta de publicação: gerar → agendar, agentico de ponta a ponta).

Este repositório é o kit de ferramentas voltado a agentes para Canvora:

• Habilidades de agente — skills/: 11 habilidades específicas por tarefa; um único npx skills add instala todas elas no Claude Code, Cursor, Codex, OpenCode, OpenClaw e mais de 60 agentes.

  Habilidade	Para
  canvora	núcleo: configuração, loop de geração, créditos, refinamento
  instagram-carousel	carrosséis do Instagram / posts de deslizar
  linkedin-carousel	carrosséis de documento do LinkedIn + zonas seguras
  pitch-deck	apresentações de pitch/vendas/treinamento, documento → slides
  pdf-document	PDFs de várias páginas: brochuras, relatórios, one-pagers
  landing-page-visuals	kit visual completo de uma página a partir da URL dela
  ad-campaign	conjuntos e variantes de anúncios pagos em redes sociais e display
  blog-promo-kit	cabeçalho, imagem OG e conjunto promocional a partir de um post
  data-infographic	fluxos de processo, comparações, cronogramas, estatísticas
  multilingual-campaign	uma campanha → muitos idiomas
  product-photo-visuals	designs construídos em torno das fotos do próprio usuário
  visual-refresh	editar, variar, localizar e reverter o que já existe

• Servidor MCP remoto — para Claude, ChatGPT, Cursor e qualquer cliente MCP. Nada para instalar.

• CLI canvora — para agentes nativos de shell, cron jobs e CI. Zero dependências.

O serviço Canvora em si é hospedado; este repositório contém ferramentas de cliente, habilidades e documentação.

Opção 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

Mais receitas executáveis: examples/

Comandos

Comando	O que faz
canvora generate	Cria visuais a partir de um --idea (conceito curto, a Canvora desenvolve), --input (seu texto completo de conteúdo), --url ou --file-url (PDF). --wait faz polling até a conclusão e imprime as URLs de saída.
canvora localize <id> --language es	Mesmo design, novo idioma: traduz os visuais de uma geração existente, layout intacto
canvora variations <id> [--count n]	Novas interpretações dos visuais de uma geração existente
canvora edit <outputId> --prompt "..."	Edição em linguagem natural de um visual (pré-visualiza a alteração; --yes confirma automaticamente)
canvora status <id>	Verifica uma geração e lista suas URLs de saída
canvora download <id> --dir out/	Salva todos os arquivos de saída localmente
canvora formats	Todos os 82 IDs de formato com dimensões (catálogo ao vivo)
canvora brands	Seus kits de marca (passe um via --brand <uuid>)
canvora credits	Saldo de créditos (10 créditos por visual, 15 por slide de carrossel/deck)

Todo comando aceita --json para stdout legível por máquina; progresso e erros vão para stderr, então o pipe permanece limpo. Códigos de saída: 0 sucesso, 1 falha, 2 erro de uso.

Flags de geração

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

Opção 2 — MCP (Claude, ChatGPT, qualquer cliente MCP)

Um servidor remoto, login via OAuth, 16 ferramentas que seu agente descobre na conexão:

URL do servidor	https://api.canvora.ai/mcp (HTTP streamable)
Claude	Configurações → Conectores → Adicionar conector personalizado → ID do cliente OAuth claude_mcp
ChatGPT	Configurações → Apps → Modo desenvolvedor → Criar app → ID do cliente OAuth chatgpt_mcp
Registry	ai.canvora/canvora no Registro oficial de MCP — também no Glama, Smithery, mcpservers.org

Passo a passo: canvora.ai/help/integrations/mcp-setup

Opção 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}
  }'

Guia completo da API: canvora.ai/help/integrations/api-keys

O que os agentes constroem com isso

• Pipelines de conteúdo para clientes — briefing entra, campanha multimarca e multi-formatos sai, agendada pela sua ferramenta de publicação
• Campanhas multilíngues — gere uma vez, canvora localize para 10 mercados; o layout sobrevive, o texto fica nativo (habilidade)
• Carrosséis otimizados para salvar — estrutura gancho-primeiro e direção de arte por slide codificadas como habilidade (habilidade)
• Documentos → apresentações — aponte --file-url para um relatório em PDF e obtenha slides de apresentação
• Conjuntos de anúncios — ad_square,ad_landscape,ad_portrait a partir de uma URL de produto, todas as posições cobertas

Feito para ser chamado por software

• Custos previsíveis — preço fixo em créditos (10/visual, 15/slide); canvora credits antes de trabalhos grandes; gerações com falha são reembolsadas automaticamente.
• Humano no ciclo — tudo que seu agente cria também aparece no seu painel Canvora, pronto para revisão, edição e exportação antes de ir para qualquer lugar.
• Chaves com escopo e revogáveis — com hash em repouso, rastreamento de uso por chave, revogação com um clique.
• Saídas em um CDN — URLs estáveis que seu agente pode postar, incorporar ou entregar a um agendador.
• Funciona em todos os planos — acesso à API e ao MCP incluído no Free (créditos gratuitos, sem cartão).

Links

• canvora.ai/for-agents — a visão geral do agente
• Guia de configuração do MCP · Guia da API
• Preços

Licença MIT (CLI, habilidades e documentação neste repositório).