Hwahae Search Scraper 화해(Hwahae) 검색 결과에서 상품 정보를 수집하는 Apify Actor입니다. ## 주요 기능 - ✅ 검색 키워드 또는 URL 기반 상품 스크래핑 - ✅ 자동 페이지네이션 처리 - ✅ 중복 상품 자동 제거 - ✅ Apify Residential 프록시 지원 - ✅ 커스텀 프록시 지원 - ✅ 랜덤 딜레이로 안정적인 수집 ## 입력 파라미터 ### query (필수) - 타입: string - 기본값: 크림 - 설명: 검색 키워드 - 예시: 크림, 세럼, 화산 ### maxProducts (선택) - 타입: integer - 기본값: 100 - 설명: 최대 수집 상품 수 - 범위: 1 ~ 무제한 ### proxyUrl (선택) - 타입: string - 설명: 커스텀 프록시 URL (제공 시 Apify 프록시 대신 사용) - 예시: http://username:password@proxy.example.com:8080 ## 입력 예시 ### 기본 사용 json { "query": "크림", "maxProducts": 100 } ### 대량 수집 json { "query": "세럼", "maxProducts": 500 } ### 커스텀 프록시 사용 json { "query": "화산", "maxProducts": 200, "proxyUrl": "http://user:pass@proxy.example.com:8080" } ## 출력 필드 | 필드 | 타입 | 설명 | |------|------|------| | index | number | 수집 순서 | | store_name | string | 브랜드/스토어명 | | product_name | string | 상품명 | | original_price | string | 정상가 | | discount_price | string | 할인가 | | discount_rate | string | 할인율 | | rating | string | 평점 | | review_count | string | 리뷰 수 | | tags | array | 태그 배열 (only화해, 최저가, 무료배송, 1+1, 증정, 한정특가) | | shipping | string | 배송 정보 | | thumbnail_url | string | 썸네일 이미지 URL | | product_url | string | 상품 상세 페이지 URL | | goods_no | string | 상품 고유 번호 | | source_url | string | 수집된 검색 페이지 URL | ## 출력 예시 json { "index": 1, "store_name": "아누아", "product_name": "[only화해] 피디알엔 캡슐 100 세럼 50ml 대용량 기획(+크림 10ml)", "original_price": "59,900원", "discount_price": "23,500원", "discount_rate": "60%", "rating": "4.61", "review_count": "7,826", "tags": ["최저가", "only화해", "무료배송"], "shipping": "무료", "thumbnail_url": "https://img.hwahae.co.kr/commerce/goods/20251106_145443_thumb_...", "product_url": "https://www.hwahae.co.kr/goods/69360", "goods_no": "69360", "source_url": "https://www.hwahae.co.kr/search?q=%ED%81%AC%EB%A6%BC&type=goods" } ## 기술 스펙 - 프록시: Apify Residential Proxy (자동) - 중복 제거: goods_no 기반 Set 사용 - 딜레이: 500ms ~ 2000ms 랜덤 - 페이지네이션: offset 기반 (20개씩) ## 성능 - 속도: ~100개/분 - 안정성: 프록시 로테이션으로 차단 방지 - 정확도: 100% (API 직접 호출) ## 로컬 개발 bash # 설치 npm install # 개발 모드 실행 npm run start:dev # 빌드 npm run build # Apify 환경 테스트 apify run ## 배포 bash apify push ## 라이선스 MIT ## 지원 문의사항이나 버그 리포트는 이슈로 등록해주세요.