suno-prompts

1. 개요

suno-prompts는 Suno AI로 곡을 만들 때 쓰는 프롬프트를 모아 두는 개인용 웹앱이다. 곡 하나당 제목·스타일·가사·태그 네 칸을 채워 라이브러리에 쌓고, 필요할 때 네 칸을 한 번에 복사해 Suno에 붙여 넣는다.

이 앱이 곡을 만들지 않고 프롬프트만 다루는 데는 이유가 있다. 만들 당시 Suno에는 공개 API가 없었다. 그래서 앱은 자기가 제일 잘할 수 있는 일 — 프롬프트를 짓고, 모으고, 찾고, 다시 꺼내는 일 — 에 집중하고, 실제 생성은 사람이 웹사이트에서 한다. 나중을 위해 오디오 URL 슬롯만 스키마에 비워 뒀다.

1.1. 4종 세트

칸	무엇인가
제목	Suno에 표시될 곡 이름
스타일	장르·분위기 태그를 쉼표로 나열. Suno의 200자 제한을 앱이 강제한다
가사	[Verse 1] · [Chorus] 같은 섹션 마커를 붙인다. 구조를 알려 주면 Suno가 훨씬 잘 잡는다
태그	Suno로 가지 않는다. 내 라이브러리 안에서 분류·검색하는 용도

2. 핵심 기능

• 곡 라이브러리 — 검색과 태그 필터. 클라이언트에서 퍼지 검색이 돈다.
• 4종 일괄 복사 — 곡 상세의 버튼 하나로 네 칸을 한 번에 클립보드에 담는다. 스타일·가사만 따로 복사하는 버튼도 있다.
• 자연어 → 곡 생성 — 한 줄 묘사와 곡 개수(1~5)를 주면 Gemini가 4종 세트를 완성해 미리보기 카드로 내놓고, 마음에 드는 것만 골라 저장한다. 플레이리스트 메타(이름·설명·테마·커버 이모지)까지 한 번에 짓는 경로도 있다.
• 플레이리스트 — 드래그로 순서를 바꾸면 자동 저장된다. 한 곡이 여러 플레이리스트에 속할 수 있다.
• Suno 사용 매뉴얼 — 앱 안에 매뉴얼 페이지를 두고 섹션마다 마지막 확인 날짜를 붙였다. AI 서비스는 자주 바뀌니 문서에 신선도를 달아 두는 편이 정직하다.
• 대량 업로드 스킬 연동 — 에이전트가 자연어로 곡을 대량 등록하거나 라이브러리 전체를 백업할 수 있다.

Gemini 호출은 응답 스키마를 강제해 JSON으로 받는다. 시스템 지시가 각 칸의 규칙을 못 박아 둔다 — 스타일은 200자 안의 짧은 태그, 가사는 사용자가 쓴 언어를 따라가고 섹션 마커 필수, 태그는 소문자 단일 단어 다섯에서 여덟 개.

3. 기술 스택

영역	기술
웹	Next.js 16 (App Router) + React 19 + TypeScript, Tailwind 4, shadcn/ui
라이브러리	dnd-kit(정렬), Fuse.js(검색), sonner(토스트)
저장	Cloudflare D1 — 로컬 개발은 SQLite로 자동 전환
인증	앱 전체를 감싸는 단일 비밀번호 게이트 + 에이전트용 토큰 헤더
AI	Google Gemini — 응답 스키마 강제 JSON
호스팅	Cloudflare Workers (OpenNext)

4. 개발 배경

AI로 곡을 만들다 보면 금세 알게 된다 — 좋은 결과의 8할은 프롬프트에서 나오고, 잘 나온 프롬프트는 반드시 다시 쓰게 된다. 그런데 그게 어디 있느냐가 문제다. 채팅 기록 어딘가, 메모장 어딘가, 아니면 이미 사라진 뒤.

suno-prompts는 잘 나온 프롬프트에 주소를 준다. 태그를 달아 두면 몇 달 뒤 "그때 그 재즈풍 그거"로 찾을 수 있고, 4종 일괄 복사 버튼 하나로 Suno에 다시 앉힐 수 있다.

5. 링크

• 라이브: suno-prompts.jaceyoung0705.workers.dev — 비밀번호 게이트
• GitHub: architectofthoughts/suno-prompts (비공개)

6. 관련 문서

• youtubewc — 음악을 다루는 다른 앱
• JaceApps 대문