sns-content-factory

name	sns-content-factory
description	자료(MD/PDF)를 입력받아 카드뉴스·쇼츠·블로그 등 SNS 콘텐츠를 팩트 기반으로 자동 생산하는 도메인 무관 스킬. 부동산·쇼핑·교육·헬스 등 어떤 자료든 사실 출처(화이트리스트)로 삼아 콘텐츠를 찍어낸다. 트리거: "이 자료로 카드뉴스 만들어줘", "SNS 콘텐츠 제작", "쇼츠 만들어", "블로그 글 + 카드뉴스", "자료를 SNS로", PDF/MD를 주며 SNS 콘텐츠를 요청할 때.

SNS Content Factory

자료 하나로 사실에 충실한 SNS 콘텐츠 묶음을 생산한다. 틀은 고정, 데이터만 교체.

🚦 시작 전 (항상)

1. constitution.md의 불변 규칙 로드 — 특히 팩트 환각 0 / 비용 게이트 / 사람 컨펌
2. 입력 확인: 자료 파일(MD/PDF)이 있는가? 없으면 요청.
3. 산출 포맷 확인: 카드뉴스 / 쇼츠 / 블로그 중 무엇을, 몇 개?

📥 입력 계약

• 필수: 자료 파일(MD/PDF) = 콘텐츠의 유일한 사실 출처(화이트리스트)
• 선택: 톤/브랜드 레퍼런스, 발행 채널(Buffer), 포맷·개수, 도메인 설정(domain.yaml)

🔁 공통 워크플로우

[1] 자료 확보 → 텍스트 추출 (PDF는 pdftotext/Read pages)
[2] 구조화 추출 → 항목 리스트(JSON). 도메인 필드 스키마 적용
[3] 항목 선별 → 발행 개수만큼 (선별 규칙 + 중복/결측 제외)
[⚠️ 컨펌 1] 선별 항목 + 카피 초안 승인
[4] 포맷별 콘텐츠 변환 (아래 모듈)
[5] 비주얼 생성 → 1장 테스트 → 배치 (비용 게이트)
[⚠️ 컨펌 2] 팩트 전수 대조 + 발행 직전 통독
[6] 발행/산출

---

📇 카드뉴스 모듈 (MVP — 동작)

정본: docs/process/cardnews-sop.md 참조.

1. 추출: 자료 → 항목 JSON (도메인 fields 스키마)
2. 선별: select_rules로 N개 선별 (로테이션·중복 제외)
3. 5장 틀: Cover(훅) → 정보A → 정보B → 정보C → CTA — 도메인 card_mapping으로 의미 매핑
4. 카피: 각 장 텍스트는 화이트리스트 데이터만. 확정적 표현·원문 복붙 금지
5. 이미지: 나노바나나(이미지 생성 = 봉코덱스 위임) — 톤 레퍼런스 적용, 1장 테스트 → 배치
   • 텍스트는 화이트리스트만 렌더, 또는 원화+오버레이
6. 검수: 콘택트시트 + 텍스트 전수 대조(환각 0)
7. 산출: 1080×1080 PNG, <set>_<NN>_<role>.png + 세트 폴더 + 콘택트시트

🎬 쇼츠 모듈 (골격 — 후속)

정본: bong/output/agent_swarm_kling/.../kling3_full_motion_sop.md

• 6씬 구조(훅→위치→스펙→조건→셀링→CTA, ~22초) 또는 카드뉴스 원화 재활용
• source art to motion, text after motion: 원화 → Kling i2v 모션 → ffmpeg 자막 번인
• 최종본 전 컷에 체감 모션 필수. 정지 카드 나열 금지
• 9:16 1080×1920, 30~45초, ffprobe+콘택트시트 검수

📝 블로그 모듈 (골격 — 후속)

• 자료 → 구조화 글(제목·소제목·본문) + 삽화 1~3장
• 화이트리스트 기반, 출처 명시

---

🧲 훅 라이브러리 (첫 3초 카피 설계)

카드뉴스 cover·쇼츠 HOOK 비트·블로그 제목 등 훅 카피를 쓸 때 심리효과 사전을 참조한다:

• 사전: reference/쇼핑쇼츠_후킹멘트_1000.md — 심리효과 10종(손실회피·희소성·사회적증거·호기심갭·권위·밴드왜건·앵커링·후회회피·자기관련성·대조/반전) × 각 100멘트
  • ⚠️ 비공개 자산 (gitignore, repo 미포함) — 없으면 심리효과 10종 원리만으로 설계
• 사용법: 콘텐츠 성격에 맞는 효과 23종 선택 → 해당 파트 멘트를 단어 12개만 바꿔 변형 → 후보 2안(서로 다른 효과)을 제시해 A/B 가능하게
• 채널 강도 필터: 신뢰 기반 채널(강의·B2B)=손실회피·호기심갭·자기관련성 위주로 강도 완화 / 쇼핑·커머스=풀강도 허용
• 금지: 거짓 희소성·과장 권위·확정 표현("100%", "평생 호구"류) — 표시광고법 리스크 + 채널 신뢰 훼손

🛡 가드레일 (constitution.md)

1. 팩트 환각 0 — 자료에 없는 수치·고유명사 창작 금지, 생성 후 전수 대조
2. 비용 게이트 — 1장 테스트 → dry-run → 비용 보고 → 승인 → 배치
3. source art to motion (쇼츠)
4. 사람 컨펌 2지점 (기획 / 발행 직전)
5. 채널 정체성 게이트 — 발행 채널·핸들 일치
6. 도메인 가드레일 — domain.yaml의 guardrails_domain (예: 부동산 안심번호 미사용)

🗂 도메인 추가법

새 자료 유형은 domain.yaml 1개만 정의(fields·select_rules·card_mapping·tone·guardrails). 엔진·틀은 그대로.

📤 발행 (선택)

• 버퍼 CLI (권장 · cron/배치 가능): scripts/buffer_cli.py — 토큰 SSOT(~/.env.central BUFFER_API_KEY) 로드 → Buffer MCP 서버(mcp.buffer.com/mcp) JSON-RPC 직접 호출. 토큰 노출 0.

  source ~/.env.central/load.sh
  python3 scripts/buffer_cli.py channels                          # 채널 ID 확인
  python3 scripts/buffer_cli.py post --channel <id> --text "..." --draft   # 초안(안전 테스트)
  python3 scripts/buffer_cli.py post --channel <id> --text "..." --at 2026-06-16T09:00:00+09:00   # 예약
  python3 scripts/buffer_cli.py post --channel <id> --text "..." --now     # 즉시
  

• 이미지(카드뉴스)는 Supabase Storage 호스팅 후 assets로 첨부. IG 캐러셀/Threads/TikTok.
• MCP(대화형)는 병행 가능하나, 자동 발행은 CLI가 정석(MCP는 cron 불가).