Campaign Creator Provider

独立したローカルファーストのTypeScriptプロバイダーで、URLと目的からバイリンガルのキャンペーン戦略、チャネルコピー、公開カレンダーを作成します。型付きライブラリAPI、MCP形式のJSON-RPC stdioコントラクト、およびVercelにデプロイされた小規模なHTTP APIを公開します。

• ライブAPI: https://campaign-creator-provider.vercel.app

• ヘルスチェック: https://campaign-creator-provider.vercel.app/health

• リポジトリ: https://github.com/CaBsCrypto/campaign-creator-provider

プロバイダーは決定的なフィクスチャコンテンツを生成します。送信されたURLを取得したり、外部サービスを呼び出したり、コンテンツを公開したり、入力を永続化したり、Stellar Bazaarとやり取りしたりすることはありません。

Features

• スペイン語（es、デフォルト）と英語（en）の出力

• 戦略、チャネルコピー、および設定可能な1–30日のカレンダー

• X、LinkedIn、Instagram、メールのチャネル

• JSON Schemaツール定義と構造化された検証エラー

• 単一のジェネレーター上でのHTTP、TypeScript、MCP形式のstdioエントリポイント

• ネットワーク不要の決定的生成

• Apache-2.0ライセンス

Related MCP server: publiar-mcp

HTTP API

ディスカバリ

curl https://campaign-creator-provider.vercel.app/

ヘルスチェック

curl https://campaign-creator-provider.vercel.app/health

キャンペーンを作成

curl -X POST https://campaign-creator-provider.vercel.app/api/campaign \
  -H "content-type: application/json" \
  -d '{"url":"https://example.com/product","objective":"Increase qualified sign-ups","locale":"en","days":7,"channels":["linkedin","email"]}'

必須フィールドはurl（絶対HTTP/HTTPS URL）とobjectiveです。オプションフィールドは次のとおりです。

成功したリクエストは、HTTP 200でキャンペーンオブジェクトを直接返します。無効な入力はHTTP 400と、検証問題を含む安定したJSONエラーオブジェクトを返します。ルートはCORSをサポートし、レスポンスをキャッシュしません。

TypeScript API

import { createCampaign } from "@stellar-bazaar/campaign-creator-provider";

const campaign = createCampaign({
  url: "https://example.com/product",
  objective: "Increase qualified sign-ups",
  locale: "en",
  days: 7,
  channels: ["linkedin", "email"]
});

返されるCampaignPlanには、strategy、copy、calendar、ソースコンテキスト、およびフィクスチャメタデータが含まれます。

MCP形式のstdioコントラクト

ビルドされたサーバーは、stdinで1行につき1つのJSON-RPC 2.0オブジェクトを受け入れ、stdoutで1行につき1つのレスポンスを書き出します。initialize、tools/list、tools/call、notifications/initializedを実装しています。

echo '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"create_campaign","arguments":{"url":"https://example.com","objective":"Aumentar registros","locale":"es"}}}' | node dist/server.js

create_campaignの結果には、MCPテキストコンテンツと、structuredContent内の同じキャンペーンが含まれます。無効な引数は、構造化された検証問題とともにisError: trueを返します。ディスカバリメタデータについては、service-card.jsonを参照してください。

ローカル開発

Node.js 22.6以降が必要です。

npm ci
npm run test:all

test:allは、ライブラリとVercelハンドラーの両方を型チェックし、テストスイートを実行し、配布可能なパッケージをビルドします。

別のVercelプロジェクトをデプロイする

Vercel CLIで認証済みの場合：

vercel link --project campaign-creator-provider
vercel deploy --prod

追跡されているvercel.jsonは、3つのサーバーレスエントリポイントを明示的にビルドします。Vercelのローカル.vercel/リンクメタデータは無視され、決してコミットしてはなりません。

フィクスチャの境界

URLはキャンペーンコンテキストとしてのみ使用され、リクエストされることはありません。同一の正規化された入力は、campaignIdとgeneratedAtを含め、同一の出力を生成します。コピーは一般的なフィクスチャ素材であり、参照されたサイトが分析されたという主張ではありません。

このリポジトリとデプロイメントは独立しています。Stellar Bazaarに登録したり、変更したりすることはありません。

ライセンス

Apache License 2.0。LICENSEを参照してください。