Communitygithub.com

Viraloop

TikTok 및 Instagram 자동 캐러셀 성장을 위한 OpenClaw AI 에이전트 스킬입니다. 웹사이트 URL을 분석하여 브랜드, 경쟁사, 가치 제안을 추출한 후, upload-post API를 통해 바이럴 슬라이드를 생성하고 자동 게시하며 트렌딩 음악을 추가합니다. 내장된 분석 피드백 루프로 지속적인 개선이 가능합니다.

Viraloop란 무엇인가요?

Viraloop은 OpenClaw AI 에이전트 스킬로, 어떤 웹사이트 URL이든 분석하여 TikTok과 Instagram에 최적화된 6장짜리 캐러셀을 자동 생성하고 즉시 게시합니다. 브랜드 색상, 로고, 타이포그래피, 경쟁사 정보를 추출하고, 3가지 후크 유형(충격, 호기심, 모순)을 생성하여 시각적 참신성을 극대화합니다. Gemini의 무료 이미지 생성 API와 upload-post.com의 무료 게시 API를 활용하므로 별도의 신용카드 없이 시작할 수 있습니다. 게시 후에는 TikTok과 Instagram의 분석 데이터를 수집하여 `learnings.json`에 축적하고, 이를 바탕으로 후크, 게시 시간, 시각 스타일을 지속적으로 개선하는 반복 학습 루프를 제공합니다.

지원 대상✓Claude Code~Codex CLI~Cursor✓Gemini CLI
npx skills add Upload-Post/viraloop

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

Viraloop은(는) 무엇을 하나요?

모든 웹사이트를 분석하고 TikTok/Instagram용 6슬라이드 캐러셀을 시각적 일관성을 유지하며 생성합니다. 드래프트가 아닌 피드에 바로 게시되며, 자동 트렌딩 음악이 추가됩니다. Gemini와 upload-post.com 두 API 모두 무료 플랜을 제공하므로 신용카드 없이 시작할 수 있습니다.

철학: 매일 반복 루프

성장의 핵심은 일관성 + 학습입니다:

  1. 하루에 캐러셀 1개 게시 - 꾸준함이 바이럴을 이깁니다
  2. 모든 것을 추적 - 모든 게시물이 데이터를 생성합니다
  3. 데이터에서 학습 - 어떤 후크가 효과적인가? 어떤 시간대? 어떤 비주얼?
  4. 반복하고 개선 - 각 캐러셀은 이전보다 더 나아집니다
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불가능한 조합 보여주기편안함 + 강렬함, "어떻게 그게 가능하지?"

안티-스톡 필터

모든 후크는 다음을 피하기 위해 안티-스톡 프롬프팅을 포함합니다:

  • 일반적인 스톡 사진 미학
  • 놀란 예쁜 여성 클리셰
  • 전형적인 인플루언서 포즈
  • 남용되는 노트북-커피 설정
  • 기업 악수 장면

후크 테스트 워크플로우

  1. generate-hooks.sh로 3가지 변형 생성
  2. 비전으로 검토하고 각각 참신성을 1~5점으로 평가
  3. 익숙해 보이는 것은 모두 폐기
  4. 캐러셀에 가장 좋은 후크 사용
  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개의 슬라이드를 생성합니다:

슬라이드유형내용
1HOOK스크롤을 멈추게 하는 질문/문제. 모든 시각 스타일을 설정합니다.
2Problem고통을 자극합니다. "TikTok에 업로드한 다음... Instagram에..."
3Agitation경쟁사의 발전. 긴박감.
4Solution가치 제안과 함께 제품을 제시합니다.
5Feature주요 혜택.
6CTA"프로필 링크 👆" + 행동 촉구.

시각적 일관성

  • 슬라이드 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[]=instagram
  • auto_add_music=true - TikTok에서 자동으로 음악 추가
  • tiktok_title - 짧은 제목 (최대 90자) + 해시태그
  • title - Instagram용 전체 캡션
  • privacy_level=PUBLIC_TO_EVERYONE
  • media_type=IMAGE - Instagram 사진 캐러셀
  • async_upload=true - 백그라운드 처리
  • photos[] - 6개의 슬라이드 JPG

⚠️ 중요 Instagram: 게시 후 사용자는 Instagram에서 수동으로 바이럴 음악을 추가해야 합니다:

  1. Instagram 열기 → 프로필 → 게시물
  2. 편집 → 음악 추가
  3. 트렌딩/바이럴 노래 검색

출력: 추적을 위해 request_id를 post-info.json에 저장합니다.

5단계: 성과 분석 (check-analytics.sh)

TikTok과 Instagram의 분석 데이터를 가져와 어떤 것이 효과적인지 확인합니다.

UPLOADPOST_TOKEN="your-token" bash {baseDir}/scripts/check-analytics.sh 7

사용되는 엔드포인트:

  1. 프로필 분석:

    GET /api/analytics/{user}?platforms=tiktok
    

    → 팔로워, 좋아요, 댓글, 공유, 노출수

  2. 총 노출수:

    GET /api/uploadposts/total-impressions/{user}?platform=tiktok&breakdown=true
    

    → 일별 총 조회수

  3. 게시물별 분석:

    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_USERUpload-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자입니다 (해시태그와 함께 자동으로 잘림)

관련 스킬