~/ecommerce/shopify-scraper
Shopify Scraper — 모든 스토어의 상품 데이터
컬렉션, 검색, 상품 추천까지 포함해 Shopify 기반 스토어라면 어디서든 고정밀 상품 데이터를 추출하는 프로페셔널급 도구입니다.
일반
TypeScriptCheerio
글로벌
카테고리ecommerce / 일반
언어TypeScript
스택TypeScript, Cheerio
마켓글로벌
출력클린한 RAG-레디 JSON
주요 기능
범용 — Shopify 기반이라면 어떤 스토어에도 동작
스토어 전체 카탈로그 추출 및 검색 지원
상품 추천(상품당 최대 20개)
컬렉션 및 개별 상품 크롤링
태그 및 카테고리 추출
정밀도를 위한 통화 정규화(가격 x100)
변형별 실재고 수량 (선택 기능)
판매 플랜, 구독, 제품 동영상
바코드/GTIN, 무게, B2B 수량 할인가
활용 사례
- 모든 틈새시장의 Shopify 스토어를 대상으로 한 시장 조사
- DTC 브랜드를 위한 경쟁사 분석
- 비교 플랫폼을 위한 상품 카탈로그 통합
- 독립 이커머스 스토어 전반의 트렌드 모니터링
- 상품 추천 데이터셋 구축
- 리셀러를 위한 가격 모니터링
입력 파라미터
| 파라미터 | 타입 | 필수 | 설명 |
|---|---|---|---|
startUrls | array | 필수 | Shopify 스토어 URL — 상품, 컬렉션, 또는 스토어 홈 |
query | string | 선택 | 스토어 내 상품을 찾기 위한 검색어 |
maxRequestsPerCrawl | number | 선택 | 요청 상한 (기본값: 100, 0 = 무제한) |
maxResults | number | 선택 | 이 수량만큼 수집 후 중지 (기본값: 0, 무제한) |
maxRecommendationsPerProduct | number | 선택 | 가져올 추천 상품 수(기본값: 0, 최대: 20) |
grabRealInventory | boolean | 선택 | 스토어가 재고를 공개하는 경우 변형별 실재고를 읽습니다 |
maxInventoryFetches | number | 선택 | 실행당 재고 조회 상한 (기본값: 200) |
grabStorefrontDetail | boolean | 선택 | 판매 플랜, 동영상, B2B 수량 할인가를 가져옵니다 |
maxStorefrontFetches | number | 선택 | 실행당 스토어프론트 상세 조회 상한 (기본값: 200) |
proxy | object | 선택 | 최상의 결과를 위해 레지덴셜 프록시 권장 |
출력 예시
1{
2 "source": {
3 "id": "8286776623232",
4 "canonicalUrl": "https://kith.com/products/khm034601-004",
5 "retailer": "Kith",
6 "language": "en",
7 "currency": "USD"
8 },
9 "brand": "Kith",
10 "title": "Kith Garment-Dyed Paneled Donovan Tee - Shadow",
11 "description": "<p>Moisture-wicking recycled polyester</p><p>Garment-dyed</p><p>Ribbed neckline</p>…",
12 "categories": ["Long Sleeve Tees"],
13 "tags": ["apparel", "k-tech", "…"],
14 "options": [
15 {
16 "type": "Size",
17 "values": [
18 { "id": "XS", "name": "XS" },
19 { "id": "S", "name": "S" }
20 ]
21 }
22 ],
23 "variants": [
24 {
25 "id": "45144565416064",
26 "title": "XS",
27 "sku": "2000292008",
28 "options": ["XS"],
29 "price": { "current": 13000, "previous": 0, "stockStatus": "InStock" },
30 "requiresShipping": true,
31 "taxable": true,
32 "weightGrams": 381
33 }
34 ],
35 "medias": [
36 { "id": "41607480410240", "type": "Image", "url": "https://cdn.shopify.com/s/files/1/0094/2252/files/KHM034601-004-Detail.jpg?v=1789500153", "variantIds": [], "alt": "" }
37 ]
38}
자주 묻는 질문
이 스크래퍼는 아무 Shopify 스토어에나 동작하나요?
네, Shopify 기반이라면 어떤 스토어에도 동작합니다. 모든 스토어에서 일관된 Shopify의 표준 상품 데이터 구조를 활용합니다.
특정 상품을 검색할 수 있나요?
네, query 파라미터를 사용해 특정 스토어 내에서 검색할 수 있습니다. 전체 카탈로그를 크롤링하지 않고 특정 상품 유형을 찾을 때 유용합니다.
상품 추천은 어떻게 추출되나요?
maxRecommendationsPerProduct를 설정하면 관련 상품을 가져옵니다. 상품당 최대 20개의 추천을 이용할 수 있으며, 상품 그래프를 구축할 때 유용합니다.