CardWeaver
ScriptForge의 마스터 대본, 책 원고(.md/.hwpx), 교육사업 실적 폴더, GitHub 레포 README 를 받아, Instagram 카드뉴스 8장 시리즈와 Canva Bulk Create CSV를 생성하는 Claude Desktop 플러그인.
자매 레포:
⚠ v0.1 — Instagram 단독 + Canva CSV 수동 업로드: 플러그인이 card_script.json / flowgenie.json / canva-bulk.csv / 로컬 프리뷰 PNG 까지 자동 생성. Canva 업로드는 수동 (Canva Connect API 가 Enterprise 전용이라 MVP는 CSV 생성까지만 자동). 페이스북/링크드인/네이버 브런치는 사양 조사 선행 필요.
파이프라인 위치
StoryLens → ScriptForge ──┬──→ FlowGenie + TTS → SceneWeaver / SceneWeaver-CapCut (영상)
│
└──→ FlowGenie → [CardWeaver] (카드뉴스)
- 상류 (3종 범용):
- 책:
{chapter}_script.md 또는 원고 .md/.hwpx
- 교육과정:
bid-pilot/_context/sector/education/사업케이스/**
- GitHub: 레포 루트
README.md (+ 선택적 docs/, package.json)
- 사이드카: FlowGenie 가 생성한
card_{NN}_{hero|bg}.{png,jpg} (표지·삽화)
- 하류:
workspace/<slug>/instagram/canva-bulk.csv + preview/*.png + caption.txt. Canva 업로드·게시는 사용자가 직접.
설치
/plugin marketplace add leedonwoo2827-ship-it/instagram-cardweaver-canva
/plugin install cardweaver@instagram-cardweaver-canva
설치 후 /card, /card-ingest, /card-script, /card-render 커맨드 활성화. 업데이트: /plugin update cardweaver@instagram-cardweaver-canva.
로컬 개발 중엔 심볼릭 링크(Junction) 로 연결:
# Windows 관리자 PowerShell
New-Item -ItemType Junction `
-Path "$env:USERPROFILE\.claude\plugins\cardweaver" `
-Target "D:\00work\260423-카드뉴스설계사"
사전 준비
- Node.js 20+ — MCP 서버 실행용.
cd mcp-server && npm install 로 의존 설치(Puppeteer 포함).
- FlowGenie Chrome 확장 — 중간 이미지 생성용. 별도 레포 auto-flowgenie 설치 후 Chrome 에 Load unpacked.
- Canva 계정 — 무료 플랜으로 Bulk Create 이용 가능. 이미지는 Canva Uploads 에 사전 업로드 필요(로컬 경로 직수신 불가).
- 한글 폰트 — Noto Sans KR. 시스템 설치 또는 템플릿 @font-face 로 임베드(기본 fallback 로 Malgun Gothic).
- Claude Desktop 0.8+ —
.mcpb 플러그인 지원 버전.
폴더 구조
최초 (ingest 실행 전 — 외부 소스)
상류 3종 중 하나를 타겟으로 지정. 파일 하나, 폴더 하나, 또는 레포 루트.
# 책 소스 예
C:\Users\leedonwoo\Documents\Obsidian Vault\ch01_script.md
# 교육과정 소스 예
C:\Users\leedonwoo\Documents\Obsidian Vault\bid-pilot\_context\sector\education\사업케이스\2025-lms\
├── 01_project_overview.md
├── 02_수행실적.md
└── ...
# GitHub 소스 예
D:\00work\260415-auto-flowgenie\
├── README.md
├── package.json
└── src/
ingest 가 .md / .hwpx / README.md + package.json 조합을 자동 타입 감지.
렌더 완료 후 (/card-render 실행 후)
workspace/<series-slug>/
├── source/ ← ingest된 원본 스냅샷 (읽기 전용)
├── _ingest_report.json ← 소스 타입·감지 근거
├── card_script.json ← ★ 사람이 편집하는 카드 스크립트
├── flowgenie.json ← ★ FlowGenie 입력 JSON
├── images/ ← FlowGenie 결과 (사용자가 배치 후 채움)
│ ├── card_01_hero.png
│ ├── card_04_bg.png
│ └── ...
├── instagram/
│ ├── canva-bulk.csv ← ★ Canva 업로드 파일 (UTF-8 no-BOM, CRLF)
│ ├── caption.txt ← 캡션 + 해시태그
│ └── preview/
│ ├── card_01.png ← 로컬 HTML 프리뷰 (1080×1350)
│ └── ... card_08.png
└── _render_report.json ← 렌더 결과 (카드수·이미지수·경고)
실행 순서 (v0.1 — 인터페이스 기준)
1단계 — 소스 수집
/card-ingest book-ch01 "C:\Users\leedonwoo\Documents\Obsidian Vault\ch01_script.md"
→ workspace/book-ch01/source/ 에 원본 스냅샷 + _ingest_report.json 에 소스 타입(book/curriculum/github) 감지 결과 기록.
2단계 — 카드 스크립트 생성
/card-script book-ch01
→ source-adapter-{book|curriculum|github} 스킬이 타입별로 8장 초안 작성 → workspace/book-ch01/card_script.json. 글자수 초과·이미지 프롬프트 누락 등 편집 포인트 안내.
3단계 — 사람 편집 (에디터에서)
workspace/book-ch01/card_script.json 을 열어서:
cards[i].headline / body / template / image_prompt 미세조정caption / hashtags 보완
→ "편집 끝났어"
4단계 — 렌더
/card-render book-ch01
→ 세 가지 산출 동시 생성:
flowgenie.json — 이미지 필요 카드만 프롬프트 배열instagram/canva-bulk.csv — Canva Bulk Create 용 (UTF-8 no-BOM, CRLF)instagram/preview/card_{NN}.png — 로컬 HTML 프리뷰 (Puppeteer 1080×1350)instagram/caption.txt — 캡션 + 해시태그
5단계 — FlowGenie 이미지 배치 (사용자 수동)
Chrome 에서 FlowGenie 확장 실행 → flowgenie.json 드래그 앤 드롭 → Google Flow 에서 일괄 생성 → 결과 PNG 를 workspace/book-ch01/images/ 에 저장.
6단계 — 재렌더 + Canva 업로드 (사용자 수동)
/card-render book-ch01
→ images/ 에 있는 PNG 를 감지해 CSV 의 image_url 컬럼에 file:/// 경로 자동 주입.
이후 Canva 에서:
- 이미지 파일들을 Canva Uploads 에 먼저 업로드
- Canva Bulk Create 진입 →
canva-bulk.csv 업로드
- 템플릿 선택 → "Connect Data" → 컬럼 매핑 확인 → "Generate"
- 생성된 카드들을 수동 미세조정 후 Instagram 포스트로 게시
wshobson
Lucklyric
xrf9268-hue
anthropics