Claude Code 활용 YouTube 인기 제품 수집 및 Coupang Partners 링크 매칭기 1시간 완성
유튜브 추천 제품 수집의 번거로움 해결하기
유튜브 영상을 시청하다 보면 영상 속에 소개된 유용한 제품 정보를 찾기 위해 포털이나 쇼핑몰에서 다시 검색해 보는 경험을 자주 겪습니다. 특히 테크 관련 리뷰나 해외 직구 정보를 다루는 채널에서는 제품명이 길거나 영어로 표기되어 일일이 타이핑하기가 번거롭습니다. 이러한 수작업을 줄이고 효율적인 정보 수집 시스템을 만들기 위해, 영상 링크 입력만으로 추천 제품 목록과 쿠팡 파트너스 연동을 위한 검색어를 자동 생성하는 파이프라인 구축 방법을 소개합니다.
정보 탐색에 소요되는 불필요한 단계를 줄이고 정제된 데이터를 곧바로 확보하는 흐름을 설계하는 데 중점을 둡니다. 복잡한 시스템 구축 대신 단일 스크립트로 동작하는 가벼운 자동화 도구를 지향합니다.
이번 과정은 범위를 무리하게 확장하지 않고 유튜브 자막 파일에서 제품 명칭을 식별한 다음, 이를 제휴 마케팅용 키워드로 정제하여 정해진 형식으로 저장하는 일련의 흐름만을 명확하게 다룹니다. 가공된 텍스트를 구조화된 데이터로 변환하는 작업에 초점을 맞춥니다.
구축에 필요한 개발 환경
이 자동화 파이프라인은 Anthropic의 명령줄 도구인 Claude Code 환경에서 작동합니다. 로컬 시스템에 관련 CLI 패키지가 사전에 전역 설치되어 있어야 원활한 진행이 가능합니다. 아울러 파이썬 기반의 스크립트를 함께 활용하므로 시스템에 python3 환경이 마련되어 있는지 확인해야 합니다.
유튜브 자막을 추출할 때 활용하는 라이브러리는 스크립트 작성 과정에서 설치를 진행하면 됩니다. 전체 파이프라인은 대규모 데이터베이스나 검색 프레임워크를 요구하지 않으며, 단일 파일 형태의 파이썬 코드로 간결하게 작동하도록 구성합니다.
개발 과정에서는 모든 모듈을 한 번에 결합하기보다 단계별로 나누어 구현하는 편이 안정적입니다. 자막 추출, 제품 정보 분석, 시각화 화면 구성의 순서대로 순차적인 빌드를 진행하는 방식을 권장합니다.
자동화 파이프라인 설계 단계
작업의 일관성을 유지하기 위해 프로젝트의 최상위 경로에 개발 규칙을 담은 설정 파일인 CLAUDE.md를 구성하는 편이 유리합니다. 해당 파일에 구체적인 개발 지침을 기록해 두면 AI 도구가 코드를 생성할 때 일관된 스타일을 유지하도록 돕습니다. CLI 환경에서 설정을 초기화한 후 아래 예시처럼 지침을 정의합니다.
# CLAUDE.md 규칙
- 개발 톤: 담백하고 깔끔하게, 불필요한 클래스 정의 없음
- 스크립트: 단일 파이썬 파일로 구성
- 결과 포맷: JSON과 한 장짜리 HTML 뷰어 페이지 생성
규칙이 설정되면 명확한 지침 하에 코딩을 이어나갈 수 있습니다. 이후의 과정은 필요한 세부 기능들을 하나씩 덧붙여 나가는 단계로 나뉩니다.
첫 단계는 입력받은 영상의 자막 정보를 로컬 시스템으로 가져오는 스크립트의 뼈대를 만드는 작업입니다. 터미널 환경의 개발 도구에 다음과 같이 첫 요구사항을 입력합니다.
추출 과정과 분석 과정을 분리하여 작성하면 향후 발생할 수 있는 데이터 오류의 원인을 파악하기 용이합니다. 지시어가 실행되면 개발 도구는 필요한 의존성 패키지의 설치 여부를 파악하고 설치를 제안하게 됩니다. 스크립트 파일이 생성된 이후에는 제공된 실행 인자를 바탕으로 로컬에서 동작을 점검합니다.
점검 시점에는 지정한 영상 링크에서 자막 텍스트가 정상적으로 수집되는지, 비어 있는 값 대신 의미 있는 문장들로 파싱되어 파일로 저장되는지 여부만 확인하면 충분합니다.
자막 데이터가 정상적으로 저장되었다면 이제 언어 모델 API를 활용해 자막 텍스트를 분석하고 타깃 제품과 매칭 키워드를 정제하는 기능을 추가할 단계입니다. 앞서 만든 스크립트에 기능을 추가하도록 지시합니다.
요청 시 제품명을 구체적인 모델명 중심으로 한정하고 검색 목적에 부합하는 키워드로 출력하도록 범위를 지정해야 합니다. 명확한 범위를 정해주지 않으면 대화 중에 등장하는 일반적인 단어나 감탄사까지 제품 정보로 오인해 추출할 위험이 있습니다. 분석이 완료되면 브랜드명과 고유 명사 위주로 구성된 데이터가 JSON 배열 형식으로 기록됩니다.
추출되는 검색어의 완성도는 향후 플랫폼 검색 시 매칭 성능에 직접적인 영향을 미칩니다. 검색어의 길이를 적절히 유지하여 타깃 페이지로 올바르게 연결되도록 정밀도를 높이는 구성이 요구됩니다.
텍스트 데이터로 저장된 결과를 직관적으로 파악하고 편리하게 복사하여 활용할 수 있도록 일원화된 HTML 대시보드 화면을 빌드합니다. UI 디자인에 대한 세부 요구사항을 전달합니다.
이를 통해 수집된 정보를 카드 형태로 나열하고 각 요소마다 검색 페이지 바로가기 링크 및 키워드 복사 기능이 탑재된 최종 결과물이 완성됩니다. 어두운 배경에 시인성이 좋은 레이아웃을 입혀 사용자가 필요한 동작을 빠르게 수행할 수 있도록 돕습니다.
이 대시보드의 주요 목적은 심미적인 만족뿐 아니라 실제 작업 동선을 단축하는 데 있습니다. 제품의 목록과 제휴 마케팅용 키워드, 복사 버튼이 조화롭게 배치되어 전체적인 작업 처리 속도를 높여 줍니다.
주요 예외 상황 처리 가이드
설계 단계나 실행 중에 발생하기 쉬운 문제들과 그에 대한 해결 방향을 정리해 둡니다.
먼저, 자막 데이터를 가져오는 과정에서 오류가 보고되는 현상이 있을 수 있습니다. 라이브러리가 자막을 불러오지 못할 때는 해당 영상의 소유자가 자동 자막 기능을 비활성화했거나 자막 자체가 존재하지 않는 상태일 가능성이 큽니다. 이 경우 파이썬 스크립트 내부에서 언어 설정의 우선순위를 명시적으로 지정하고, 수동 자막이 없을 때 자동 생성 자막을 대체로 선택하도록 코드를 수정하여 해결할 수 있습니다.
다음으로, 추출된 결과 파일에 불필요한 일상 대화가 제품 이름으로 포함되는 경우입니다. 이는 대화 맥락 분석 단계에서 조건이 느슨하여 발생합니다. 모델에 제공하는 시스템 프롬프트나 설정 파일에 제품의 브랜드명과 고유한 모델 번호가 결합된 형태만 선별해 내도록 규칙을 보완하면 원치 않는 텍스트가 유입되는 것을 예방할 수 있습니다.
마지막으로, 브라우저에서 로컬 JSON 파일을 직접 읽어오지 못해 화면이 표시되지 않는 현상입니다. 이는 웹 브라우저의 보안 정책(CORS)에 기인한 것입니다. 로컬 환경에서 가벼운 웹 서버를 실행하여 접근하거나, 빌드 스크립트 내에서 JSON 데이터를 HTML 문서 내부의 자바스크립트 변수로 직접 치환하여 주입하는 구조로 방식을 변경하면 간단히 해결됩니다.
파이프라인 확장 방향
단일 영상 분석용으로 개발된 이 파이프라인은 메신저 플랫폼의 API와 연계할 때 더욱 유용하게 활용될 수 있습니다. 특정 유튜브 채널의 신규 영상 업로드 여부를 주기적으로 감지하여 서버에서 자동으로 이 파이프라인을 구동하고, 추출된 쇼핑 제휴 키워드를 알림 채널로 전송하는 방식으로 확장이 가능합니다. 이러한 파이프라인 고도화를 통해 최소한의 관리 비용으로 정제된 마케팅 리소스를 안정적으로 확보하는 자동화 시스템을 운영할 수 있습니다.
이런 글도 있어요
관련 검색어
- 🔍 Claude Code 사용법
- 🔍 Claude Code 비교
- 🔍 YouTube 인기 제품 수집 사용법
- 🔍 YouTube 인기 제품 수집 비교
- 🔍 Coupang Partners 사용법
- 🔍 Coupang Partners 비교
