Claude Code 활용 AliExpress 상세페이지 AI 번역 에이전트 만들기
알리익스프레스 상품 정보, 정돈되지 않은 외국어 표현으로는 판매가 어렵습니다
해외 쇼핑몰의 상품 데이터를 국내 온라인 스토어에 등록할 때 직면하는 가장 번거로운 과정 중 하나는 바로 설명글 변환 및 상세페이지 편집 작업입니다. 이전 단계에서 외부 상품 정보를 수집하는 도구를 개발했다면, 이번에는 수집된 데이터를 바로 활용 가능한 형태의 한국어 마케팅 문구로 변환하는 자동화 시스템을 구축하는 방법을 자세히 다룹니다.
매끄럽지 않은 외국어 표현을 자연스럽게 수정하는 반복 작업을 자동화하면 전체 소싱 작업에 드는 시간을 획기적으로 개선할 수 있습니다. 기술적인 지식 수준에 구애받지 않고, 간단한 터미널 명령과 별도로 작성한 규칙 지침만을 연계하여 동작하는 자동화 도구를 차례대로 설계해 보겠습니다.
작업 수행을 위한 도구 및 준비 사항
이번 자동화 과정에서 사용하는 핵심 도구는 Claude Code입니다. 이 도구는 로컬 파일 구조를 인지하고 편집할 수 있는 기능을 제공하며, 터미널 환경에서 효율적인 개발 보조 역할을 수행합니다.
기타 여러 도구를 추가적으로 조합할 필요 없이, 단일 실행 환경 내부에서 자동화 소스 코드 생성부터 테스트 및 최종 검증까지 전체 흐름을 일괄적으로 진행할 수 있습니다. 기본 설정이 완료된 터미널과 Node.js 환경만 준비하면 즉시 작업을 이어갈 수 있습니다.
상세페이지 변환 시스템 설계 3단계
이 시스템은 입력된 상품의 원문 정보를 기반으로 국내 이커머스 플랫폼의 형식에 맞춘 마케팅 문구 카드로 재가공하도록 설계합니다. 구체적인 구현 과정을 순서대로 살펴보겠습니다.
첫 단계로 로컬 디렉터리에 저장된 원문 파일을 읽고 한국어로 기본 번역을 마친 뒤, 다른 파일에 기록하는 Node.js 소스 코드 작성을 요청합니다. 아래와 같은 프롬프트 예시를 사용하여 스크립트 제작을 시작할 수 있습니다.
처음부터 정교한 검색 최적화나 복잡한 출력 레이아웃을 한 번에 명령하면 구조적인 오류가 발생할 확률이 높습니다. 먼저 입력과 출력을 매끄럽게 처리하는 가장 기본적인 파이프라인을 다진 뒤 다음 과정을 추가하는 것이 안전합니다.
준비된 input.txt 파일에 예시용 영문 상품 정보를 붙여넣고 터미널에 node translator.js를 입력하면 작업이 개시됩니다. 이후 생성된 output.txt 파일 내에 내용이 정상적으로 기록되어 있는지 확인하여 정상 작동 여부를 판단할 수 있습니다.
원문을 단순하게 직역하는 방식은 수식어의 나열이나 해외 사이트 특유의 어투가 남아 있어 국내 소비자에게 신뢰감을 주기 어렵습니다. 따라서 국내 마케팅 정서에 어울리는 자연스러운 상품 설명과 검색 키워드가 결합되도록 스크립트를 변경합니다.
생성 모델의 프롬프트에 마케팅 지침과 템플릿 제약을 제공하지 않을 경우 단조로운 직역 결과에 머무를 우려가 큽니다. 핵심 특징 추출 및 혜택 정리와 같은 명확한 아웃풋 틀을 정의해야 비즈니스에 실질적으로 쓸 수 있는 품질의 텍스트가 나옵니다. 프롬프트 템플릿을 수정하고 재생성하면 불필요한 직역투가 대폭 억제되고, 핵심 요약 위주의 정돈된 텍스트가 출력물로 기록되기 시작합니다.
변환 작업을 대량으로 수행하다 보면 모델이 특정 시점에 과장 광고로 분류될 만한 수식어를 과도하게 생성하는 상황이 종종 발생합니다. 디렉터리에 AGENTS.md라는 파일명으로 가이드라인을 정의해 두고, 시스템이 엄격한 스타일 규칙을 참조하도록 유도하겠습니다.
Claude Code는 작업 실행 도중 경로 내에 위치한 AGENTS.md와 같은 메타 규칙 파일을 실시간으로 인지하여 개발에 반영합니다. 따라서 제어 지침을 해당 가이드에 고정해 두는 것으로 결과물의 균일성을 높일 수 있습니다.
AGENTS.md 파일에 명시할 수 있는 규칙 지침의 예시입니다. 첫째, 문체는 정중하고 격식 있는 높임말을 사용하여 일관성을 유지합니다. 둘째, 최대 혜택이나 즉시 할인, 긴급 처분과 같은 광고 심의에 저촉될 수 있는 금지 키워드를 사전에 필터링하도록 지정합니다. 셋째, 타이틀 1행, 주요 특징 요약 3행, 상품 가이드 2행과 같은 정형화된 레이아웃 규격을 설정합니다. 가이드 파일이 추가된 환경에서 재작동시키면 규칙에 기반하여 일정한 어조의 한국어 설명 문구가 고르게 도출되는 것을 확인할 수 있습니다.
예상되는 이슈 및 대처 요령
자동화 프로그램을 구동하는 과정에서 여러 예외 상황이나 오류가 발생할 수 있습니다. 이에 대비하기 위한 몇 가지 대표적인 문제 해결 방법을 소개합니다.
첫 번째 문제는 번역 결과물에 영문 원어가 정리되지 않은 채 섞여 나오거나 핵심 제원 수치가 누락되는 현상입니다. 이는 대개 입력 데이터에 복잡한 HTML 마크업이나 불필요한 스크립트 코드가 섞여 있어 모델의 해석을 방해하기 때문입니다. 이럴 때는 입력 파일인 input.txt에서 텍스트 정보만 깔끔하게 정제한 후 작업을 다시 시도하는 것이 좋습니다.
두 번째 문제는 사전에 차단하도록 지정했던 금지 수식어들이 본문에 임의로 포함되어 출력되는 현상입니다. API 요청 시 전달되는 시스템 지침의 영향력이 약할 때 발생할 수 있는 현상입니다. 이 경우 translator.js 코드 내부의 시스템 프롬프트 영역에 AGENTS.md 파일의 텍스트 내용을 문자열 형태로 바인딩하여 결합하는 방식으로 제어력을 보완할 수 있습니다.
세 번째 문제는 실행 과정에서 모듈을 찾을 수 없다는 시스템 에러가 표시되는 상황입니다. 프로젝트 폴더 내에 필요한 환경 설정 파일이나 라이브러리가 올바르게 설치되지 않았을 때 주로 발생합니다. 터미널에서 패키지 초기화 명령을 수행하여 환경을 새로 구성하고, 필요한 라이브러리를 재설치하여 해결합니다.
프로세스의 확장 및 차기 작업
구축된 변환 시스템을 고도화하면 대량의 해외 상품 정보를 파일 목록 단위로 순차 처리하는 일괄 작업 프로그램으로 확장할 수 있습니다. 이렇게 생성된 텍스트 데이터를 쇼핑몰 상세페이지의 특정 서식에 자동으로 적용하는 추가 자동화 파이프라인 설계도 가능합니다. 다음 단계에서는 가공된 텍스트와 상품 이미지를 결합하여 홍보용 썸네일과 설명용 시각 요소를 자동으로 레이아웃하고 배치하는 이미지 처리 파이프라인 구축 과정을 살펴보겠습니다.
이런 글도 있어요
관련 검색어
- 🔍 Claude Code 사용법
- 🔍 Claude Code 비교
- 🔍 AliExpress 사용법
- 🔍 AliExpress 비교
- 🔍 상세페이지 번역 사용법
- 🔍 상세페이지 번역 비교
