Viraloop은(는) 무엇을 하나요?
모든 웹사이트를 분석하고 TikTok/Instagram용 6슬라이드 캐러셀을 시각적 일관성을 유지하며 생성합니다. 드래프트가 아닌 피드에 바로 게시되며, 자동 트렌딩 음악이 추가됩니다. Gemini와 upload-post.com 두 API 모두 무료 플랜을 제공하므로 신용카드 없이 시작할 수 있습니다.
철학: 매일 반복 루프
성장의 핵심은 일관성 + 학습입니다:
- 하루에 캐러셀 1개 게시 - 꾸준함이 바이럴을 이깁니다
- 모든 것을 추적 - 모든 게시물이 데이터를 생성합니다
- 데이터에서 학습 - 어떤 후크가 효과적인가? 어떤 시간대? 어떤 비주얼?
- 반복하고 개선 - 각 캐러셀은 이전보다 더 나아집니다
1일차: 게시 → 분석 → 학습
2일차: (개선된) 게시 → 분석 → 학습
3일차: (더 나은) 게시 → 분석 → 학습
...
30일차: 30개의 데이터 포인트와 정제된 전략을 보유합니다
이 스킬은 모든 게시물의 인사이트를 축적하는 learnings.json을 유지합니다:
- 가장 효과가 좋았던 후크
- 최적의 게시 시간
- 효과적인 시각 스타일
- 전환율이 높은 CTA
이것은 일회성 도구가 아닙니다. 이것은 성장 엔진입니다.
빠른 시작
# 1. 전체 비즈니스 조사
node {baseDir}/scripts/analyze-web.js https://your-website.com
# 2. 3가지 후크 변형 생성 (SHOCK, CURIOSITY, CONTRADICTION)
GEMINI_API_KEY="your-key" bash {baseDir}/scripts/generate-hooks.sh
# 3. 비전으로 후크 검토 후 최고의 후크 선택
# 4. 선택한 후크 유형으로 슬라이드 생성
GEMINI_API_KEY="your-key" bash {baseDir}/scripts/generate-slides.sh [shock|curiosity|contradiction]
# 5. 슬라이드 검토 (에이전트가 텍스트와 품질 확인)
# 에이전트가 각 슬라이드를 비전으로 확인합니다
# 6. TikTok + Instagram에 게시
UPLOADPOST_TOKEN="your-token" bash {baseDir}/scripts/publish-carousel.sh
# 7. 분석 확인 (24-48시간 후)
UPLOADPOST_TOKEN="your-token" bash {baseDir}/scripts/check-analytics.sh 7
# 8. 데이터를 학습하여 다음 캐러셀에 활용
node {baseDir}/scripts/learn-from-analytics.js
후크 카테고리 (시각적 참신성 시스템)
1000뷰 한계를 돌파하는 핵심은 첫 번째 슬라이드의 시각적 참신성입니다. 우리는 3가지 후크 유형을 생성합니다:
| 유형 | 목표 | 시각 스타일 |
|---|---|---|
| SHOCK | 불가능하거나 터무니없는 것으로 스크롤 멈춤 | 초현실적, 혼란스러운, "잠깐만 뭐?" |
| CURIOSITY | 정보 격차 생성 | 신비로운, 비밀이 드러나는 |
| CONTRADICTION | 불가능한 조합 보여주기 | 편안함 + 강렬함, "어떻게 그게 가능하지?" |
안티-스톡 필터
모든 후크는 다음을 피하기 위해 안티-스톡 프롬프팅을 포함합니다:
- 일반적인 스톡 사진 미학
- 놀란 예쁜 여성 클리셰
- 전형적인 인플루언서 포즈
- 남용되는 노트북-커피 설정
- 기업 악수 장면
후크 테스트 워크플로우
generate-hooks.sh로 3가지 변형 생성- 비전으로 검토하고 각각 참신성을 1~5점으로 평가
- 익숙해 보이는 것은 모두 폐기
- 캐러셀에 가장 좋은 후크 사용
- 시간이 지남에 따라 어떤 후크 유형이 가장 잘 수행되는지 추적
이미지 모델
슬라이드 생성을 위해 gemini-3.1-flash-image-preview를 사용합니다.
- 로컬 스크립트:
{baseDir}/scripts/generate_image.py - 슬라이드 간 시각적 일관성을 위한 이미지-투-이미지 지원
1단계: 전체 조사 (analyze-web.js)
완전한 비즈니스 조사를 수행합니다:
1. 브랜드 분석
- 브랜드 이름 (도메인 또는 제목에서)
- 로고 (URL 또는 SVG)
- CSS 색상 (배경, 기본, 링크, 제목)
- 타이포그래피 (본문 폰트, 제목 폰트)
- 파비콘
2. 콘텐츠 분석
- 헤드라인 및 태그라인
- 모든 제목 (페이지 구조)
- 기능/혜택 (제목 + 설명)
- 가격/플랜
- 사용 후기
- 통계/지표
- CTA
- 메타 태그 (제목, 설명, og:image)
3. 내부 페이지
- 가격, 기능, 소개, 사용후기 페이지 탐색
- 각 페이지에서 추가 콘텐츠 추출
4. 경쟁사 탐지
- 콘텐츠에서 알려진 경쟁사 언급 검색
- 20개 이상의 알려진 SaaS 경쟁사 목록 (Buffer, Hootsuite, Later 등)
- "vs", "alternative", "compare" 섹션 탐지
- 외부 검색 불필요 - 웹사이트 자체에서 모두 추출
5. 스토리텔링
- 비즈니스 유형 탐지 (SaaS, 이커머스, 앱)
- 니치 탐지 (social-media-tools, developer-tools 등)
- 고객 페인 포인트를 기반으로 후크 생성
- 기능에서 페인 포인트 정의
- 변화 내러티브 생성 (이전 → 이후)
6. 시각적 컨텍스트
- CSS 형식의 브랜드 색상
- 프롬프트용 색상 설명
- 슬라이드용 타이포그래피
- 니치 기반 이미지 테마
- 일관성을 위한 스타일 가이드
출력: /tmp/carousel/analysis.json
2단계: 슬라이드 생성 (generate-slides.sh)
이미지-투-이미지를 사용하여 시각적 일관성을 유지하며 6개의 슬라이드를 생성합니다:
| 슬라이드 | 유형 | 내용 |
|---|---|---|
| 1 | HOOK | 스크롤을 멈추게 하는 질문/문제. 모든 시각 스타일을 설정합니다. |
| 2 | Problem | 고통을 자극합니다. "TikTok에 업로드한 다음... Instagram에..." |
| 3 | Agitation | 경쟁사의 발전. 긴박감. |
| 4 | Solution | 가치 제안과 함께 제품을 제시합니다. |
| 5 | Feature | 주요 혜택. |
| 6 | CTA | "프로필 링크 👆" + 행동 촉구. |
시각적 일관성
- 슬라이드 1이 기본 스타일 생성 (색상, 타이포그래피, 분위기)
- 슬라이드 2~6은 슬라이드 1을 참조하여 이미지-투-이미지 사용
- 동일한 색상 팔레트, 폰트 및 미학 유지
슬라이드별 프롬프트
각 슬라이드에는 다음이 포함됩니다:
- 텍스트: 주요 메시지
- Scene: 배경에 대한 상세한 시각적 설명
- Style: 브랜드 분석 기반
출력:
/tmp/carousel/slide-{1-6}.jpg/tmp/carousel/caption.txt
3단계: 비전으로 검토
생성 후 에이전트는 각 슬라이드를 반드시 검토해야 합니다:
- ✓ 텍스트가 읽기 쉽고 정확한가
- ✓ 단어가 잘리지 않았는가
- ✓ 올바른 철자 사용
- ✓ 슬라이드 간 시각적 일관성
- ✓ 허용 가능한 이미지 품질
오류가 있으면 해당 슬라이드를 다시 생성합니다.
이미지 형식
- 해상도: 768x1376 (9:16 세로 비율)
- 형식: JPG (TikTok은 PNG를 지원하지 않음)
- 텍스트: 가독성을 위해 크고 굵게, 그림자 포함
- 배경: 단색이 아닌 비즈니스와 관련된 장면
4단계: TikTok + Instagram에 게시 (publish-carousel.sh)
Upload-Post API를 사용하여 TikTok과 Instagram에 캐러셀을 게시합니다.
UPLOADPOST_TOKEN="your-token" bash {baseDir}/scripts/publish-carousel.sh
엔드포인트: POST /api/upload_photos
전송 매개변수:
platform[]=tiktok+platform[]=instagramauto_add_music=true- TikTok에서 자동으로 음악 추가tiktok_title- 짧은 제목 (최대 90자) + 해시태그title- Instagram용 전체 캡션privacy_level=PUBLIC_TO_EVERYONEmedia_type=IMAGE- Instagram 사진 캐러셀async_upload=true- 백그라운드 처리photos[]- 6개의 슬라이드 JPG
⚠️ 중요 Instagram: 게시 후 사용자는 Instagram에서 수동으로 바이럴 음악을 추가해야 합니다:
- Instagram 열기 → 프로필 → 게시물
- 편집 → 음악 추가
- 트렌딩/바이럴 노래 검색
출력: 추적을 위해 request_id를 post-info.json에 저장합니다.
5단계: 성과 분석 (check-analytics.sh)
TikTok과 Instagram의 분석 데이터를 가져와 어떤 것이 효과적인지 확인합니다.
UPLOADPOST_TOKEN="your-token" bash {baseDir}/scripts/check-analytics.sh 7
사용되는 엔드포인트:
-
프로필 분석:
GET /api/analytics/{user}?platforms=tiktok→ 팔로워, 좋아요, 댓글, 공유, 노출수
-
총 노출수:
GET /api/uploadposts/total-impressions/{user}?platform=tiktok&breakdown=true→ 일별 총 조회수
-
게시물별 분석:
GET /api/uploadposts/post-analytics/{request_id}→ 특정 캐러셀의 조회수, 좋아요, 댓글 (TikTok + Instagram)
문서: https://docs.upload-post.com/api/get-analytics
6단계: 학습 및 개선 (learn-from-analytics.js)
데이터를 분석하고 향후 캐러셀을 위한 학습 내용을 저장합니다.
node {baseDir}/scripts/learn-from-analytics.js
생성:
learnings.json- 축적된 지식 베이스- 가장 많은 조회수를 생성한 최고의 후크
- 최적의 게시 시간
- 다음 캐러셀을 위한 권장 사항
전체 흐름
# 1. 비즈니스 조사
node {baseDir}/scripts/analyze-web.js https://my-product.com
# 2. 슬라이드 생성
GEMINI_API_KEY="..." bash {baseDir}/scripts/generate-slides.sh
# 3. 비전으로 검토 (에이전트가 텍스트 확인)
# 에이전트가 각 슬라이드 이미지를 확인
# 4. 게시
UPLOADPOST_TOKEN="..." UPLOADPOST_USER="myuser" bash {baseDir}/scripts/publish-carousel.sh
# 5. (몇 시간/일 후) 분석
UPLOADPOST_TOKEN="..." UPLOADPOST_USER="myuser" bash {baseDir}/scripts/check-analytics.sh 7
# 6. 다음 캐러셀을 위한 학습
node {baseDir}/scripts/learn-from-analytics.js
파일
{baseDir}/
├── SKILL.md # 이 문서
└── scripts/
├── analyze-web.js # 전체 비즈니스 조사
├── generate-slides.sh # 일관된 6개 슬라이드 생성
├── generate_image.py # Gemini 3.1 flash 이미지
├── review-slides.js # 검토용 슬라이드 준비
├── publish-carousel.sh # Upload-Post API를 통한 게시
├── check-analytics.sh # 분석 데이터 가져오기 (TikTok + Instagram)
├── learn-from-analytics.js # 데이터에서 학습
└── search-competitors.js # 선택적 외부 검색
환경 변수
| 변수 | 설명 |
|---|---|
GEMINI_API_KEY | 이미지 생성을 위한 Google API 키 |
UPLOADPOST_TOKEN | 게시 및 분석을 위한 Upload-Post 토큰 |
UPLOADPOST_USER | Upload-Post 사용자 이름 (필수) |
니치별 후크 예시
| 니치 | 후크 예시 |
|---|---|
| 소셜 미디어 도구 | "아직도 하나씩 소셜 미디어에 게시하고 있어? 😩" |
| SaaS 일반 | "아직도 수동으로 하고 있어?" |
| 이커머스 | "TikTok이 계속 추천하는 제품" |
| 앱 | "더 일찍 발견했으면 좋았을 앱" |
| 개발자 도구 | "당신의 코드를 바꿀 API" |
왜 Viraloop인가?
| Viraloop | 다른 스킬 | |
|---|---|---|
| 게시 | 피드에 직접 | 드래프트만 |
| 음악 | 자동 트렌딩 음악 | 수동 |
| 플랫폼 | TikTok + Instagram | 단일 플랫폼 |
| 조사 | 자동 URL 분석 | 수동 설명 |
| 이미지 일관성 | 이미지-투-이미지 참조 | 독립적인 슬라이드 |
| 이미지 생성 | Gemini (무료 티어) | 유료 제공업체 |
| 게시 | upload-post.com (무료, 신용카드 불필요) | 유료 또는 자체 호스팅 |
| 텍스트 오버레이 | AI 네이티브 (Gemini 렌더링) | 외부 스크립트 |
| 프롬프트 | 구조화된 템플릿 | 자유 형식 |
| 설정 | 환경 변수 3개 | 복잡한 다중 도구 설정 |
참고 사항
- 분석은 웹사이트 콘텐츠 자체에서 경쟁사를 추출합니다 (20개 이상의 알려진 SaaS)
- 이미지-투-이미지는 일관성을 유지하지만 슬라이드당 약 20초 소요
- 생성된 캡션에는 니치 관련 해시태그가 포함됩니다
- 항상 슬라이드 텍스트를 검토하세요 - 때로는 잘릴 수 있습니다
- TikTok의
auto_add_music은 참여도를 높입니다 - 의미 있는 데이터를 위해 24-48시간 후에 분석을 확인하세요
- 학습 내용은 게시된 각 캐러셀마다 축적되어 개선됩니다
- TikTok 제목은 최대 90자입니다 (해시태그와 함께 자동으로 잘림)