자동매칭엔진 | 오즈키즈 CS 모니터

💡 알림: 자동매칭엔진은 본인 PC에서 실행됩니다. 최초 설치가 필요해요. 운영가이드 보기 →

총 자동매칭

0

데이터 로딩 중...

절약된 시간

0h

건당 25초 절약

매칭 정확도

-%

전체 중 자동매칭 비율

API 비용

$0

이번 달 누적 추정

⚡ 빠른 시작 (5분 설치)

⚠️ 처음 사용자용 안내
이 프로그램은 회사 내부용입니다.
사용하려면 관리자로부터 GitHub 저장소 초대를 받아야 합니다.

📩 초대 요청 방법:
1. GitHub 계정 (없으면 github.com 에서 무료 가입)
2. 가입 후 관리자에게 GitHub 아이디와 함께 초대 요청
3. 초대 이메일 확인 후 수락
4. 아래 다운로드 진행

📞 초대 문의: chloe@openhan.kr

📥 매칭엔진 다운로드 (23MB)

사전 준비: Python 3.11+ 설치 (python.org) + GitHub 계정
"Add Python to PATH" 반드시 체크!
관리자에게 초대 요청 (또는 초대 메일 수락)
위 버튼 클릭 → GitHub 로그인 후 zip 다운로드
영문 경로에 압축 풀기 (예: C:\ezadmin-agent)
⚠️ 한글 경로 사용 불가!
설치.bat 더블클릭
완료! 매칭 아이콘 클릭

🔑 회사 공용 API 키가 이미 포함되어 있어서 별도 API 키 발급 불필요합니다.

⏰ 예약 실행 (선택)

원하는 시간에 자동 매칭이 실행되도록 예약할 수 있어요!

사용법

ezadmin-agent 폴더의 스케줄설정.bat 더블클릭
메뉴에서 매일 실행 또는 오늘 한 번만 선택
시간 입력 (예: 14:30 = 오후 2시 30분)
완료! 지정 시간에 자동 실행됩니다.

활용 예시

매일 오후 2:30 자동 매칭
매일 오전 9시 출근 전 매칭
오늘 오후 6시 한 번만 실행

⚠️ 컴퓨터가 켜져있어야 실행됩니다.

🎯 주요 기능

AI 매칭 (Claude) - 정확한 SKU 자동 매칭
STRICT 모드 - 색상/사이즈 검증 실패 시 안전상 건너뜀
자동 세션 관리 - 세션 만료 시 자동 안내
5단계 검색 폴백 - 상품명/옵션/SKU 코드 등
대괄호 자동 제거 - 태그/출고일 무시
리퍼브 회피 - 명시 없으면 일반 상품 선택
Supabase 클라우드 저장 - 매칭 이력 자동 누적 ✨ NEW

⚠️ 안내: 웹에서 직접 매칭 실행 기능은 추후 추가 예정입니다. 현재는 본인 PC에서 python automate_match.py 직접 실행해주세요.

🚀 매칭 실행 (개발 예정)

🔧

개발 진행 중

웹에서 매칭 실행 기능은 추후 제공될 예정이에요.

지금은 본인 PC 에서 python automate_match.py 명령으로 실행해주세요.

📚 운영가이드 보기

💡 안내: Supabase 클라우드에서 자동 동기화되어 표시됩니다. 매칭 후 새로고침하세요.

자동매칭

0

성공한 건

UNSURE

0

사람 검토 필요

SKIPPED

0

검증 실패

총 처리

0

이번 달 누적

📋 최근 매칭 이력

데이터 불러오는 중...

1. 개요

이지어드민의 미매칭 주문을 AI(Claude)가 자동으로 우리 회사 SKU에 매칭해주는 도구입니다.

왜 필요한가?

하루 수십~수백 건의 매칭 작업을 사람이 직접 진행 → 시간 소요 큼
비슷한 상품명/옵션이 많아 헷갈리는 케이스 빈번
반복 작업이라 집중력 저하

2. 설치 방법

Step 1: Python 3.11+ 설치 (사전 준비)

python.org에서 Python 3.11 이상을 설치하고, 설치 시 "Add Python to PATH"를 체크하세요.

Step 2: 위 링크로 zip 다운로드

https://github.com/chloe557/ezadmin-auto-matching/releases/latest/download/ezadmin-agent.zip

Step 3: 압축 풀기

다운로드한 ezadmin-agent.zip 파일을 원하는 폴더에 압축 해제하세요.

Step 4: 설치.bat 더블클릭 (자동 설치)

압축을 푼 폴더에서 설치.bat를 더블클릭하면 필요한 설치가 자동으로 진행됩니다.

Step 5: API 키 입력 → 완료!

설치 과정에서 API 키를 입력하면 설정이 완료됩니다.

3. 최초 1회 설정

이지어드민에서 상품목록 엑셀 다운로드 → sku_master.xls
python prepare_sku.py
python build_vectordb.py (10~15분)

4. 매일 사용법

python automate_match.py

세션 유효하면 → 바로 매칭 시작
세션 만료면 → 자동 로그인 안내
매칭 자동 진행 → CSV + Supabase 자동 저장

5. 결과 확인

이 페이지의 "매칭 히스토리" 탭에서 모든 매칭 이력 확인 가능 (자동 동기화)

6. 트러블슈팅

❌ mysqli 데이터베이스에 연결할 수 없습니다

세션 만료. 자동 안내대로 재로그인.

❌ invalid x-api-key

Anthropic API 키 문제. .env 첫 줄 확인 후 새 키 발급.

❌ UNSURE 가 너무 많음

SKU 마스터에 해당 상품이 없을 가능성. 새 상품 등록 후 벡터DB 재구축.

7. FAQ

Q. 다른 사람도 쓸 수 있나요?

A. 네! 각자 본인 API 키, 이지어드민 계정, SKU 마스터만 있으면 됩니다.

Q. 한 번에 몇 건까지?

A. 제한 없음. 100건 약 5~10분.

🤖 자동매칭엔진