Campaign Creator Provider

一个独立的、本地优先的 TypeScript provider，基于 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

该 provider 生成确定性的 fixture 内容。它不会请求提交的 URL、调用外部服务、发布内容、持久化输入，也不会与 Stellar Bazaar 交互。

功能

• 西班牙语（es，默认）和英语（en）输出

• 策略、渠道文案，以及可配置的 1–30 天日历

• X、LinkedIn、Instagram 和电子邮件渠道

• JSON Schema 工具定义和结构化验证错误

• 基于同一个 generator 的 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、来源上下文和 fixture 元数据。

MCP 形态的 stdio 契约

构建后的 server 在 stdin 中每行接受一个 JSON-RPC 2.0 对象，并在 stdout 中每行写入一个响应。它实现了 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 项目

在 Vercel 命令行已通过认证时：

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

已跟踪的 vercel.json 显式构建了三个 serverless 入口。Vercel 本地的 .vercel/ 链接元数据会被忽略，且绝不应提交。

Fixture 边界

该 URL 仅用作营销上下文，绝不会被请求。相同的规范化输入会产生完全相同的输出，包括 campaignId 和 generatedAt。文案属于通用的 fixture 素材，并不代表所引用的网站已被分析。

此仓库和此部署彼此独立。它们不会向 Stellar Bazaar 注册，也不会修改 Stellar Bazaar。

许可证

Apache License 2.0。请参见 LICENSE。