쿠팡 상품 정보 추출기

쿠팡 상품 페이지에서 필요한 정보를 클립보드로 복사하고 쿠팡 파트너스 링크를 생성하는 크롬 확장프로그램입니다.

기능

• ✅ 상품 페이지에서 상품명, 가격, 상품 이미지(최대 4개), 상품 상세정보, 별점을 추출
• ✅ 우측 하단의 플로팅 버튼으로 간편하게 복사
• ✅ 상품 이미지는 492x492 크기로 자동 변환
• ✅ '품목' 키워드가 포함된 상세정보를 상품 설명으로 자동 추출
• ✅ 쿠팡 파트너스 링크 자동 생성 및 복사
• ✅ 새로운 쿠팡 페이지 구조 지원 (2025년 5월 업데이트)

설치 방법

1. 저장소 클론

git clone https://github.com/your-username/coupang-product-extractor.git
cd coupang-product-extractor

2. 쿠팡 파트너스 API 키 설정

1. 쿠팡 파트너스에서 API 키 발급
2. 프로젝트 루트에 .env.local 파일 생성:

cp env.example .env.local

3. .env.local 파일에 발급받은 API 키 입력:

COUPANG_ACCESS_KEY=your_actual_access_key
COUPANG_SECRET_KEY=your_actual_secret_key
COUPANG_SUB_ID=your_sub_id

참고: SUB_ID는 트래킹을 위한 식별자로, 원하는 문자열을 입력하면 됩니다.

3. 크롬 확장프로그램 설치

• Chrome 브라우저에서 chrome://extensions/ 접속
• 우측 상단의 '개발자 모드' 활성화
• '압축해제된 확장 프로그램을 로드합니다' 클릭
• 클론한 폴더 선택

사용 방법

1. 쿠팡 상품 페이지 접속
2. 우측 하단에 두 개의 플로팅 버튼이 표시됨:
   • 상품 정보 복사: 상품의 모든 정보를 JSON 형태로 클립보드에 복사
   • 쿠팡링크만들기: 쿠팡 파트너스 링크를 생성하여 클립보드에 복사(쿠팡 링크 생성 버튼)
3. 필요에 따라 원하는 버튼 클릭

추출되는 정보

{
  "title": "상품명",
  "price": "가격 (숫자만)",
  "imageUrls": ["이미지URL1", "이미지URL2", "이미지URL3", "이미지URL4"],
  "description": "품목 정보",
  "rating": "별점 (5점 만점)"
}

파일 구조

coupang-product-extractor/
├── manifest.json       # 확장프로그램 설정
├── content.js          # 메인 크롤링 로직
├── background.js       # 쿠팡 파트너스 API 처리
├── styles.css          # 플로팅 버튼 스타일
├── env.example         # 환경변수 설정 예시
├── .env.local          # 실제 API 키 (Git에 포함되지 않음)
├── .gitignore          # Git 제외 파일 목록
└── icons/              # 아이콘 이미지
    ├── icon16.png
    ├── icon48.png
    └── icon128.png

주의사항

• ⚠️ .env.local 파일은 절대 Git에 커밋하지 마세요 (API 키 노출 위험)
• ⚠️ 쿠팡 파트너스 API 키는 개인정보이므로 안전하게 관리하세요
• ⚠️ API 사용량에 제한이 있을 수 있으니 과도한 요청은 피하세요

버전 히스토리

v1.3.3 (최신)

• 🔐 API 키 보안 강화 (환경변수로 완전 분리)
• 🔧 하드코딩된 subId를 환경변수로 변경
• 📝 Git 공유를 위한 보안 설정 완료

v1.3.2

• 🔄 새로운 쿠팡 페이지 구조에 맞춰 크롤링 셀렉터 업데이트
• 🖼️ 이미지 추출 로직 개선 (4개 미만인 경우에도 정상 동작)
• 🏷️ 상품명, 가격 추출 셀렉터 변경

v1.3.1

• 🔗 쿠팡 파트너스 딥링크 생성 기능 추가
• 🎯 플로팅 버튼 UI 개선

v1.2.2

• ⭐ 별점 정보 추출 기능 추가

v1.2.1

• 📝 '품목' 키워드가 포함된 모든 상세정보를 크롤링하도록 수정

v1.2.0

• 📋 상품 상세정보(품명 및 모델명) 크롤링 기능 추가

v1.1.0

• 🖼️ 이미지 URL 크기를 492x492ex로 고정하도록 수정

v1.0.0

• 🎉 최초 릴리즈
• 🏷️ 상품명, 가격, 이미지 URL 추출 기능

문제 해결

크롤링이 안 될 때

• 쿠팡이 페이지 구조를 변경했을 수 있습니다
• 브라우저 개발자 도구로 새로운 셀렉터를 확인해주세요

파트너스 링크 생성이 안 될 때

• .env.local 파일에 올바른 API 키가 설정되어 있는지 확인
• 쿠팡 파트너스 계정이 승인된 상태인지 확인
• 브라우저 콘솔에서 에러 메시지 확인

라이선스

이 프로젝트는 MIT 라이선스를 따릅니다.

면책조항

이 도구는 개인적인 용도로 제작되었습니다. 쿠팡의 이용약관을 준수하여 사용하시기 바랍니다.