agentic-carousel

agentic-carousel

agentic-carousel は、JSON 出力、印刷可能な HTML、ソーシャルプラットフォーム向けテキストプリセットを備えた、Node.js アプリケーションおよび AI エージェント向けのオープンソースのカルーセルデッキ生成ツールです。

インストール

npm install agentic-carousel

Node.js 18 以降が必要です。TypeScript 宣言と、直接依存するランタイム依存関係 2 つが含まれています。

最初のデッキを作成する

この例を carousel.mjs として保存し、node carousel.mjs を実行します。

import { writeFileSync } from "node:fs";
import { createCarousel, validateCarousel, renderCarouselHtml } from "agentic-carousel";
const deck = createCarousel("Better handoffs", "Give context|Name an owner");
writeFileSync("carousel-deck.json", JSON.stringify(deck, null, 2));
writeFileSync("carousel.html", renderCarouselHtml(deck));
console.log(deck.slides.length, validateCarousel(deck).valid);

4 true と表示されます。ブラウザーで carousel.html を開くと、1080 × 1350 のスライドを 4 枚確認できます。 認証情報、モデル呼び出し、ネットワークリクエストは不要です。

機能と対応状況

• 改行区切りまたはパイプ区切りのアウトライン、あるいはタイトル／本文オブジェクトの配列を受け付けます。
• 提供されたコンテンツの前後に、フックと行動喚起のスライドを追加します。
• 最終スライドに開示文を必須にします。SDK のオプションでカスタマイズできます。
• エスケープしたテキストを、インライン CSS を含む自己完結型 HTML にレンダリングします。
• exportPlan で想定される JSON、HTML、PNG のファイル名を一覧表示します。ファイルは書き込みません。

テキストプリセット	状況	タイトルの上限	本文の上限
Instagram	ローカル検証のみ	80 文字	220 文字
LinkedIn	ローカル検証のみ	120 文字	300 文字
TikTok	ローカル検証のみ	70 文字	180 文字

コードでは 3 つのプリセットを定義しています。これらはパッケージ内のルールであり、プラットフォーム上での実際の検証や公開機能はありません。

実行環境のインターフェース

npx agentic-carousel carousel create --topic "Better handoffs" --slides "Give context|Name an owner"
npx agentic-carousel carousel validate --file carousel-deck.json --platform linkedin
npx agentic-carousel carousel render --file carousel-deck.json > carousel.html
npx agentic-carousel costs
npx agentic-carousel mcp

CLI には 5 つの操作コマンドがあり、--help と --version も使用できます。carousel プレフィックスは省略可能です。 create は --platform instagram|linkedin|tiktok を受け付け、{ deck, plan } を出力します。どちらのオブジェクトも保存しません。 Model Context Protocol（MCP）サーバーは、create_carousel、validate_carousel、render_carousel_html、export_carousel_plan、get_cost_report の 5 つのツールを公開します。 agentic-carousel-mcp バイナリは同じサーバーを起動します。 デプロイする Worker には GET /health、POST /create、POST /validate があり、create はデフォルトの Instagram プリセットを使用します。

動作上の制限

デッキは、生成されるフックと最終スライドを含めて 2～10 枚のスライドで構成されます。アウトラインに含められるコンテンツスライドは最大 8 枚です。 すべてのプリセットで同じ HTML サイズを使用します。テキストプリセットは、プラットフォームでの承認や見た目の収まりを保証するものではありません。 このパッケージは PNG ファイルや PDF ファイルを作成せず、スライドをアップロードまたは公開しません。 CLI は --live を受け付けますが、生成はローカルで行われます。リモート生成モードはありません。 カルーセル操作ではコスト単位を記録しません。共有 SDK では、汎用のテキスト要約ヘルパーとルーティングヘルパーもエクスポートされます。

リンクとステータス

パッケージ · ソースとサポート

バージョン 0.1.0 の API は変更される可能性があります。公開事例はまだ公開されていません。 貢献する前に、npm run build、npm run typecheck、npm test を実行してください。

ライセンス

MIT。