Claude Code 활용 Etsy 굿즈 소싱 에이전트 1시간 만에 만들기
Etsy에서 경쟁력 있는 디지털 상품을 AI로 발굴하기
글로벌 핸드메이드 마켓플레이스인 Etsy는 마진율이 높은 시장으로 잘 알려져 있습니다. PDF 형태의 플래너나 그래픽 디자인 리소스 같은 디지털 파일은 실물 배송이 필요 없고 마진율이 90%를 상회하기 때문입니다. 소싱 경쟁이 치열한 만큼 정교한 시장 분석이 필수적입니다.
전편에서 다룬 자동화 파이프라인에 이어, 이번에는 실질적인 수익화 기회를 포착하는 시스템을 다룹니다. 목표는 Etsy에서 검색량이 높고 경쟁 강도가 낮은 디지털 굿즈 아이템을 선별하는 것입니다. 제작 난이도와 마진을 종합적으로 판별해 주는 소싱 에이전트를 구축하는 과정을 살펴보겠습니다.
이 에이전트는 관심 카테고리를 지정하고 타깃 키워드를 입력하는 방식으로 작동합니다. 분석 요청을 보내면 화면에 추천 아이템 정보가 담긴 분석 카드가 실시간으로 동적 생성되는 구조입니다. 데이터 흐름을 시각적으로 확인하기 편리하다는 장점이 있습니다.
작업 도구 준비 및 CLI 개발 비서 활용
Claude개발을 시작하기 위해 CLI 기반 AI 개발 도구인 Claude Code를 활용해 작업을 시작합니다. 터미널 환경에서 명령어 하나로 코드를 생성하고 수정할 수 있는 환경을 준비하면 충분합니다. 로컬 시스템에 기본 설정을 마친 상태에서 작업을 이어서 진행하겠습니다.
이번 프로젝트는 별도의 복잡한 개발 서버 설정 단계를 거치지 않습니다. Claude Code를 통해 터미널 상에서 즉시 코드를 보완하고 브라우저에서 index.html 단일 파일 형태로 직접 열어 실행할 수 있는 구조를 만듭니다. 불필요한 인프라 구축 비용을 줄이고 본질적인 분석 화면 구현에만 집중할 수 있습니다.
에이전트 점진적 빌드 및 구현 과정
첫 단계에서는 핵심 뼈대만 빠르게 구축하는 전략이 효율적입니다. 처음부터 복잡한 레이아웃을 채택하면 코드를 작성하는 과정에서 예기치 못한 스타일 충돌이나 오작동이 일어날 확률이 높아집니다. 주요 컴포넌트의 위치와 영역을 확보하는 작업에 주력합니다.
해당 프롬프트를 전달하면 로컬 디렉터리에 디자인이 적용된 index.html 단일 파일이 작성됩니다. 다크모드가 기본 적용되어 시각적 피로도가 낮고 깔끔한 인터페이스가 확보됩니다.
외부 API 통신을 즉시 연결하는 것보다 모킹된 데이터를 먼저 활용하는 방식을 권장합니다. 화면 갱신 주기나 데이터 렌더링 흐름을 사전에 검증할 수 있기 때문입니다. 불필요하게 소모되는 호출 비용을 절감하는 이점도 있습니다.
임시 데이터를 활용해 소싱 제안 카드가 화면에 정상적으로 표시되는지 확인합니다. 카드 내의 가격 정보, 제작 난이도 레이아웃이 어색하지 않게 정렬되면 기본 구조 설계는 안정적으로 마무리가 됩니다.
별도의 웹 서버 백엔드를 구성하는 대신 브라우저에서 직접 API 엔드포인트에 요청을 전송하는 구조를 택합니다. 화면 상단에 사용자가 API 키를 안전하게 입력할 수 있는 필드를 추가하여 범용성을 높입니다.
입력된 인증 키는 브라우저 로컬스토리지에 저장되므로 매번 다시 입력할 필요가 없습니다. 키워드 분석을 실행하면 외부 엔진이 트렌드를 종합 분석한 뒤 정형화된 데이터 규격으로 카드를 생성합니다. 서버 유지 비용 없이 독립적으로 작동하는 에이전트가 완성됩니다.
완성도 향상을 위한 스타일링 디테일 보완
기능 구현이 완료된 후에는 터미널 환경에서 Claude Code의 코드 검토 기능 등을 활용하여 완성도를 다듬을 수 있습니다. 렌더링된 화면의 레이아웃을 세부 조정하는 과정입니다. 작은 시각적 요소가 전체 사용자 경험의 완성도를 결정짓습니다.
카드 컴포넌트에 마우스 호버 시 살짝 떠오르는 모션 효과를 주거나, 분석이 진행되는 동안 로딩 스피너가 회전하는 애니메이션을 추가해 봅니다. 복잡한 CSS 애니메이션 코드 역시 프롬프트를 통해 매끄럽게 작성할 수 있습니다.
오류 발생 시 대처 및 해결 방안
동작 중단 및 브라우저 응답 없음
분석 버튼을 눌렀을 때 응답이 없고 콘솔 창에 오류가 기록된다면 CORS 정책 위반이나 헤더 설정 누락이 원인일 가능성이 큽니다. 개발자 도구를 통해 통신 패킷을 검사해 봅니다. CORS 차단이 확인되면 요청 헤더의 불필요한 값을 정리하거나 프롬프트 수정을 통해 직접 호출 규격을 재정비해야 합니다.
동일한 분석 결과의 반복 출력
호출 시마다 가격이나 경쟁률 등의 수치가 고정되어 출력된다면 API 파라미터의 다양성 설정이 낮게 고정되었기 때문입니다. fetch 요청 본문의 무작위성 지수를 조정해 볼 필요가 있습니다. 생성 다양성을 결정하는 수치를 0.7 수준으로 높이고, 프롬프트에서 조건부 제약을 완화하여 다양한 분석 결과가 나오도록 유도합니다.
인증 실패 경고 메시지 출력
인증 키를 올바르게 기입했음에도 권한 오류가 발생한다면 텍스트 복사 과정에서 보이지 않는 공백 문자가 포함되었을 확률이 높습니다. 코드 내부에서 문자열의 앞뒤 공백을 제거하는 메서드를 적용해 둡니다. 추가로 대시보드에서 결제 한도나 만료 여부를 점검하는 것도 방법입니다.
에이전트 확장 및 후속 파이프라인 구상
지금까지 검색어를 입력해 분석 결과를 도출하는 소싱 에이전트 구조를 개발했습니다. 여기에 엑셀 시트나 텍스트 파일에 담긴 대량의 검색어 리스트를 한번에 읽어 차례로 자동 소싱하는 일괄 처리 기능을 추가하면 전체적인 작업 속도를 획기적으로 향상할 수 있습니다.
다음 단계에서는 이 분석기가 탐색해 준 기획안을 활용해 판매 가능한 형태로 최종 가공하는 과정을 다룹니다. AI 이미지 생성 시스템을 결합하여 디지털 템플릿의 디자인 시안을 대량으로 일괄 제작하는 파이프라인 구현 방법을 상세히 짚어보겠습니다.
이런 글도 있어요
관련 검색어
- 🔍 Claude Code 사용법
- 🔍 Claude Code 비교
- 🔍 Etsy 굿즈 사용법
- 🔍 Etsy 굿즈 비교
- 🔍 소싱 에이전트 사용법
- 🔍 소싱 에이전트 비교
