agentic-campaign

agentic-campaign

パッケージ · クイックスタート · ランタイムの利用形態

agentic-campaign は、下書きカレンダー、明示的なスロット承認、テキスト形式のキューのエクスポートを必要とする開発者向けの、オープンソースのソーシャルキャンペーンプランナーです。 TypeScript SDK、コマンドラインインターフェース（CLI）、または Model Context Protocol（MCP）サーバーとして動作します。 キャンペーンの計画と承認はローカルで行われ、このパッケージがソーシャル投稿を公開することはありません。

インストール

npm install agentic-campaign

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

最初のキャンペーン下書きをエクスポートする

これを 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 は、コードやエージェントのセッションで使える、ローカルでの計画生成と承認済みのテキストエクスポートを提供します。

比較

以下の公式ページを基に、2026-10-14 時点の対象範囲を確認しました。

対象範囲	agentic-campaign	Buffer	Hootsuite
主なワークフロー	ローカルで計画を生成し、下書きをエクスポート	ソーシャル投稿を計画、予約、公開	ソーシャル投稿を計画、予約、公開
カレンダーの表現	メモリ内のキャンペーンオブジェクト	製品のコンテンツカレンダー	製品のコンテンツカレンダー
このパッケージでの公開	なし	Buffer アダプターなし	Hootsuite アダプターなし

対応範囲

利用形態	状態	動作
キャンペーン概要	✓	ブランド、目標、プラットフォームのラベル、スロット数、開始日
コンテンツの柱	✓	固定の 3 つの柱：教育、実績、エンゲージメント
フォーマットのラベル	✓	ローテーションする 4 つのラベル：短文投稿、カルーセル、動画、ストーリー
スロットの承認	✓	2 つの明示的なフラグによる下書きから承認済みへの移行
キューのエクスポート	✓	承認済みかつ予約済みのスロットをテキスト形式のキュー項目に変換
LinkedIn と X (Twitter)	ラベルのみ	ターゲット文字列の例。ネットワークアダプターなし
その他のプラットフォーム名	ラベルのみ	任意の空でない文字列。サポート対象のレジストリなし
ローカルテキストルーター	足場のみ	レシートの生成のみ
汎用 HTTP テキストルーター	✓	{text} をエンドポイントに送信。キャンペーンのエクスポートとは別
Cloudflare Workers ハンドラー	キャンペーン用の足場のみ	ヘルスチェックとテキスト概要のみ。キャンペーン用ルートなし

ソーシャル投稿の公開コネクターは 0 個、共通テキストルーティングアダプターは 2 個、固定の柱は 3 つ、フォーマットのラベルは 4 つです。 ソースとローカルテストで計画機能の動作を検証しています。この改訂では、外部連携の認証情報チェックは 0 件です。

よくあるユースケース

1. Node.js のリリースチームが、LinkedIn と X (Twitter) のラベル用に下書きスロットを生成します。
2. TypeScript を使う代理店が、クライアントのブランドごとに個別のキャンペーンオブジェクトを計画します。
3. MCP クライアントの開発者が、1 回のエージェントセッション内でスロットを確認し、承認します。
4. カスタム公開機能の開発者が、独自のパイプラインを通じて {brand, text, targets} のキュー項目を利用します。

特徴

• キャンペーンプラン： createCampaign は下書きスロットを作成します。クイックスタートを参照してください。
• 明示的な承認： approveSlot では live: true と approved: true が必要です。
• キューのエクスポート： exportQueue は承認済みまたはスケジュール済みのスロットを保持し、下書きであることを示す文言を含めます。
• エージェントセッション： MCP ツールはキャンペーンをサーバーのインメモリマップに保持します。
• 共有ユーティリティ： テキスト要約、汎用ディスパッチ、ガード、ロギング、インメモリのコストレポートを SDK からエクスポートします。

ランタイムの機能

Node.js SDK は createCampaign、approveSlot、exportQueue、共有テキストユーティリティをエクスポートします。

CLI コマンド	動作
campaign create --brand Acme --goal launch --platforms linkedin,x --weeks 1 --posts-per-week 2	新しいキャンペーンを出力します。--start-date を指定できます
campaign list	現在のプロセスマップからキャンペーンを一覧表示します
campaign show --id <id>	そのマップからキャンペーンを読み込みます
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 ツールは次の 6 つです：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 によって、プラットフォームごとのスロット数ではなく、すべてのラベルを通じた合計スロット数が決まります。
• スロットはそれぞれ暦日で 1 日ずつ進みます。weeks によってスケジュールがその週数内に制限されることはありません。
• ブリーフの quietHours は受け付けられますが、無視されます。スロットには日付のみが含まれ、投稿時刻は含まれません。
• 1 日あたりの上限は SDK 専用の入力です。ジェネレーターは各スロットの後も 1 日ずつ進みます。
• ピラー、フック、フォーマットには固定のコードテンプレートを使用します。キャンペーンのテキスト生成に言語モデルは使用されません。
• フォーマットのラベルによって、カルーセル画像、動画、ストーリー、添付ファイルが作成されることはありません。
• キャンペーン ID は、正規化されたブランド名と開始日を使用します。同じブランド名、同じ開始日のプランは、セッションマップ内のエントリーを上書きする場合があります。
• CLI と MCP のストレージはインメモリです。ファイルストア、データベース、再起動後の復旧機能はありません。
• エクスポート用のヘルパーがあるのは、下書きから承認済みへの遷移のみです。スケジュール設定と完了処理には、アプリケーションコードが必要です。
• キュー項目には日付、スロット ID、メディアが含まれません。後続のコードで、スケジュールのメタデータを別途保持する必要があります。
• 自動配信、再試行、重複排除、プラットフォーム認証、エンゲージメント分析はありません。
• コストレポートは汎用テキストディスパッチの単位を記録します。キャンペーンの計画と承認では、コストは記録されません。

統合ガイド

• Node.js キャンペーン承認・エクスポートの例
• CLI と MCP のキャンペーンライフサイクルリファレンス
• エクスポートとストレージの制約

エクスポートツールのソースでは、形式が agentic-publish 互換であると説明されています。 このパッケージは agentic-publish を呼び出さず、配信互換性も検証しません。 独立した公開ドキュメントサイトは設定されていません。

ステータス

バージョン 0.1.0 は初期リリースです。1.0 までは API が変更される可能性があります。 問題は GitHub の Issues から報告してください。 公開事例はこのリポジトリでは公開されていません。

FAQ

agentic-campaign とは何ですか？

agentic-campaign はローカルのキャンペーンプランを生成し、レビュー済みの下書きテキストをエクスポートします。 開発者向けに SDK、CLI、MCP インターフェースを提供します。

検証済みの連携機能はどれですか？

agentic-campaign には、ソーシャルメディアへの公開コネクターや、プラットフォームの認証情報を検証する機能はありません。 共有の汎用 HTTP テキストルーターは、キャンペーンのワークフローとは別のものです。

agentic-campaign はマネージド公開サービスを提供しますか？

agentic-campaign は、実行プロセス内でデータを生成します。 ストレージ、デプロイ、編集レビュー、および任意の公開サービスは、ユーザー側で用意してください。

agentic-campaign は Buffer とどう違いますか？

agentic-campaign は、キャンペーンオブジェクトと、承認済みの項目に絞ったキューをコードで生成します。 Buffer は、ソーシャルメディアの計画・公開プロダクトを提供しています。詳しくは、公開機能の概要をご覧ください。

agentic-campaign は Hootsuite とどう違いますか？

agentic-campaign は、ローカルの計画 SDK とエージェントツールを公開します。 Hootsuite は、コンテンツカレンダーと公開ワークフローを提供しています。詳しくは、公開機能の概要をご覧ください。

agentic-campaign は LinkedIn や X (Twitter) に公開しますか？

agentic-campaign は、それらの名前をターゲットラベルとして保存します。 ソーシャルネットワークへのリクエストは行わず、プラットフォーム固有の制約も検証しません。

作成後に agentic-campaign の一覧にキャンペーンが表示されないのはなぜですか？

agentic-campaign は、単独の CLI 呼び出しごとに新しいインメモリマップを作成します。 キャンペーンを保持するには、共有の SDK オブジェクトか、永続的な MCP サーバーセッションを使用してください。

agentic-campaign は言語モデルでコピーを生成しますか？

agentic-campaign は、固定のピラー説明とフックテンプレートを使用します。 エクスポートには AI 支援についての開示が含まれますが、モデル API は呼び出されません。

ライブ承認では何が行われますか？

agentic-campaign で下書きスロットを承認済みに変更するには、ライブフラグと承認フラグの両方が必要です。 このローカルでの状態変更により、スロットがエクスポート可能になります。外部への送信は行われません。

コントリビューション

リポジトリで npm ci、npm run build、npm run typecheck、npm test を実行してください。

ライセンス

MIT です。ライセンステキストをご覧ください。