agentic-carousel

agentic-carousel

agentic-carousel 是一款面向 Node.js 应用和 AI Agent 的开源轮播卡片组生成器，支持输出 JSON、可打印的 HTML，以及社交平台文本预设。

安装

npm install agentic-carousel

需要 Node.js 18 或更高版本。包含 TypeScript 声明和两个直接运行时依赖。

创建你的第一个卡片组

将此示例保存为 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 的幻灯片。 无需凭据、模型调用或网络请求。

功能与支持范围

• 接受以换行符或竖线分隔的大纲，也接受标题/正文对象数组。
• 在提供的内容前后添加引入页和行动号召页。
• 要求在最后一页添加披露文本；SDK 选项可自定义该文本。
• 将转义后的文本渲染为包含内联 CSS 的独立 HTML。
• 使用 exportPlan 列出预期的 JSON、HTML 和 PNG 文件名；该函数不会写入任何文件。

文本预设	状态	标题限制	正文限制
Instagram	仅本地验证	80 个字符	220 个字符
LinkedIn	仅本地验证	120 个字符	300 个字符
TikTok	仅本地验证	70 个字符	180 个字符

代码定义了三个预设。这些是软件包规则，不包含实时平台验证或发布集成。

运行时接口

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 提供五个操作命令，以及 --help 和 --version。carousel 前缀为可选项。 创建命令接受 --platform instagram|linkedin|tiktok 并输出 { deck, plan }；不会保存这两个对象。 Model Context Protocol（MCP）服务提供五种工具：create_carousel、validate_carousel、render_carousel_html、export_carousel_plan 和 get_cost_report。 agentic-carousel-mcp 二进制文件会启动同一服务。 你部署的 Worker 提供 GET /health、POST /create 和 POST /validate；创建命令使用默认的 Instagram 预设。

行为限制

卡片组包含 2–10 张幻灯片，包括自动生成的引入页和最后一页；大纲最多包含八张内容幻灯片。 所有预设使用相同的 HTML 尺寸。文本预设不保证平台会接受，也不保证文本能在视觉上适配。 该软件包不会创建 PNG 文件或 PDF 文件，也不会上传或发布幻灯片。 CLI 接受 --live，但生成过程仍在本地进行。没有远程生成模式。 轮播操作不会记录成本单位。共享 SDK 还导出通用文本摘要和路由辅助函数。

链接与状态

软件包 · 源代码与支持

0.1.0 版的 API 可能会发生变化。目前尚未发布公开案例研究。 贡献前，请运行 npm run build、npm run typecheck 和 npm test。

许可证

MIT。