Communitygithub.com

video-mo-hop-san-pham

제품 언박싱/리뷰 영상을 TikTok Shop/Shopee Video/Reels 세로형 판매 영상으로 자동 변환합니다. 가장 좋은 장면을 선택하고, 빠른 템포, AI 베트남어 음성, 가라오케 스타일 자막, 큰 가격 텍스트, 장바구니 클릭 유도, 브랜드 아웃트로 카드를 추가합니다.

video-mo-hop-san-pham란 무엇인가요?

이 스킬은 사용자가 촬영한 제품 언박싱, 클로즈업, 사용 시연 영상(음성 유무 무관)을 TikTok Shop, Shopee Video, Instagram Reels 등에 바로 게시 가능한 세로형 판매 영상으로 변환합니다. 사용자로부터 제품명, 가격, 강점, 타겟 고객, 클릭 유도 문구를 입력받아 분석 스크립트로 영상의 최적 장면(5~9개, 각 1.5~3초)을 자동 선별하고, 4단계(갈고리-소개-혜택-마무리)로 구성된 자연스러운 AI 음성 내레이션(베트남어)을 생성합니다. 또한, 영상에 가격, 할인율, 혜택 등의 텍스트 오버레이를 추가하고, 마지막 3초에 클릭 유도 문구를 표시합니다. 가로 영상은 자동으로 흐린 배경 위에 배치되며, 사용자 브랜드 프로필(로고, 색상, 음악)을 활용할 수 있습니다. 이 스킬은 Agent Boss 프레임워크 기반으로 macOS, Windows, Linux에서 실행 가능하며, 필수 패키지(ffmpeg, Python)와 선택적 패키지(faster-whisper, edge-tts)를 자동 확인 및 설치합니다. 또한, 페이스북, 인스타그램, 틱톡 등에서 제품 판매 영상을 제작하는 모든 사용자에게 유용합니다.

지원 대상✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/AgentBossVn/agent-boss-skills/tree/HEAD/video-mo-hop-san-pham

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

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

문서

언박싱 / 제품 영상

적합: 제품 촬영, 언박싱, 사용 시연, 매장 제품 촬영 클립. 사람이 말하지 않아도 됩니다. — 스킬이 자동으로 대본을 작성하고 AI 음성으로 읽어줍니다. 부적합: 긴 대화 영상 (video-phu-de-to 사용).

포맷 (15~30초, 판매용)

  1. 사용자에게 묻기 (한 번의 메시지로, 아직 묻지 않은 경우): 제품명, 가격(할인 중이라면 원래 가격도), 2~3가지 주요 장점, 구매 대상, 클릭 유도 문구 (장바구니 / 인박스 / 바이오 링크).
  2. 장면 선택: 분석 그리드 이미지를 보고 59개 구간(각 1.53초) 선택: 가장 좋은 장면을 처음에 배치하고, 이후 세부 사항, 사용 시연, 결과 순서. 흐릿하거나 흔들리거나 손이 가린 장면은 제외. 본문 영상 길이는 음성 길이에 맞춥니다.
  3. 음성 (giong_doc) 템플릿 4단계:
    • 갈고리 (0~3초): 고통점 자극 또는 호기심 유발. "집이 좁아도 에어프라이어를 쓰고 싶나요?"
    • 소개: 제품이 무엇인지, 한 문장.
    • 2~3가지 구체적 혜택: 가능하면 수치 포함 ("5리터", "단 15분").
    • 마무리: 가격 + 클릭 유도. "가격은 890,000동, 왼쪽 아래 장바구니를 클릭하세요."
    • 1525초 기준 5090자. 자연스러운 구어체, 건조한 사양 나열 금지.
  4. 화면 텍스트: mo_dau 0~2.8초 (7자 이하); gia 음성이 가격을 언급할 때 (예: "890K"); cta 본문 마지막 3초 ("장바구니 클릭 🛒" — 폰트가 지원하지 않으면 이모지 사용 금지).
  5. 가로 영상 입력: 자동으로 흐린 배경 위에 배치, 제품이 잘리지 않도록 함.
  6. 원본 오디오: 음소거 (AI 음성으로 대체). 원본 오디오에 가치가 있는 경우 (지글거리는 소리, 언박싱 소리) 첫 번째 버전에서는 음소거하고 사용자에게 추후 문의.
  7. edge-tts 미지원 / 네트워크 없음: giong_doc 생략, 화면 텍스트 + 배경 음악만 사용 (각 혜택에 nhan 텍스트 추가).

이 스킬의 텍스트 스타일

유형용도위치
mo_dau처음 3초 갈고리 문장상단, 흰색 굵은 테두리, 약간 기울임
gia가격, 할인율중앙, 강조 색상 배경, 매우 큰 글씨
nhan짧은 혜택 ("5리터", "들러붙지 않음")상단, 기본 색상 배경
cta마지막 클릭 유도하단 중앙, 강조 색상 배경

일반 작업 흐름 (모든 영상 유형)

모든 명령은 이 스킬의 디렉토리(SKILL.md 파일이 있는 디렉토리)에서 실행합니다. <SKILL>은 해당 디렉토리 경로를 의미합니다.

단계 0. 확인 (매 사용 시)

Python 명령: macOS는 python3 사용, Windows는 py -3 사용 (python만 사용 금지: Windows의 기본 python은 Microsoft Store 버전으로 문제 발생 가능). 경로는 / 사용, Git Bash 및 PowerShell 모두에서 실행 가능. 아래는 python3로 작성했지만 Windows에서는 py -3로 대체.

python3 <SKILL>/scripts/kiem_tra.py
  • thieu_bat_buoc가 비어 있지 않으면 → 사용자에게 설치할 목록을 보여주고 한 번 "이 항목들을 설치하시겠습니까?"라고 묻고 동의한 후에만 실행. Windows에 Python이 없는 경우: winget install -e --id Python.Python.3.12 --scope user. ffmpeg 설치 후 Windows에서는 명령 창을 다시 열거나(또는 Agent를 재시작) ffmpeg 명령을 인식하도록 해야 함.
  • thieu_tuy_chon → 필요할 때만 설치: faster-whisper (음성 자막용, 첫 실행 시 ~800MB 모델 다운로드), edge-tts (AI 음성용).
  • cap_nhat.co_ban_moi가 true이면 → 한 문장으로 "이 스킬의 새 버전 {moi_nhat}이 있습니다. 업데이트하시겠습니까?"라고 알림. 사용자가 동의하면 cau_cap_nhat에 기록된 대로 정확히 수행. 자동 업데이트 금지. cap_nhat이 null이면 건너뛰고 정상 진행.
  • cap_nhat.skill_khac_chua_cai에 이름이 있으면 → 답변 마지막에 한 줄로 "Agent Boss 저장소에는 다음도 있습니다: …"라고 알림. 세션당 한 번만 알림.
  • 폰트: 자모 오류나 보기 나쁜 경우 python3 <SKILL>/scripts/kiem_tra.py --cai-font 실행 (Google Fonts에서 Be Vietnam Pro 다운로드).

단계 1. 브랜드 프로필 (첫 번째 사용 시에만)

~/.agent-boss/thuong-hieu.json 읽기 (모든 Agent Boss 스킬과 공유). 파일이 없으면 사용자에게 한 메시지로 간결하게 물음: 상점/채널 이름, 영상 마지막 클릭 유도 문구, 기본 색상, 강조 색상, 로고 경로(있는 경우), 사용 권한이 있는 배경 음악 파일(있는 경우). 건너뛴 항목은 기본값 사용. 파일 작성:

{"ten": "Tiệm Nhà Mây", "cau_ket": "Bấm giỏ hàng để đặt ngay", "mau_chinh": "#1B1B1B", "mau_nhan": "#FFD21F",
 "mau_chu": "#FFFFFF", "logo": "~/Pictures/logo.png", "font": null, "nhac": "~/Music/nen.mp3"}

이 파일은 스킬 디렉토리 외부에 있으므로 스킬 업데이트 시에도 유지됩니다.

단계 2. 입력 영상 분석

python3 <SKILL>/scripts/phan_tich.py <video 또는 video 디렉토리> --ra <작업-디렉토리>

작업 디렉토리: 사용자 영상 옆에 video-<날짜>-<짧은이름>/ 생성. 각 영상에 대해 phan-tich/<이름>.json 읽기 (길이, 세로/가로, 무음 구간, 장면 전환, 단어별 음성) 및 이미지 보기 phan-tich/<이름>.jpg (초 단위 타임라인 그리드)를 열어 최적 구간 선택. 음성이 없는 영상은 --khong-nghe 추가하여 빠르게 처리.

단계 3. ke-hoach.json 계획 작성 (작업 디렉토리 내)

{
  "dau_ra": "thanh-pham/video.mp4",
  "doan": [{"file": "../clip1.mp4", "tu": 2.0, "den": 9.5}],
  "chu": [{"tu": 0, "den": 2.6, "noi_dung": "ĐỪNG MUA NỒI CHIÊN NẾU CHƯA XEM", "kieu": "mo_dau"}],
  "giong_doc": null,
  "nhac": null,
  "sua_chu": {"cờ lốt": "Claude"},
  "tu_khoa": ["giảm giá", "miễn phí"],
  "the_ket": true
}
  • doan: 원본 영상의 초 단위 구간, 나타날 순서대로. 경로는 ke-hoach.json 파일이 있는 디렉토리 기준.
  • chu: 새 영상의 초 단위. "den": "het"는 본문 끝까지. kieu는 이 스킬의 텍스트 스타일 표 참조.
  • giong_doc: {"van_ban": "...", "giong": "vi-VN-HoaiMyNeural"} (여성) 또는 vi-VN-NamMinhNeural (남성). 대화체로 짧은 문장으로 음성 대본 작성. 초당 약 3.5자.
  • nhac: 비워두면 브랜드 프로필의 음악 사용; 없으면 배경 음악 없음. 사용자에게 사용 권한이 있는 음악만 사용. 영상에 이미 음악이 있으면 "nhac": null로 설정.
  • sua_chu: 음성 인식이 잘못된 단어(고유명사, 제품명, 영어 단어) 수정. 분석의 van_ban을 주의 깊게 읽어 오류 찾기.

새 영상에서 각 자막 구간의 정확한 시간을 알고 싶다면(텍스트를 음성에 맞추기 위해): python3 <SKILL>/scripts/dung.py ke-hoach.json --chi-thoi-gian.

단계 4. 렌더링

python3 <SKILL>/scripts/dung.py <작업-디렉토리>/ke-hoach.json

thanh-pham/video.mp4 (1080×1920, 30fps, −14 LUFS 오디오) 및 thanh-pham/video-bia.jpg 생성.

단계 5. 자체 검토 후 전달

  1. ffmpeg로 3개의 프레임(처음, 중간, 끝) 추출하여 확인: 텍스트가 가장자리에서 넘치거나, 얼굴을 가리거나, 자모 오류가 없는지 확인. 오류가 있으면 계획 수정 후 재렌더링.
  2. thanh-pham/chu-thich.txt 작성: 호기심을 유발하는 첫 문장 1개 + 본문 23줄 + 클릭 유도 + 주제와 밀접한 베트남어 해시태그 46개 (일반 해시태그 남용 금지).
  3. 사용자에게 알림: 영상 경로, 썸네일, 설명. 수정할 부분이 있는지 문의 (첫 문장 변경, 더 짧게, 음악 변경 등).

공통 규칙

  • 세로 영상 9:16. 텍스트는 TikTok 안전 영역 내 위치: 오른쪽 가장자리(버튼 열)와 너무 가깝지 않아야 하며, 높이 80% 지점보다 낮지 않아야 함 (채널명, 설명 영역).
  • 처음 3초가 시청자 이탈 여부를 결정합니다. 항상 명확한 갈고리 문장 포함.
  • 허위 약속 금지, "100% 보장", "완치", "최고"와 같은 표현 금지 (화장품, 건강기능식품, 의약품의 경우 TikTok에서 제재 또는 광고 거부 가능).
  • 사용자에게 사용 권한이 없는 음악, 이미지, 로고 사용 금지.

Individual skills in this repo

This repo contains 3 individual skills — each has its own dedicated page.

관련 스킬