Campaign Creator Provider

Proveedor de TypeScript independiente y local-first que crea una estrategia de campaña bilingüe, textos para canales y un calendario de publicación a partir de una URL y un objetivo. Expone una API de biblioteca tipada, un contrato JSON-RPC stdio con forma de MCP y una pequeña API HTTP desplegada en Vercel.

• API en vivo: https://campaign-creator-provider.vercel.app

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

• Repositorio: https://github.com/CaBsCrypto/campaign-creator-provider

El proveedor genera contenido de prueba determinista. No obtiene la URL enviada, no llama a servicios externos, no publica contenido, no persiste entradas ni interactúa con Stellar Bazaar.

Características

• Salida en español (es, predeterminado) e inglés (en)

• Estrategia, textos para canales y un calendario configurable de 1 a 30 días

• Canales de X, LinkedIn, Instagram y correo electrónico

• Definición de herramienta JSON Schema y errores de validación estructurados

• Puntos de entrada HTTP, TypeScript y stdio con forma de MCP sobre un único generador

• Generación determinista sin red

• Licencia Apache-2.0

Related MCP server: publiar-mcp

API HTTP

Descubrimiento

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

Estado

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

Crear una campaña

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"]}'

Los campos obligatorios son url (una URL HTTP/HTTPS absoluta) y objective. Los campos opcionales son:

Las solicitudes correctas devuelven el objeto de campaña directamente con HTTP 200. Las entradas no válidas devuelven HTTP 400 y un objeto de error JSON estable con los problemas de validación. Las rutas admiten CORS y no almacenan en caché las respuestas.

API de TypeScript

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"]
});

El CampaignPlan devuelto contiene strategy, copy, calendar, contexto de origen y metadatos del contenido de prueba.

Contrato stdio con forma de MCP

El servidor compilado acepta un objeto JSON-RPC 2.0 por línea en stdin y escribe una respuesta por línea en stdout. Implementa initialize, tools/list, tools/call y 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

El resultado de create_campaign incluye contenido de texto MCP y la misma campaña en structuredContent. Los argumentos no válidos devuelven isError: true con problemas de validación estructurados. Consulta service-card.json para conocer los metadatos de descubrimiento.

Desarrollo local

Se requiere Node.js 22.6 o posterior.

npm ci
npm run test:all

test:all comprueba los tipos tanto de la biblioteca como de los manejadores de Vercel, ejecuta la suite de pruebas y compila el paquete distribuible.

Desplegar un proyecto de Vercel separado

Con la CLI de Vercel autenticada:

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

El vercel.json versionado compila explícitamente los tres puntos de entrada serverless. Los metadatos de enlace locales .vercel/ de Vercel se ignoran y nunca deben confirmarse en el repositorio.

Límite del contenido de prueba

La URL se usa únicamente como contexto de campaña y nunca se solicita. Las entradas normalizadas idénticas producen una salida idéntica, incluidos campaignId y generatedAt. El texto es material de prueba genérico, no una afirmación de que el sitio referenciado fue analizado.

Este repositorio y el despliegue son independientes. No se registran en Stellar Bazaar ni lo modifican.

Licencia

Apache License 2.0. Véase LICENSE.