🔎 쿠팡 상품정보 크롤링이란?
쿠팡 상품정보 크롤링은 특정 상품의 정보를 자동으로 수집하여 데이터화하는 과정입니다.
이를 활용하면 상품 가격 비교, 데이터 분석, 블로그 포스팅 자동화 등 다양한 활용이 가능합니다.
쿠팡은 API를 공식적으로 제공하지 않기 때문에, 상품 정보를 가져오려면 웹 크롤링 기술을 활용해야 합니다.
이번 글에서는 쿠팡 상품정보를 자동으로 추출하고 파트너스 링크까지 생성하는 크롬 확장 프로그램을 소개하고, 이를 활용하는 방법을 설명하겠습니다.
🛠 쿠팡 상품정보 크롤링 확장 프로그램 소개
본 확장 프로그램은 크롬 브라우저에서 실행되며,
쿠팡 상품 페이지에서 상품명, 가격, 이미지 URL, 상품 설명, 별점을 자동으로 추출하여 클립보드에 복사하고, 쿠팡 파트너스 링크까지 자동 생성하는 기능을 제공합니다.
✅ 주요 기능
- 쿠팡 상품 페이지에서 상품명, 가격, 상품 이미지(최대 4개), 상품 상세정보, 별점 자동 추출
- 🔗 쿠팡 파트너스 링크 자동 생성 및 복사 (NEW!)
- 클릭 한 번으로 데이터를 클립보드에 복사
- 새로운 쿠팡 페이지 구조 완벽 지원 (2025년 5월 27일 업데이트)
- 크롤링된 데이터를 활용하여 블로그, 엑셀, 데이터베이스 등에 저장 가능
- JSON 형식으로 변환하여 손쉬운 데이터 활용 가능
- GitHub에서 오픈소스로 제공 (소스 코드 보기)
- 🔐 API 키 보안 강화 - 환경변수로 안전하게 관리
GitHub - ksm1569/coupang-product-extractor: 크롬 확장프로그램 - 쿠팡 상품정보 클립보드 저장
크롬 확장프로그램 - 쿠팡 상품정보 클립보드 저장. Contribute to ksm1569/coupang-product-extractor development by creating an account on GitHub.
github.com
✅ 폴더 구조
.
├── content.js # 크롤링 로직이 구현된 자바스크립트 파일
├── background.js # 쿠팡 파트너스 API 처리 로직
├── styles.css # 확장 프로그램 UI 스타일링
├── manifest.json # 크롬 확장 프로그램 기본 설정 파일
├── env.example # 환경변수 설정 예시 파일
├── .env.local # 실제 API 키 설정 파일 (Git에 포함되지 않음)
├── .gitignore # Git 제외 파일 목록
├── icons/ # 확장 프로그램 아이콘 이미지 저장 폴더
│ ├── icon16.png
│ ├── icon48.png
│ └── icon128.png
└── readme.md # 확장 프로그램 설명 및 사용법
🏗 크롤링 코드 상세 분석 (2025년 업데이트)
쿠팡이 페이지 구조를 변경함에 따라 크롤링 로직도 업데이트되었습니다.
content.js
에 구현된 최신 크롤링 로직을 살펴보겠습니다.
📌 1. 상품명 추출 (업데이트됨)
const title = document.querySelector('body > div.sdp-content... > h1 > span')?.textContent?.trim();
📌 2. 가격 추출 (업데이트됨)
const price = document.querySelector('body > div.sdp-content... > div.price-amount.final-price-amount')?.textContent?.trim()
.replace('원', '').replace(/,/g, '');
📌 3. 상품 이미지 URL 추출 (개선됨)
const imageUrls = [];
// 첫 번째 이미지 (대표 이미지)
const firstImg = document.querySelector('body > div.sdp-content... > img');
if (firstImg && firstImg.src) {
const imgUrl = firstImg.src
.replace(/^\/\//, 'https://')
.replace(/\/\d+x\d+ex\//, '/492x492ex/');
imageUrls.push(imgUrl);
}
// 두 번째~네 번째 이미지 (있는 것만)
for (let i = 2; i <= 4; i++) {
const img = document.querySelector(`body > div.sdp-content... > ul > li:nth-child(${i}) > img`);
if (img && img.src) {
const imgUrl = img.src
.replace(/^\/\//, 'https://')
.replace(/\/\d+x\d+ex\//, '/492x492ex/');
imageUrls.push(imgUrl);
}
}
📌 4. 상세정보(모델명) 추출
let modelName = '';
const rows = document.querySelectorAll('.prod-delivery-return-policy-table tr');
for (const row of rows) {
const thText = row.querySelector('th')?.textContent?.trim() || '';
if (thText.includes('품목')) {
modelName = row.querySelector('td')?.textContent?.trim() || '';
break;
}
}
📌 5. 별점 정보 추출
let rating = 0;
const ratingElement = document.querySelector('#prod-review-nav-link .rating-star-num');
if (ratingElement) {
const widthStyle = ratingElement.style.width;
if (widthStyle) {
const percentValue = parseFloat(widthStyle.replace('%', ''));
rating = (percentValue / 100) * 5;
rating = Math.round(rating * 10) / 10;
}
}
📌 6. 쿠팡 파트너스 링크 생성 (NEW!)
async function createCoupangDeeplink(url) {
const keys = await loadCoupangKeys();
const apiUrl = 'https://api-gateway.coupang.com/v2/providers/affiliate_open_api/apis/openapi/v1/deeplink';
const requestBody = JSON.stringify({
coupangUrls: [url],
subId: keys.subId
});
const signature = await generateCoupangSignature('POST', '/v2/providers/affiliate_open_api/apis/openapi/v1/deeplink', keys.accessKey, keys.secretKey);
// API 호출 및 딥링크 반환
// ...
}
🚀 크롬 확장 프로그램 설치 및 사용 방법
✅ 1. 확장 프로그램 설치
- GitHub 저장소 클론
git clone https://github.com/ksm1569/coupang-product-extractor.git cd coupang-product-extractor
- 쿠팡 파트너스 API 키 설정 (파트너스 기능 사용 시)
- 쿠팡 파트너스에서 API 키 발급
- 프로젝트 루트에
.env.local
파일 생성:
cp env.example .env.local
.env.local
파일에 발급받은 API 키 입력:
COUPANG_ACCESS_KEY=your_actual_access_key COUPANG_SECRET_KEY=your_actual_secret_key COUPANG_SUB_ID=your_sub_id
- 크롬 확장 프로그램 설정
- Chrome 브라우저에서
chrome://extensions/
접속 - 우측 상단의 '개발자 모드' 활성화
- '압축해제된 확장 프로그램을 로드합니다' 클릭
- 클론한 폴더 선택
- Chrome 브라우저에서
✅ 2. 확장 프로그램 사용 방법
📸 [여기에 확장 프로그램 실행 화면 스크린샷 삽입]
- 쿠팡 상품 페이지 접속
- 우측 하단에 두 개의 플로팅 버튼이 표시됨:
- 상품 정보 복사: 상품의 모든 정보를 JSON 형태로 클립보드에 복사
- 🔗 쿠팡링크만들기: 쿠팡 파트너스 링크를 생성하여 클립보드에 복사
- 필요에 따라 원하는 버튼 클릭
✅ 3. 추출되는 정보
{
"title": "상품명",
"price": "가격 (숫자만)",
"imageUrls": ["이미지URL1", "이미지URL2", "이미지URL3", "이미지URL4"],
"description": "품목 정보",
"rating": "별점 (5점 만점)"
}
📸 [여기에 클립보드 복사 후 사용 예제 스크린샷 삽입]
🔐 보안 주의사항
⚠️ 중요: API 키는 개인정보이므로 다음 사항을 반드시 준수하세요.
.env.local
파일은 절대 Git에 커밋하지 마세요- 쿠팡 파트너스 API 키는 안전하게 관리하세요
- API 사용량에 제한이 있을 수 있으니 과도한 요청은 피하세요
🆕 최신 업데이트 (v1.3.3)
✅ 새로운 기능
- 🔄 새로운 쿠팡 페이지 구조 완벽 지원
- 🔗 쿠팡 파트너스 링크 자동 생성
- 🖼️ 이미지 추출 로직 개선 (4개 미만인 경우에도 정상 동작)
- ⭐ 별점 정보 추출
✅ 보안 강화
- 🔐 API 키를 환경변수로 완전 분리
- 📝 Git 공유 시 민감정보 자동 보호
- 🔧 하드코딩된 값들을 환경변수로 변경
🎯 결론
쿠팡 상품 정보를 자동으로 크롤링하고 파트너스 링크까지 생성하는 크롬 확장 프로그램을 활용하면, 수작업 없이 빠르고 정확한 데이터 수집과 수익화가 동시에 가능합니다.
새롭게 업데이트된 기능으로 더욱 안전하고 효율적으로 상품 정보를 관리하고 활용해보세요.
🔗 소스 코드 보기: GitHub - coupang-product-extractor
GitHub - ksm1569/coupang-product-extractor: 크롬 확장프로그램 - 쿠팡 상품정보 클립보드 저장
크롬 확장프로그램 - 쿠팡 상품정보 클립보드 저장. Contribute to ksm1569/coupang-product-extractor development by creating an account on GitHub.
github.com
이제 직접 다운로드하여 사용해 보세요! 🚀
📸 [실 사용 스크린샷]
📞 문의 및 지원
크롤링이 안 되거나 파트너스 링크 생성에 문제가 있을 때는 다음을 확인해보세요:
🔧 문제 해결
- 크롤링이 안 될 때: 쿠팡이 페이지 구조를 변경했을 수 있습니다. 브라우저 개발자 도구로 새로운 셀렉터를 확인해주세요.
- 파트너스 링크 생성이 안 될 때:
.env.local
파일의 API 키 설정과 쿠팡 파트너스 계정 승인 상태를 확인해주세요.
💡 팁: 이 프로젝트는 오픈소스이므로 GitHub에서 이슈를 등록하거나 기여할 수 있습니다!
'유용한툴 및 사이트' 카테고리의 다른 글
Mermaid로 아키텍처 다이어그램 자동화하기: 마크다운으로 그리는 효율적인 아키텍처 문서 (0) | 2025.06.23 |
---|---|
개발자용 생산성 앱 비교: Notion vs Obsidian vs Logseq - 2025년 완벽 가이드 (0) | 2025.05.29 |
Metabase를 활용한 비즈니스 인사이트 도출하기: 데이터 시각화로 비즈니스 성장 가속화하기 (0) | 2025.05.26 |
Apache Superset으로 대시보드 시각화하기: 무료 BI 도구 완벽 가이드 (0) | 2025.05.25 |
CodeTour를 활용한 코드베이스 온보딩 가이드: 신입 개발자를 위한 완벽한 코드 투어 시스템 (0) | 2025.05.25 |