Campaign Creator Provider

Unabhängiger, lokaler TypeScript-Provider, der aus einer URL und einem Ziel eine zweisprachige Kampagnenstrategie, Kanaltexte und einen Veröffentlichungskalender erstellt. Er stellt eine typisierte Bibliotheks-API, einen MCP-förmigen JSON-RPC-stdio-Vertrag und eine kleine, auf Vercel bereitgestellte HTTP-API bereit.

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

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

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

Der Provider generiert deterministische Fixture-Inhalte. Er ruft die übermittelte URL nicht ab, ruft keine externen Dienste auf, veröffentlicht keine Inhalte, speichert keine Eingaben und interagiert nicht mit Stellar Bazaar.

Funktionen

• Spanische (es, Standard) und englische (en) Ausgabe

• Strategie, Kanaltexte und ein konfigurierbarer Kalender über 1–30 Tage

• X-, LinkedIn-, Instagram- und E-Mail-Kanäle

• JSON-Schema-Tooldefinition und strukturierte Validierungsfehler

• HTTP-, TypeScript- und MCP-förmige stdio-Einstiegspunkte über einen Generator

• Netzwerkfreie deterministische Generierung

• Apache-2.0-lizenziert

Related MCP server: publiar-mcp

HTTP-API

Discovery

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

Health

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

Kampagne erstellen

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

Pflichtfelder sind url (eine absolute HTTP/HTTPS-URL) und objective. Optionale Felder sind:

Erfolgreiche Anfragen geben das Kampagnenobjekt direkt mit HTTP 200 zurück. Ungültige Eingaben geben HTTP 400 und ein stabiles JSON-Fehlerobjekt mit Validierungsproblemen zurück. Routen unterstützen CORS und speichern Antworten nicht zwischen.

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

Der zurückgegebene CampaignPlan enthält strategy, copy, calendar, Quellkontext und Fixture-Metadaten.

MCP-förmiger stdio-Vertrag

Der erstellte Server akzeptiert ein JSON-RPC-2.0-Objekt pro Zeile auf stdin und schreibt eine Antwort pro Zeile auf stdout. Er implementiert initialize, tools/list, tools/call und 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

Das create_campaign-Ergebnis enthält MCP-Textinhalt und dieselbe Kampagne in structuredContent. Ungültige Argumente geben isError: true mit strukturierten Validierungsproblemen zurück. Siehe service-card.json für Discovery-Metadaten.

Lokale Entwicklung

Node.js 22.6 oder neuer ist erforderlich.

npm ci
npm run test:all

test:all typprüft sowohl die Bibliothek als auch die Vercel-Handler, führt die Testsuite aus und erstellt das verteilbare Paket.

Ein separates Vercel-Projekt bereitstellen

Mit authentifizierter Vercel-CLI:

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

Die nachverfolgte vercel.json erstellt explizit die drei serverlosen Einstiegspunkte. Die lokalen .vercel/-Verknüpfungsmetadaten von Vercel werden ignoriert und dürfen niemals eingecheckt werden.

Fixture-Grenze

Die URL wird nur als Kampagnenkontext verwendet und niemals angefordert. Identische normalisierte Eingaben erzeugen identische Ausgaben, einschließlich campaignId und generatedAt. Kopien sind generisches Fixture-Material, keine Behauptung, dass die referenzierte Website analysiert wurde.

Dieses Repository und die Bereitstellung sind unabhängig. Sie registrieren sich nicht bei Stellar Bazaar und ändern es nicht.

Lizenz

Apache License 2.0. Siehe LICENSE.