Communitygithub.com

Raibit-AI/social-ad-builder

클립과 간단한 JSON 샷 목록을 사용하여 완성된 세로형 소셜 비디오 광고를 제작합니다. 브랜드 색상의 요리 라벨, 프레임 0의 브랜드명, 하드 컷, 매칭된 컬러 그레이딩, 깔끔한 사운드 디자인, 안전한 음량 및 엔드 카드가 포함된 9:16 마스터(Reels, Stories, TikTok)와 4:5 피드 컷을 출력합니다. 무료 ffmpeg만 사용합니다. 사용자가 음식이나 제품 클립으로 짧은 광고, Reel 또는 TikTok을 편집, 자르기, 조립 또는 렌더링하거나 A/B 테스트용 여러 광고 변형을 만들고자 할 때 사용하세요.

social-ad-builder란 무엇인가요?

이 기술은 JSON 기반의 샷 리스트를 받아 바로 사용 가능한 소셜 미디어 광고 비디오를 생성합니다. 사용자는 각 클립의 시작 시간, 지속 시간, 라벨 등을 정의한 JSON 파일을 준비하고 `python3 scripts/build_ad.py shotlist.json` 명령어를 실행하기만 하면 됩니다. 이 기술은 무료 오픈소스 도구인 ffmpeg와 ffprobe만을 사용하며, 반복적인 A/B 테스트를 통해 검증된 기본 설정값을 제공합니다. 주요 기능으로는 하드 컷, 브랜드 컬러 기반의 고체 배경 요리 라벨, 프레임 0의 브랜드명 표시, 각 푸드 샷의 4% 확대 효과, 라이트 샤프닝과 웜 컬러 그레이딩, 클립 오디오 대신 별도로 제공되는 앰비언스 사운드와 시즐 효과, -14 LUFS의 안전한 음량 및 리미터, 4:5 안전 영역 내 텍스트 배치 등이 포함됩니다. 또한, 엔드 카드, 다양한 샷 필드(keep_label, subline, label_size 등), 자동 텍스트 크기 조절, A/B 테스트를 위한 변형 제작 기능 등을 지원하여 전문적인 광고 제작자와 마케터에게 유용합니다. 주요 지원 플랫폼은 Instagram Reels, Stories, TikTok이며, 9:16과 4:5 두 가지 해상도로 출력됩니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Raibit-AI/food-ad-kit/tree/HEAD/plugins/food-ad-kit/skills/social-ad-builder

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

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

문서

소셜 광고 빌더

scripts/build_ad.py는 샷 리스트를 두 개의 완성된 파일로 변환합니다. ffmpeg와 ffprobe(무료)만 있으면 됩니다. 모든 기본값은 점수 기반 반복 루프와 블라인드 A/B 리뷰를 통해 검증되었습니다:

  • 하드 컷. 모든 컷에서 페이드가 검은색으로 깜박입니다.
  • 브랜드 컬러의 단색 배경 위 요리 라벨. 복잡한 음식 위의 얇은 텍스트는 읽을 수 없습니다.
  • 프레임 0의 브랜드명. 대부분의 사람들은 음소거 상태로 시청합니다.
  • 각 음식 샷이 시작될 때 4% 확대 효과.
  • 라이트 샤프닝과 하나의 웜 컬러 그레이딩. AI 클립과 휴대폰 영상이 같은 카메라로 촬영된 것처럼 보이게 합니다.
  • 클립에서 오디오를 가져오지 않음. AI 비디오 모델이 자체 음악을 추가하기 때문입니다. 사운드는 제공하는 경우 실제 공간 앰비언스이며, 음식 아래 부드러운 시즐 효과가 더해집니다.
  • 리미터가 적용된 -14 LUFS 음량. 실제 피크가 0dB 미만으로 유지되어 휴대폰 스피커에서 왜곡이 발생하지 않습니다.
  • 4:5 안전 영역 내 텍스트 배치(1920 기준 y 약 390). 하나의 마스터가 피드용으로 깔끔하게 잘립니다.

샷 리스트

{
 "out": "out/my-ad",
 "brand_color": "#A3192B",
 "brand_line": "Your Restaurant · Your Town",
 "ambience": "room-recording.mov",
 "shots": [
  {"file": "clips/noodle-lift.mp4", "start": 3.0, "dur": 2.0, "label": "Dan Dan Noodles"},
  {"file": "clips/mapo.mp4", "start": 0.8, "dur": 1.5, "label": "Mapo Tofu"},
  {"file": "clips/mapo-scoop.mp4", "start": 3.3, "dur": 1.5},
  {"file": "clips/dining-room.mp4", "start": 0, "dur": 1.0, "label": "Your Restaurant", "subline": "Your Town", "food": false}
 ],
 "endcard": {"bg": "#F3ECE0", "logo": "logo.png", "dur": 2.0,
  "lines": [{"text": "Your Town", "size": 58, "color": "#8B1E1E"},
            {"text": "Order pickup or reserve a table", "size": 56},
            {"text": "yoursite.com", "size": 84, "color": "#8B1E1E", "bold": true}]}
}

python3 scripts/build_ad.py shotlist.json을 실행합니다. out/my-ad-9x16.mp4와 out/my-ad-4x5.mp4 파일을 생성합니다.

샷 필드:

  • start와 dur는 클립 내에서 초 단위입니다.
  • "food": false는 확대 효과와 시즐 효과를 끕니다(룸 샷용).
  • "keep_label": true는 레이블을 다시 애니메이션하지 않고 두 샷에 걸쳐 유지합니다.
  • "subline"은 레이블 아래에 더 작은 줄을 추가합니다.
  • "label_size"는 레이블 크기를 설정합니다(기본값 78px). 레이블에 \n을 넣으면 두 줄로 표시됩니다. 레이블과 엔드 카드 줄은 프레임 너비에 맞게 자동으로 축소됩니다.
  • 텍스트에는 따옴표, 콜론, 쉼표 및 %를 포함할 수 있습니다. 이모지는 레이블 폰트에서 렌더링되지 않으므로 사용하지 마십시오.
  • 클립이 요청된 dur보다 짧은 경우, 빌더는 있는 부분을 사용하고 메모를 출력합니다. 해당 메모를 확인하세요: 일찍 끝나는 후크는 마지막 프레임에서 멈춥니다.

우승 광고의 페이싱 규칙 (광고 분해 벤치마크 참조)

  • 길이: 말없는 음식 몽타주는 12-20초에서 가장 효과적입니다. 대화나 스토리 광고는 더 길게 실행됩니다.
  • 샷 길이: 약 1.8초마다 컷, 첫 번째 컷은 약 2초까지. 0.5초 단위의 샷 길이는 모든 120BPM 음악 트랙이 컷에 맞춰지도록 합니다.
  • 순서: 손이 프레임 안에 있는 동작으로 시작합니다. 음식을 중단 없이 연속으로 보여줍니다. 빈 룸 샷은 약 1초로, 끝 부분 근처에 둡니다.
  • 종료: 가장 좋은 음식 샷, 또는 간단한 행동 단어가 있는 카드.
  • 음악: 업로드 시 플랫폼 자체 라이선스 라이브러리에서 추가하세요. 권한이 없는 노래를 인코딩하지 마십시오.

A/B 변형 만들기

변형당 하나만 변경하십시오(후크 샷, 후크 라인, 길이 또는 요리 세트). 승자가 스스로 설명할 수 있습니다. 샷 리스트를 복사하고, 하나의 필드를 편집한 후 다시 빌드하십시오.

Individual skills in this repo

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

Raibit-AI/ad-teardown

Breaks a video ad down the way a creative director would. It measures length, cut speed and first cut; pulls frame strips of the first 3 seconds and of the whole ad; transcribes the speech; tags the hook, format, people, text, offer and ending; and scores it against benchmarks from winning food ads. Use when the user asks to analyze, break down, tear down, critique or compare a video ad, Reel or TikTok, especially for a restaurant or food brand.

Raibit-AI/blind-ad-review

Improves a video ad through repeated blind A/B reviews. Two versions are shown as contact sheets to a fresh reviewer who doesn't know which is newer, and both are scored against benchmarks from winning food ads. The next version changes only what reviewers agree on, and the loop continues until the gains stop. Use when the user wants to improve, iterate, critique or A/B test an ad or Reel before spending money, or asks "which version is better".

Raibit-AI/food-shot-director

Directs AI image-to-video food shots for restaurant ads (chopsticks lifting noodles, a spoon scooping, sauce poured, a piece lifted to the lens). It gives the prompt formula, which foods animate well and which morph, and a keep-or-reject checklist so the dish still looks like the real menu item. Works with any image-to-video model (Kling, Veo, Seedance, LTX, Runway). Use when the user wants to animate a food photo, make food B-roll or a hand-in-frame food shot, or turn menu photos into video...

Raibit-AI/winning-ad-finder

Finds video ads that are probably working for restaurants and food brands, using the free Meta Ad Library, and builds a short "swipe file" of likely winners to study. Use when the user asks to find winning ads, research competitors' Facebook or Instagram ads, see what ads restaurants are running, or build ad inspiration for a food business.

관련 스킬