Canvora

作为技能安装

npx skills add canvora/canvora-mcp

Canvora — 面向 AI Agent 的视觉设计

为你的 Agent 配备设计部门。 将任何创意、URL、文档或 PDF 转化为精美且符合品牌调性的视觉内容：82 种格式（帖子、轮播图、演示文稿、PDF、广告、信息图、落地页素材包），以 150 多种语言原生生成 — 包括 RTL 和中日韩文字。品牌套件能确保每项输出都采用客户指定的颜色、字体、徽标和语气。

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

你的 Agent 撰写设计简报，Canvora 负责设计。输出是稳定的 CDN URL，可直接发布、嵌入或交给排期工具（非常适合作为 Postiz 或任何发布工具的上游：生成 → 排期，实现端到端 Agent 自动化）。

此仓库是面向 Agent 的 Canvora 工具包：

• Agent 技能 — skills/：11 个针对特定任务的技能，运行一次 npx skills add，即可将它们全部安装到 Claude Code、Cursor、Codex、OpenCode、OpenClaw 和 60 多种 Agent 中。

  技能	用途
  canvora	核心：设置、生成流程、额度、优化
  instagram-carousel	Instagram 轮播图 / 滑动帖子
  linkedin-carousel	LinkedIn 文档轮播图 + 安全区域
  pitch-deck	融资 / 销售 / 培训演示文稿、文档转幻灯片
  pdf-document	多页 PDF：宣传册、报告、单页资料
  landing-page-visuals	根据页面 URL 生成整套页面视觉素材
  ad-campaign	付费社交媒体 + 展示广告组及其变体
  blog-promo-kit	根据一篇文章生成页眉、OG 图片和宣传素材
  data-infographic	流程图、对比图、时间线、统计图
  multilingual-campaign	一场活动 → 多种语言
  product-photo-visuals	基于用户自有照片打造的设计
  visual-refresh	编辑、变更、调整本地化版本，并还原现有内容

• 远程 MCP 服务 — 适用于 Claude、ChatGPT、Cursor 和任何 MCP 客户端。无需安装。

• canvora CLI — 适用于原生命令行的 Agent、cron 任务和 CI。零依赖。

Canvora 服务本身托管在云端；此仓库包含客户端工具、技能和文档。

选项 1 — 技能 + CLI（Claude Code、Cursor、Codex、OpenClaw、原生命令行的 Agent）

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

更多可运行示例：examples/

命令

命令	功能
canvora generate	根据 --idea（简短概念，由 Canvora 扩展）、--input（完整内容文本）、--url 或 --file-url（PDF）创建视觉内容。--wait 会轮询直至完成，并输出结果 URL。
canvora localize <id> --language es	保持设计不变，切换语言：翻译现有生成内容中的视觉文本，不改动布局
canvora variations <id> [--count n]	为现有生成内容中的视觉内容创作全新版本
canvora edit <outputId> --prompt "..."	使用自然语言编辑单个视觉内容（预览更改；--yes 自动确认）
canvora status <id>	检查生成任务并列出结果 URL
canvora download <id> --dir out/	将所有输出文件保存到本地
canvora formats	所有 82 种格式 ID 及其尺寸（实时目录）
canvora brands	你的品牌套件（通过 --brand <uuid> 传入一个）
canvora credits	积分余额（每个视觉内容 10 积分，每张轮播图／演示文稿幻灯片 15 积分）

每条命令都支持 --json，用于输出机器可读内容；进度和错误会输出到 stderr，因此管道传输保持干净。退出代码：0 成功，1 失败，2 用法错误。

生成标志

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

选项 2 — MCP（Claude、ChatGPT、任何 MCP 客户端）

一个远程服务，通过 OAuth 登录，提供 16 个工具，Agent 连接后即可发现：

服务 URL	https://api.canvora.ai/mcp（可流式传输的 HTTP）
Claude	Settings → Connectors → Add custom connector → OAuth Client ID claude_mcp
ChatGPT	Settings → Apps → Developer mode → Create app → OAuth Client ID chatgpt_mcp
注册目录	官方 MCP Registry 上的 ai.canvora/canvora — 也收录于 Glama、Smithery、mcpservers.org

分步指南：canvora.ai/help/integrations/mcp-setup

选项 3 — 原始 REST

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

完整 API 指南：canvora.ai/help/integrations/api-keys

Agent 可以用它构建什么

• 客户内容工作流 — 输入简报，生成品牌化的多格式营销活动，再由你的发布工具安排发布
• 多语言营销活动 — 生成一次，再用 canvora localize 本地化到 10 个市场；保留布局，文本转换为地道表达（skill）
• 为收藏优化的轮播图 — 以吸引人的开场为先的结构和逐页艺术指导已编码为技能（skill）
• 文档 → 演示文稿 — 将 --file-url 指向 PDF 报告，生成演示幻灯片
• 广告组 — 根据一个产品 URL 生成 ad_square,ad_landscape,ad_portrait，覆盖所有广告版位

专为软件调用而构建

• 成本可预测 — 固定积分定价（每个视觉内容 10 积分，每张幻灯片 15 积分）；大型任务前可运行 canvora credits；生成失败会自动退还积分。
• 人在回路中 — Agent 创建的所有内容也会出现在你的 Canvora 控制面板中，可先审核、编辑和导出，再用于其他地方。
• 作用域受限、可撤销的密钥 — 静态存储时经过哈希处理，按密钥跟踪使用情况，支持一键撤销。
• 通过 CDN 提供输出 — 稳定的 URL，Agent 可用于发布、嵌入或交给排程工具。
• 适用于所有套餐 — 免费套餐也包含 API 和 MCP 访问权限（含免费积分，无需信用卡）。

链接

• canvora.ai/for-agents — Agent 概览
• MCP 设置指南 · API 指南
• 定价

采用 MIT 许可（本仓库中的 CLI、技能和文档）。