agentic-campaign

agentic-campaign

软件包 · 快速入门 · 运行时接口

agentic-campaign 是一款开源社交活动规划工具，面向需要草稿日历、明确的时段审批和文本队列导出的开发者。 它可作为 TypeScript SDK、命令行界面（CLI）或 Model Context Protocol（MCP）服务运行。 活动规划和审批在本地进行；此软件包绝不会发布社交帖子。

安装

npm install agentic-campaign

需要 Node.js 18 或更高版本。软件包内含 TypeScript 声明，并有两个直接运行时依赖项。

导出你的第一个活动草稿

将以下内容保存为 campaign-demo.mjs。无需凭据、环境变量或 .env 加载器。

import { createCampaign, approveSlot, exportQueue } from "agentic-campaign";

const campaign = createCampaign({
  brand: "Acme",
  goal: "launch a feature",
  platforms: ["linkedin", "x"],
  weeks: 1,
  postsPerWeek: 2,
  startDate: "2026-11-01",
});
console.log(campaign.schedule.length);
console.log(exportQueue(campaign).length);
const approved = approveSlot(campaign, "slot-1", { live: true, approved: true });
const queue = exportQueue(approved);
console.log(queue.length, queue[0].brand, queue[0].targets[0]);

node campaign-demo.mjs

成功时会输出 2、0 和 1 Acme linkedin。 审批标志会更改本地状态；不会发送帖子。 导出的文本包含 AI 辅助声明，需经过编辑审核。

工作原理

Brief -> deterministic pillars and daily draft slots
Draft slot + explicit approval -> approved slot
Approved or scheduled slots -> { brand, text, targets } queue
Queue -> a downstream publisher you implement separately

项目缘起

开发者需要能够检查并在工具之间传递的活动规划数据。 Buffer 和 Hootsuite 提供带有发布工作流的社交日历。 agentic-campaign 为代码和 Agent 会话提供本地计划生成和经过审批筛选的文本导出。

对比

截至 2026-10-14，根据下方链接的官方页面核查范围。

范围	agentic-campaign	Buffer	Hootsuite
主要工作流	生成本地计划并导出草稿	规划、安排并发布社交帖子	规划、安排并发布社交帖子
日历表示形式	内存中的活动对象	产品内容日历	产品内容日历
此软件包中的发布功能	无	没有 Buffer 适配器	没有 Hootsuite 适配器

覆盖范围

接口	状态	行为
活动简报	✓	品牌、目标、平台标签、时段数量和开始日期
内容支柱	✓	三个固定支柱：教育、证明、互动
格式标签	✓	四种轮换标签：短帖、轮播、视频、快拍
时段审批	✓	通过两个明确的标志，将草稿转换为已审批状态
队列导出	✓	已审批且已安排的时段会转换为文本队列项
LinkedIn 和 X (Twitter)	仅标签	示例目标字符串；没有网络适配器
其他平台名称	仅标签	任意非空字符串；没有支持平台的注册表
本地文本路由器	脚手架	仅生成回执
通用 HTTP 文本路由器	✓	向你的端点发送 {text}；与活动导出分开
Cloudflare Workers 处理程序	活动功能为脚手架	仅提供健康状态和文本摘要；没有活动路由

社交发布连接器数量为零，共用文本路由适配器有两个，固定支柱有三个，格式标签有四种。 源代码和本地测试会验证规划行为。本次重写未对任何外部集成进行凭据检查。

常见用例

1. Node.js 发布团队为 LinkedIn 和 X (Twitter) 标签生成草稿时段。
2. TypeScript 代理机构为客户品牌规划独立的活动对象。
3. MCP 客户端开发者在一次 Agent 会话中审核并批准时段。
4. 自定义发布器开发者通过自己的流水线处理 {brand, text, targets} 队列项。

功能

• Campaign 计划： createCampaign 会创建草稿排期；请参阅快速入门。
• 明确审批： approveSlot 要求 live: true 和 approved: true。
• 队列导出： exportQueue 会保留已批准或已排期的排期项，并附上草稿披露文本。
• Agent 会话： MCP 工具会将 Campaign 保存在服务端的内存映射中。
• 共享实用工具： 文本摘要、通用分发、保护措施、日志记录和内存成本报告均由 SDK 导出。

运行时接口

Node.js SDK 导出 createCampaign、approveSlot、exportQueue 和共享文本实用工具。

CLI 命令	行为
campaign create --brand Acme --goal launch --platforms linkedin,x --weeks 1 --posts-per-week 2	打印新的 Campaign；接受 --start-date
campaign list	列出当前进程映射中的 Campaign
campaign show --id <id>	从该映射中读取 Campaign
campaign approve-slot --id <id> --slot slot-1 --live --approve	批准该映射中的草稿
campaign export --id <id>	导出该映射中已批准或已排期的排期项
costs	打印当前进程的成本单位
mcp	启动 stdio 服务端

使用 npx agentic-campaign 运行命令。--help 和 --version 会打印帮助信息和版本输出。 每次单独调用 CLI 都会启动新的映射。要完成完整生命周期，请使用 SDK 或持久的 MCP 会话。

全部六个 MCP 工具：create_campaign、list_campaigns、show_campaign、approve_campaign_slot、export_campaign_queue 和 get_cost_report。 使用 npx agentic-campaign mcp 或 npx agentic-campaign-mcp 启动。

Worker 源码仅公开 GET /health 和 POST /summarize。 可选的 PACK_NAME 会更改其健康检查响应标签。Worker 需要由你自行部署并保护。

交付和行为限制

• weeks * postsPerWeek 设置的是所有标签的排期项总数，而不是每个平台的排期项数。
• 排期项每次推进一个日历日。weeks 不会将排期限制在指定周数内。
• Brief 中的 quietHours 会被接受，但不会生效。排期项包含日期，不包含发布时间。
• 每日上限仅作为 SDK 输入；生成器仍会在每个排期项后推进一天。
• 支柱主题、开场钩子和格式使用固定代码模板。Campaign 文本不会由大模型生成。
• 格式标签不会生成轮播图、视频、快拍或附件。
• Campaign ID 使用规范化的品牌和开始日期。同一品牌、同一日期的计划可能会覆盖会话映射中的条目。
• CLI 和 MCP 的存储都在内存中。没有文件存储、数据库或重启恢复机制。
• 仅提供了将草稿转为已批准状态的导出辅助函数。排期和完成操作需要由应用代码实现。
• 队列项不包含日期、排期项 ID 和媒体。下游代码必须单独保留排期元数据。
• 没有自动交付、重试、去重、平台身份验证或互动分析功能。
• 成本报告会追踪通用文本分发单位。Campaign 规划和审批不会记录成本。

集成指南

• Node.js Campaign 审批与导出示例
• CLI 和 MCP Campaign 生命周期参考
• 导出和存储限制

导出工具在源码中将其数据结构描述为与 agentic-publish 兼容。 此程序包不会调用 agentic-publish，也不会验证交付兼容性。 未配置单独的公开文档站点。

状态

版本 0.1.0 为早期版本；在 1.0 发布前，API 可能会变更。 请通过 GitHub issues 报告问题。 此代码库未发布公开案例研究。

常见问题

什么是 agentic-campaign？

agentic-campaign 会生成本地 Campaign 计划，并导出经审核的草稿文本。 它为开发者提供 SDK、CLI 和 MCP 接口。

哪些集成经过验证？

agentic-campaign 没有社交平台发布连接器，也不验证平台凭据。 它共享的通用 HTTP 文本路由器与营销活动工作流相互独立。

agentic-campaign 提供托管发布服务吗？

agentic-campaign 会在你的进程内生成数据。 你需要提供存储、部署、编辑审核和任何发布渠道。

agentic-campaign 与 Buffer 有何不同？

agentic-campaign 会在代码中生成营销活动对象和经过审批筛选的队列。 Buffer 提供社交媒体规划与发布产品；请参阅其发布概览。

agentic-campaign 与 Hootsuite 有何不同？

agentic-campaign 提供本地规划 SDK 和 Agent 工具。 Hootsuite 提供内容日历和发布工作流；请参阅其发布概览。

agentic-campaign 会向 LinkedIn 或 X (Twitter) 发布内容吗？

agentic-campaign 会将这些名称存储为目标标签。 它不会向任何社交网络发送请求，也不会验证平台特定的限制。

为什么创建后，agentic-campaign list 没有显示任何营销活动？

每次独立调用 CLI 时，agentic-campaign 都会创建一个全新的内存映射。 使用共享的 SDK 对象或一个持久的 MCP 服务会话来保留营销活动。

agentic-campaign 会使用大模型生成文案吗？

agentic-campaign 使用固定的支柱描述和吸引点模板。 它的导出内容包含 AI 辅助声明，但不会调用模型 API。

实时审批有什么作用？

agentic-campaign 要求同时启用实时和审批标志，才能将草稿时段更改为已审批状态。 这种本地状态变更会使该时段符合导出条件，但不会向外部发送任何内容。

贡献

在仓库中运行 npm ci、npm run build、npm run typecheck 和 npm test。

许可证

MIT。请参阅许可证文本。