Canvora

スキルとしてインストール

npx skills add canvora/canvora-mcp

Canvora — AI エージェント向けビジュアル

エージェントにデザイン部門を。 アイデア、URL、ドキュメント、PDFを、ブランドに合った完成ビジュアルに変換します。82種類の形式（投稿、カルーセル、スライド資料、PDF、広告、インフォグラフィック、ランディングページ用キット）に対応し、RTLやCJKを含む150以上の言語でネイティブに生成します。ブランドキットにより、すべての出力でクライアントのカラー、フォント、ロゴ、トーンを統一できます。

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

エージェントがブリーフを作成し、Canvoraがデザインします。出力されるのは、投稿、埋め込み、スケジューラーへの受け渡しにすぐ使える、安定したCDN URLです（Postizやその他の投稿ツールとの連携にも最適です。エンドツーエンドのエージェント型で、生成 → スケジュール設定を実行できます）。

このリポジトリは、Canvora向けのエージェント用ツールキットです。

• エージェントスキル — skills/：タスク別のスキルが11種類あります。npx skills addを1回実行するだけで、Claude Code、Cursor、Codex、OpenCode、OpenClaw、その他60以上のエージェントにすべてインストールできます。

  スキル	用途
  canvora	基本：セットアップ、生成の流れ、クレジット、調整
  instagram-carousel	Instagramのカルーセル／スワイプ投稿
  linkedin-carousel	LinkedInのドキュメントカルーセルとセーフゾーン
  pitch-deck	ピッチ／営業／研修用スライド資料、ドキュメントからスライドへの変換
  pdf-document	複数ページのPDF：パンフレット、レポート、1ページ資料
  landing-page-visuals	URLからページ全体のビジュアルキットを作成
  ad-campaign	有料ソーシャル広告とディスプレイ広告のセットおよびバリエーション
  blog-promo-kit	1つの記事からヘッダー、OG画像、プロモーションセットを作成
  data-infographic	プロセスフロー、比較、タイムライン、統計
  multilingual-campaign	1つのキャンペーンを多言語に展開
  product-photo-visuals	ユーザー自身の写真を使ったデザイン
  visual-refresh	既存のビジュアルの編集、バリエーション作成、ローカライズ、取り消し

• リモートMCPサーバー — Claude、ChatGPT、Cursor、その他すべてのMCPクライアント向けです。インストールは不要です。

• canvora CLI — シェルネイティブのエージェント、cronジョブ、CI向けです。依存関係はありません。

Canvoraのサービス自体はホスト型です。このリポジトリにはクライアント用ツール、スキル、ドキュメントが含まれています。

オプション1 — スキル + CLI（Claude Code、Cursor、Codex、OpenClaw、シェルネイティブのエージェント）

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 "..."	1 つのビジュアルを自然言語で編集します（変更をプレビューします。--yes を指定すると自動で確定します）
canvora status <id>	生成状況を確認し、出力 URL を一覧表示します
canvora download <id> --dir out/	すべての出力ファイルをローカルに保存します
canvora formats	寸法付きの全 82 種類のフォーマット ID を表示します（ライブカタログ）
canvora brands	ブランドキットを表示します（--brand <uuid> で指定）
canvora credits	クレジット残高（ビジュアル 1 点あたり 10 クレジット、カルーセル／デッキのスライド 1 枚あたり 15 クレジット）

すべてのコマンドで、機械可読な標準出力を得るには --json を指定します。進捗とエラーは標準エラー出力に送られるため、パイプ処理はクリーンに保たれます。終了コード：成功は 0、失敗は 1、使用方法のエラーは 2 です。

generate のフラグ

--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 クライアント）

リモートサーバーは 1 つ、OAuth サインインに対応し、接続時にエージェントが検出できるツールは 16 個です。

サーバー URL	https://api.canvora.ai/mcp（ストリーミング可能な HTTP）
Claude	設定 → コネクタ → カスタムコネクタを追加 → OAuth Client ID claude_mcp
ChatGPT	設定 → アプリ → 開発者モード → アプリを作成 → OAuth Client ID chatgpt_mcp
レジストリ	公式 MCP レジストリ の ai.canvora/canvora — Glama、Smithery、mcpservers.org にも掲載されています

手順：canvora.ai/help/integrations/mcp-setup

オプション 3 — REST API を直接利用

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

エージェントによる活用例

• クライアント向けコンテンツパイプライン — ブリーフを入力すると、ブランドに沿った複数フォーマットのキャンペーンが出力され、投稿ツールによってスケジュールされます
• 多言語キャンペーン — 一度生成したら、canvora localize で 10 の市場向けにローカライズできます。レイアウトは維持され、テキストは各言語に合わせて翻訳されます（スキル）
• 保存されやすいカルーセル — 最初にフックを置く構成とスライドごとのアートディレクションを、スキルとして組み込んでいます（スキル）
• ドキュメント → デッキ — PDF レポートを --file-url に指定すると、プレゼンテーション用のスライドが生成されます
• 広告セット — 1 つの商品 URL から ad_square,ad_landscape,ad_portrait を生成し、すべての掲載枠に対応します

ソフトウェアからの呼び出しを想定した設計

• 予測可能なコスト — クレジット料金は固定です（ビジュアル 1 点あたり 10、スライド 1 枚あたり 15）。大規模なジョブの前に canvora credits で確認できます。生成に失敗した場合、クレジットは自動で返金されます。
• 人間が確認できる仕組み — エージェントが作成したものはすべて Canvora のダッシュボードにも表示され、公開前に確認、編集、エクスポートできます。
• スコープを限定でき、取り消し可能なキー — 保存時にハッシュ化され、キーごとの使用状況を追跡でき、ワンクリックで取り消せます。
• CDN 上の出力 — エージェントが投稿、埋め込み、またはスケジューラーへの受け渡しに使える安定した URL を提供します。
• すべてのプランで利用可能 — API と MCP へのアクセスは Free プランにも含まれます（無料クレジット付き、カード不要）。

リンク

• canvora.ai/for-agents — エージェント向けの概要
• MCP セットアップガイド · API ガイド
• 料金

MIT ライセンス（このリポジトリ内の CLI、スキル、ドキュメントが対象です）。