HanPick

HanPick은 AI 기반 드랍쉬핑 자동화 플랫폼입니다. 도매몰 상품을 쉽고 빠르게 쿠팡에 등록하고, 인공지능으로 상품 소싱·재고·가격 관리를 자동화할 수 있습니다. 재고 부담 없이 누구나 온라인 판매를 시작할 수 있도록 지원합니다.

# HanPick (한픽) 쿠팡 상품관리 크롬 확장 프로그램 ## 소개 **HanPick(한픽) Chrome Extension**은 쿠팡 셀러를 위한 올인원 상품 관리 도구입니다. 쿠팡 스토어 프로필 관리, 상품 정보 자동 추출, AI 기반 상품명 변환, 카테고리 자동검색, 이미지 업로드, 옵션/속성 관리, 그리고 쿠팡 API 연동 상품 업로드까지, 쿠팡 판매에 필요한 모든 과정을 한 번에 처리할 수 있습니다. > **한픽은 쿠팡 셀러의 반복적이고 번거로운 상품 등록/관리 업무를 혁신적으로 자동화합니다.** --- ## 주요 기능 ### 1. 쿠팡 스토어 프로필 관리 - 여러 개의 쿠팡 스토어(wingAccount, vendorCode, accessKey, secretKey 등) 프로필을 한 번에 관리 - hanpick.kr 서버와 연동하여 안전하게 저장 및 불러오기 - 기본 프로필 지정, 상세 정보(반품지/출고지 등) 확인 ### 2. 상품 정보 자동 추출 및 업로드 - 현재 보고 있는 상품 페이지(도매꾹 등)에서 HTML을 추출하여 서버로 전송, 상품 정보 자동 분석 - 상품명, 브랜드, 옵션, 이미지, 상세 설명 등 자동 파싱 및 폼 자동 채움 - 업로드 이력(file_info) 관리 및 JSON 변환 시 포함 ### 3. AI 기반 상품명 변환/검색 태그 생성 - AI 상품명 변환: 노출 상품명을 한글/키워드 최적화로 자동 변환 - AI 검색 태그 생성: 상품명/카테고리/설명 기반으로 검색 태그 자동 추천 ### 4. 카테고리 자동검색 및 메타정보 조회 - 쿠팡 API와 연동하여 상품명 기반 카테고리 자동 추천 - 카테고리별 필수/선택 속성(옵션) 자동 안내 및 입력 지원 ### 5. 옵션/속성/이미지/공지사항/상세 컨텐츠 관리 - 옵션별 가격, 바코드, 모델명, 속성, 이미지, 공지사항, 상세 컨텐츠(이미지/텍스트/HTML) 등 세부 정보 입력 및 관리 - 옵션별 속성값 실시간 미리보기 및 JSON 프리뷰 제공 - 이미지 드래그앤드롭 업로드, 순서 변경, 삭제 지원 ### 6. 쿠팡 상품 업로드 자동화 - 쿠팡 API(HMAC 인증) 연동으로 상품을 한 번에 업로드 - 업로드 시 프로필의 accessKey/secretKey 자동 매핑, JWT 인증 - 업로드 성공 시 DB에 이력 저장, 실패 시 상세 에러 안내 ### 7. UI/UX 특징 - SidePanel(메인)과 Settings(설정) UI 일관성 유지 - 카드형 리스트, 모달, 드롭다운, 뱃지, 포인트 컬러 등 현대적 디자인 - 입력값 자동 상태 표시(필수/공백/완료), 실시간 미리보기 - 반응형 레이아웃, 다크모드 지원(예정) --- ## 사용법 ### 1. 설치 및 로그인 1. 크롬 웹스토어에서 "HanPick" 확장 설치 2. 확장 실행 후 Google 계정으로 로그인(최초 1회) 3. hanpick.kr 서버와 연동되어 JWT 토큰 발급 및 자동 인증 ### 2. 쿠팡 스토어 프로필 연동 - Settings(설정)에서 쿠팡 스토어(wingAccount, vendorCode, accessKey, secretKey 등) 등록 - 기본 프로필 지정, 상세 정보(반품지/출고지 등) 확인 ### 3. 상품 정보 추출 및 업로드 1. 상품 페이지(예: 도매꾹)에서 "Upload Current Page to Hanpick" 클릭 2. 서버에서 HTML 분석 후 상품 정보 자동 추출 및 폼 자동 채움 3. 옵션/이미지/속성 등 추가 입력 및 수정 4. "JSON 변환" 클릭 → 최종 업로드 데이터 미리보기 5. "최종제출" 클릭 → 쿠팡 API로 상품 업로드 ### 4. 카테고리 자동검색/메타정보 - 상품명 입력 후 "자동검색" 클릭 → 카테고리 코드/명 자동 입력 - "카테고리 메타정보 조회"로 필수/선택 속성 확인 및 입력 ### 5. 기타 기능 - AI 상품명 변환, AI 검색 태그 자동 생성, 이미지 업로드, 옵션 추가/삭제 등 다양한 부가 기능 제공 --- ## 보안 및 개인정보 - 모든 프로필 정보는 hanpick.kr 서버에 암호화 저장 - 개인정보/프로필/상품 데이터는 외부에 노출되지 않으며, 사용자의 명시적 요청 시에만 서버로 전송 --- ## FAQ **Q. 쿠팡 계정 여러 개를 한 번에 관리할 수 있나요?** A. 네, 여러 개의 스토어 프로필을 등록/전환/삭제할 수 있습니다. **Q. 상품 정보 추출이 안 되거나, 옵션이 잘못 나올 때는?** A. 업로드 이력(file_info)와 함께 서버로 문의해 주세요. HTML 구조가 바뀐 경우 신속히 대응합니다. **Q. 쿠팡 API 연동은 안전한가요?** A. 모든 인증키는 암호화되어 저장되며, 업로드 시에만 일회성으로 사용됩니다. **Q. 상품 업로드 후 쿠팡에서 바로 판매가 시작되나요?** A. "자동승인요청여부"를 true로 설정하면 자동 승인 요청까지 진행됩니다. **Q. 확장 프로그램이 느리거나 오류가 날 때는?** A. 크롬 새로고침, 로그아웃 후 재로그인, 또는 최신 버전 업데이트를 권장합니다. --- ## 기술 스택 및 오픈소스 - **프론트엔드**: React, TypeScript, Tailwind CSS, Chrome Extension API - **AI/ML**: OpenAI, HuggingFace, 자체 한글 상품명/태그 모델 - **기타**: Vercel, AWS, Github Actions, Sentry 등 --- ## 업데이트 내역 - 2024.06: 쿠팡 API 연동 상품 업로드, 프로필 서버 연동, 자동 카테고리, AI 기능 추가 - 2024.05: UI/UX 리뉴얼, SidePanel/Settings 통합, 이미지 업로드 개선 - 2024.04: 한픽 확장 프로그램 베타 오픈 --- ## 향후 계획 - 다중 상품 일괄 등록, 템플릿 저장/불러오기, 더 많은 마켓 연동(스마트스토어 등) - 다크모드, 모바일 대응, 사용자별 맞춤 추천 기능 - 실시간 재고/주문 관리, 통계/분석 대시보드 --- ## 문의 및 지원 - 공식 사이트: [https://hanpick.kr](https://hanpick.kr) - 고객센터: hsm6911@gmail.com --- **HanPick(한픽)과 함께 쿠팡 셀러의 업무를 혁신하세요!** --- ## 크롬 웹스토어 개인정보 보호 관행 및 권한 설명 ### 단일 목적에 관한 설명 HanPick(한픽) Chrome Extension은 쿠팡 셀러의 상품 등록 및 관리를 자동화하기 위한 도구입니다. 사용자는 쿠팡 스토어 프로필을 안전하게 관리하고, 상품 정보를 자동으로 추출·가공하여 쿠팡에 업로드할 수 있습니다. 본 확장은 오직 쿠팡 상품 관리 자동화라는 단일 목적을 위해 동작합니다. ### 원격 코드 사용 요청 사유 HanPick 확장은 최신 상품 정보 추출 및 AI 기능(상품명 변환, 태그 생성 등)을 위해 hanpick.kr 서버의 API를 호출합니다. 이 과정에서 서버에서 최신 분석 로직을 제공받아, 사용자가 별도 업데이트 없이 항상 최신 기능을 사용할 수 있도록 합니다. 원격 코드는 확장 프로그램의 기능 개선 및 보안 패치, AI 기능 제공을 위해서만 사용됩니다. ### 데이터 사용 인증(정책 준수) HanPick 확장은 Google OAuth2 인증, JWT 토큰, 쿠팡 API 인증 등 모든 데이터 처리 과정에서 개발자 프로그램 정책을 준수합니다. 사용자 데이터(프로필, 상품 정보 등)는 암호화되어 안전하게 처리되며, 사용자의 명시적 동의 없이 외부로 전송되지 않습니다. ### 연락 가능한 이메일 주소 - support@hanpick.kr (계정 탭에서 입력 및 인증 필요) ### 권한별 사용 목적 - **호스트 권한 (host permissions)**: 상품 정보 추출 및 자동 입력을 위해 사용자가 방문하는 쇼핑몰(예: 도매꾹, 쿠팡 등) 페이지의 HTML 구조를 읽어옵니다. 이 정보는 오직 상품 정보 자동 추출 및 업로드 기능에만 사용됩니다. - **activeTab 권한**: 사용자가 현재 보고 있는 탭의 상품 정보를 추출하여 자동으로 폼에 입력하기 위해 필요합니다. 이 권한은 사용자가 명시적으로 확장 기능을 실행할 때만 일시적으로 활성화됩니다. - **identity 권한**: Google 계정으로 안전하게 로그인하고, 사용자 인증(JWT 발급)을 위해 필요합니다. 이 권한은 hanpick.kr 서버와의 인증 및 사용자 식별에만 사용됩니다. - **scripting 권한**: 상품 정보 추출을 위해 현재 탭의 HTML을 읽거나, DOM에 접근하여 데이터를 수집할 때 필요합니다. 이 권한은 오직 상품 정보 자동 추출 기능에만 사용됩니다. - **sidePanel 권한**: 확장 프로그램의 UI(사이드패널)를 통해 상품 정보 입력, 옵션 관리, 업로드 등 주요 기능을 제공하기 위해 필요합니다. 이 권한은 사용자 경험 개선 및 주요 기능 제공에만 사용됩니다. - **storage 권한**: 사용자의 설정, 임시 데이터, 프로필 정보 등을 로컬에 안전하게 저장하고 불러오기 위해 필요합니다. 이 권한은 사용자의 편의성과 데이터 보존을 위해서만 사용됩니다.