Campaign Creator Provider

Независимый, локально-ориентированный TypeScript-провайдер, который создаёт двуязычную стратегию кампании, тексты для каналов и календарь публикаций на основе URL и цели. Он предоставляет типизированный библиотечный API, MCP-совместимый JSON-RPC stdio-контракт и небольшой HTTP API, развёрнутый на Vercel.

• Живой API: https://campaign-creator-provider.vercel.app

• Health: https://campaign-creator-provider.vercel.app/health

• Репозиторий: https://github.com/CaBsCrypto/campaign-creator-provider

Провайдер генерирует детерминированный фикстурный контент. Он не загружает указанный URL, не вызывает внешние сервисы, не публикует контент, не сохраняет входные данные и не взаимодействует со Stellar Bazaar.

Возможности

• Вывод на испанском (es, по умолчанию) и английском (en) языках

• Стратегия, тексты для каналов и настраиваемый календарь на 1–30 дней

• Каналы: X, LinkedIn, Instagram и email

• JSON Schema определение инструмента и структурированные ошибки валидации

• HTTP, TypeScript и MCP-совместимые stdio-точки входа поверх единого генератора

• Генерация без сетевых запросов, детерминированный вывод

• Лицензия Apache-2.0

Related MCP server: publiar-mcp

HTTP API

Обнаружение

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

Health

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-контракт

Собранный сервер принимает по одному JSON-RPC 2.0 объекту на строку в stdin и записывает по одному ответу на строку в 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 CLI:

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

Отслеживаемый vercel.json явно собирает три серверless-точки входа. Локальные метаданные Vercel .vercel/ игнорируются и никогда не должны попадать в коммиты.

Граница фикстурного контента

URL используется только как контекст кампании и никогда не запрашивается. Идентичные нормализованные входные данные дают идентичный вывод, включая campaignId и generatedAt. Тексты — это универсальный фикстурный материал, а не утверждение о содержимом указанного сайта.

Этот репозиторий и развёртывание независимы. Они не регистрируются в Stellar Bazaar и не изменяют его.

Лицензия

Apache License 2.0. См. LICENSE.