# 아이템 찾기·보관함·원본 영상 가져오기

> 기준일: 2026-09-19
> 대상: 상품 아이디어와 원본을 찾는 회원, AI 상담 답변 작성자, selvi.web 도움말 담당자
> 검증 범위: 현재 화면 문구·소스 제한·가져오기 구현을 확인했다. 외부 플랫폼의 현재 검색·다운로드 성공을 보증하거나 실기 검증한 문서는 아니다.

## KB-SOURCE-001 · 참고 영상과 제작 원본은 다릅니다

**아이템 찾기**는 어떤 상품이나 표현을 참고할지 결정하는 공간이다. **보관함 → 참고 영상**은 링크와 메타데이터를 저장한다. **영상 준비**에 담은 원본 파일은 실제 대본 분석과 렌더링에 사용하는 재료다.

아이템 찾기에서 **보관**을 눌렀다고 영상 파일이 다운로드되거나 프로젝트 원본이 되는 것은 아니다. 제작하려면 사용할 권한이 있는 원본을 별도로 준비하여 **내 영상 파일** 또는 **소스 가져오기**로 프로젝트에 담는다.

## KB-SOURCE-002 · 인스타 릴스에서 아이템 찾기

**목적:** 수집·게시된 릴스의 반응을 비교하고 상품 아이디어와 표현을 찾는다.

1. 왼쪽 **아이템 찾기**를 누른다. 기본 탭은 **인스타 릴스**다.
2. **분야**, **기간**, **정렬**을 고른다.
3. 필요하면 **작은 채널 흥행작만 보기**를 켜고 팔로워 기준을 고른다.
4. 영상 카드의 표지 또는 **영상 보기**로 실제 게시물을 확인한다.
5. **제품 분석**으로 상품 후보와 검색어 분석을 진행하거나 **보관**하여 참고 영상에 남긴다.
6. 공개 댓글이 포함된 카드에서는 **성과·댓글 보기**를 연다.

이 목록은 selvi.kr에 게시된 수집본을 읽는다. 사용자가 Instagram API 키를 등록할 필요는 없다. **새로고침**은 게시본을 다시 받는 동작이며, 버튼을 누를 때마다 Instagram 전체를 새로 수집하는 기능이 아니다. 서버 수집 주기가 있어도 실제 최근 수집 시각과 게시 시각은 화면의 기준일을 확인해야 한다.

기간·분야·흥행 필터는 현재 게시본 안에서 적용된다. 결과가 적으면 전체 플랫폼에 해당 영상이 없다는 뜻이 아니다. 수치 비공개·미제공은 0회와 다르다. 새로고침에 실패하면 이전 결과와 실패 안내가 함께 남을 수 있으므로 오래된 수치를 실시간 값처럼 말하지 않는다.

**작은 채널 흥행작** 기준은 팔로워 1천 명 이하 또는 1만 명 이하이면서 조회수 10만 회 이상이다. 팔로워·조회수가 모두 제공된 릴스만 판정한다.

## KB-SOURCE-003 · 유튜브 쇼츠 검색

**선행조건:** **설정 → API 키 → YouTube**에 데이터 조회 키를 저장한다.

1. **아이템 찾기 → 유튜브 쇼츠**를 연다.
2. **분야**, **기간**, **정렬**을 선택한다.
3. 필요하면 **검색어**에 상품명·주제를 입력한다. 검색어를 비워도 분야로 찾을 수 있다.
4. **찾기** 또는 **새로고침**을 누른다.
5. 결과의 **제품 분석**, **보관**, **성과·댓글 보기**, **영상 보기** 중 필요한 동작을 선택한다.
6. 다음 결과가 제공되면 **이전/다음**으로 페이지를 이동한다.

검색은 읽기 전용이다. 제목·썸네일·조회수·좋아요·댓글·구독자 수 등의 메타데이터를 표시하며 YouTube 영상 파일을 내려받지 않는다. **분야**는 YouTube 공식 카테고리 자체가 아니라 쇼핑용 검색어 묶음을 더하는 방식이다.

**작은 채널 흥행작만 보기**는 현재 조회 결과에서 구독자 1천 명 이하 또는 1만 명 이하, 조회수 10만 회 이상인 영상을 고른다. 비공개 구독자 수를 추정해서 채우지 않는다. 조건을 바꾸어도 전체 YouTube를 모두 조사한 결과가 되는 것은 아니다.

## KB-SOURCE-004 · 성과 수치는 어떻게 읽나요?

- **성과순:** 조회수 ÷ max(구독자 수 또는 팔로워 수, 1,000). 채널 규모를 고려한 비교값이다. 절대 조회수 순위나 예상 수익이 아니다.
- **참여율:** (좋아요 + 댓글) ÷ 조회수. 필요한 값이 없는 Instagram 항목은 미제공으로 표시한다.
- **조회수 급상승:** 이전에 확인한 값보다 조회수가 30% 이상 증가한 항목이다. 비교할 이전 값이 없는 첫 조회에는 표시하지 않는다.
- **YouTube 오늘의 신규:** 이번 앱 실행에서 처음 조회된 항목이다. 오늘 업로드되었다는 뜻이 아니다.
- **Instagram 오늘의 신규:** 오늘 처음 수집된 항목이다. 게시일과 수집일을 구분한다.
- **YouTube 조회수 검증 완료:** API에서 조회수 값이 있는 항목이라는 표시다. 상품 품질·구매 전환을 검증했다는 의미가 아니다.
- **Instagram 광고·협찬:** 원본 플랫폼에서 유료 광고로 표시한 수집 항목이다.

YouTube의 성과순·좋아요순·댓글순은 관련도순 검색 결과 최대 50개 안에서 앱이 다시 정렬한다. 조회수순·최신순은 해당 기준으로 받은 20개 결과를 보여준다. Instagram 순위는 게시된 수집본 안의 순위다. 어느 쪽도 플랫폼 전체의 절대 순위로 설명하지 않는다.

## KB-SOURCE-005 · 제품 분석과 상품 메모

참고 영상 카드의 **제품 분석**은 상품 후보와 중국어 검색어 등을 정리하는 흐름이다. AI 결과는 추정이며, 화면에 나온 제품과 실제 구매할 제품이 동일한지 사용자가 확인해야 한다.

상품명을 이미 알고 있다면 다음 경로를 쓴다.

1. **보관함 → 상품 메모**에서 **새 상품 메모 만들기**를 연다.
2. **어떤 상품인가요?**에 상품명을 입력하고 **검색어 번역**을 누른다.
3. 이미지에서 상품을 찾으려면 **이미지로 상품 찾기**를 선택한다. 이 기능은 선택한 이미지를 Gemini로 보내 상품명을 추정한다.
4. 한국어 상품명·중국어 검색어·영문 상품명 후보를 검토하고 필요한 내용을 고친다.
5. 메모를 저장하거나 해당 검색어로 원본 찾기를 이어간다.

상품 메모는 이후 프로젝트나 원본 검색에 사용할 정보를 정리하는 자료다. 사진·제목만으로 정확한 모델, 정품 여부, 사용 권한, 실제 효능을 확정하지 않는다.

## KB-SOURCE-006 · REDnote에서 소스 가져오기

**목적:** REDnote에서 사용할 영상 후보를 찾고 프로젝트 원본으로 가져온다.

1. **소스 가져오기**에서 상품 검색어를 입력하고 **찾기**를 누른다.
2. 한글 상품명은 저장된 번역을 먼저 찾아 중국어로 검색한다. 중국어 검색어는 그대로 쓴다. 새 AI 번역이 필요하면 화면의 전송 내용 확인 흐름을 따른다.
3. 지원 환경에서는 오른쪽 REDnote 브라우저 패널이 열린다. 로그인·인증이 필요하면 사용자가 해당 화면에서 직접 진행한다.
4. 원하는 영상 상세 페이지를 연다. 영상이 확인된 페이지에서 상단 **다운로드** 버튼이 나타난다.
5. 다운로드를 실행하고 진행률을 확인한다. 필요한 경우 **다운로드 취소**를 누를 수 있다.
6. 완료 카드에서 담긴 프로젝트와 파일을 확인하고 **프로젝트 계속하기** 또는 **그 프로젝트 계속하기**로 이동한다.

패널을 지원하지 않는 환경에서는 기본 브라우저에서 REDnote가 열린다. 화면 안내에 따라 사용자가 정상적인 방법으로 내려받은 파일을 **내려받은 영상 파일 가져오기**로 추가한다. 자동 다운로드가 대체 경로로 전환된 경우에도 이 가져오기 버튼이 표시될 수 있다.

로그인·CAPTCHA 우회, 브라우저 쿠키 추출, 일괄 수집을 제공하는 기능으로 안내하지 않는다. 원본 제공자의 접근 제한이나 영상 상태에 따라 다운로드할 수 없는 경우가 있다. 검색 결과를 봤다는 사실만으로 재사용 권리가 생기지는 않는다.

## KB-SOURCE-007 · 인기 검색어

1. 왼쪽 **인기 검색어**를 연다.
2. 화면의 **집계 기간**을 선택한다.
3. 검색어별 횟수와 마지막 검색일을 확인한다.
4. 관심 있는 검색어를 누르면 **소스 가져오기**로 이동해 REDnote 검색을 시작한다.

셀비 사용자가 소스 가져오기에서 찾은 검색어의 집계다. Google·네이버·REDnote 전체 검색량이 아니다. 이 집계에는 검색어와 날짜를 사용하며 계정·기기 정보는 저장하지 않는다고 화면에서 안내한다. 이 설명을 앱 전체의 모든 로그·인증정보가 저장되지 않는다는 주장으로 확대하지 않는다.

## KB-SOURCE-008 · 참고 영상 보관함

**보관함 → 참고 영상**에서 **기본 제공**, **오늘의 신규**, **내가 보관**을 고르거나 플랫폼·분야로 좁힌다. 조회수·좋아요·댓글과 함께 수집 기준 시각을 확인한다. 지원 링크는 **브라우저에서 보기**, 그 밖의 항목은 **링크 복사**로 사용한다.

직접 찾은 Instagram 링크는 **아이템 찾기 → 인스타 릴스 → 직접 찾은 릴스 주소 보관**에서 주소와 선택 제목을 입력해 저장한다. **내가 보관** 항목은 삭제할 수 있다. 기본 제공과 오늘의 신규 자료에 동일한 삭제 동작이 있는 것으로 설명하지 않는다.

이 보관함은 링크와 메타데이터를 저장한다. 분야는 기본 제공 레퍼런스에 지정되며 오늘의 신규·내가 보관은 **분야 미지정**에서 찾을 수 있다. YouTube 데이터는 재확인 없이 계속 최신값으로 남는 것이 아니며, 화면은 30일 안에 재확인되지 않은 데이터의 정리를 안내한다.

## KB-SOURCE-009 · 내 영상 파일 추가와 정확한 제한

1. 프로젝트의 **1단계 영상 준비 → 내 영상 파일**을 누른다.
2. MP4 파일을 하나 또는 여러 개 선택한다.
3. 추가된 원본 카드와 총개수를 확인한다.
4. 필요하면 원본 순서를 바꾸고 각 영상의 사용 구간을 설정한다.

직접 가져오는 MP4는 **H.264 비디오와 AAC 오디오 스트림이 포함된 파일**이어야 한다. 확장자만 `.mp4`여도 다른 코덱이거나 오디오 스트림이 없으면 현재 로컬 원본 검사에서 거절한다. REDnote 다운로드에는 호환 형식으로 정리하는 경로가 있지만, 이를 모든 로컬 파일의 자동 변환 지원으로 설명하지 않는다.

**프로젝트 원본은 최대 5개다. 새로 가져오는 각 영상의 전체 길이는 180초 미만이어야 한다. 정확히 180초인 영상도 거절한다.** 예를 들어 179초 영상은 길이 조건을 만족하지만 180초와 181초 영상은 만족하지 않는다. 길이를 확인할 수 없는 파일도 거절될 수 있다.

이 제한은 사용할 구간을 정하기 전의 원본 전체 길이에 적용한다. 4분 영상에서 20초만 쓰겠다고 트림 값을 설정해도 새 원본 가져오기 제한을 통과하지 못한다. 사용하는 구간이 짧다는 이유로 장시간 파일을 그대로 가져올 수 있다고 답하지 않는다. 로컬 파일·REDnote 등 새 영상 가져오기 경로에 적용되는 정책이며 기존 프로젝트의 미디어나 완성본에 대해 동일한 의미의 일괄 삭제 제한은 아니다.

5개보다 많이 선택하거나 프로젝트에 이미 원본이 있으면 남은 슬롯만 추가되고 추가하지 못한 개수를 안내할 수 있다. 필요한 원본을 정리한 뒤 다시 가져온다. 영상 위에 추가하는 편집 레이어와 프로젝트 원본 5개 제한은 서로 다른 개념이다.

## KB-SOURCE-010 · 사용 구간·원본 소리·누락 파일

각 원본 카드에서 영상을 보며 **시작(초)**·**종료(초)** 또는 슬라이더를 조절한다. 원하는 장면에서 멈추고 **현재 장면을 시작으로**, **현재 장면을 종료로**를 사용할 수도 있다. 사용 구간은 영상별로 따로 관리한다.

**원본 음소거**는 해당 원본의 소리를 사용할지 정한다. 내레이션 생성과 원본 소리는 별개이므로 원본 음소거를 껐다고 AI 목소리가 생성되는 것은 아니다. **자막 지우기 영역 지정**도 각 영상 카드에서 연다. 지우기 설정과 실행 후 결과는 다른 문서의 편집·디자인 설명을 따른다.

원본 파일이 사라졌으면 카드에 **원본 파일을 찾을 수 없습니다**가 표시된다. **원본 다시 연결**로 파일을 지정하거나 **이 영상 제거**로 목록에서 뺀다. 다시 연결 경로는 기존 사용 구간·지우기 설정을 유지하도록 되어 있다. 따라서 다시 연결한 영상이 전혀 다른 내용이라면 기존 설정도 함께 검토한다.

## KB-SOURCE-011 · 자주 묻는 질문

**보관했는데 영상 준비에 없어요.**

참고 영상 보관은 링크 저장이다. 사용할 원본 파일을 프로젝트에 별도로 가져와야 한다.

**릴스 새로고침을 눌렀는데 목록이 같아요.**

게시본을 다시 읽기 때문이다. 수집 기준 시각을 확인하고 기간·분야 필터를 조절한다.

**성과 100배면 수익도 100배인가요?**

아니다. 조회수와 채널 규모로 계산한 비교값이며 매출·수익 수치가 아니다.

**3분짜리 영상의 일부만 쓸 수 있나요?**

정확히 3분인 파일은 새로 가져올 수 없다. 180초 미만인 원본이 필요하다. 트림으로 가져오기 정책을 우회할 수 없다.

**REDnote 다운로드 버튼이 안 보여요.**

지원 브라우저 패널에서 영상 상세 페이지와 영상이 확인되어야 표시된다. 환경에 따라 외부 브라우저·파일 가져오기 경로를 사용할 수 있다.

## 구현 근거

- `frontend/src/main.ts`: `renderPageTabs`, `renderShorts`, `loadReels`, `renderReels`, `renderTrends`, `renderTranslate`, `renderLibrary`, `renderRednote`, `renderRednoteDownloadButton`, `renderRednotePane`, `importOptions`, `commitPickedSources` 및 원본 카드의 구간·재연결 UI.
- `frontend/src/state.ts`: `MAX_PROJECT_SOURCES`, `remainingSourceSlots`, `appendSources`, `BookmarkPlatformFilter`, `BookmarkOriginFilter`.
- `internal/media/import.go`: `ValidateImportDuration`, `ImportMP4`, `EnsureCompatibleMP4`, `ErrVideoTooLong`.
- `app.go`: `InspectSource`, `SaveProject`.

그래프의 `ValidateImportDuration` 호출 경로와 원문 조건을 확인했다. 위 경로에 기록된 인덱스 누락은 없지만 외부 서비스의 완전성·현재 가용성을 뜻하지 않는다. 다음 문서: [시작과 프로젝트](01-product-and-start.md), [대본과 음성](03-script-and-audio.md).