Campaign Creator Provider

독립적이고 로컬 우선(local-first) TypeScript 프로바이더로, URL과 목표(objective)로부터 이중 언어 캠페인 전략, 채널 카피, 게시 캘린더를 만듭니다. 타입이 지정된 라이브러리 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

이 프로바이더는 결정적(deterministic) 픽스처 콘텐츠를 생성합니다. 제출된 URL을 가져오지 않으며, 외부 서비스를 호출하지 않고, 콘텐츠를 게시하거나 입력값을 저장하지 않으며, Stellar Bazaar와 상호작용하지 않습니다.

기능

• 스페인어(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에 한 줄에 하나의 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 CLI로 인증된 상태에서:

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

추적되는 vercel.json은 세 개의 서버리스 엔트리포인트를 명시적으로 빌드합니다. Vercel의 로컬 .vercel/ 링크 메타데이터는 무시되며 절대 커밋되어서는 안 됩니다.

픽스처 경계

URL은 캠페인 컨텍스트로만 사용되며 절대 요청되지 않습니다. 동일하게 정규화된 입력은 campaignId와 generatedAt을 포함하여 동일한 출력을 생성합니다. 카피는 범용 픽스처 자료이며, 참조된 사이트가 분석되었다는 주장이 아닙니다.

이 저장소와 배포는 독립적입니다. Stellar Bazaar에 등록하거나 수정하지 않습니다.

라이선스

Apache License 2.0. LICENSE를 참조하세요.