delivery-trackinglisted

# Delivery Tracking ## What this skill does CJ대한통운과 우체국 공식 조회 표면을 사용해 송장 번호로 현재 배송 상태를 조회한다. - **CJ대한통운**: 공식 배송조회 페이지가 노출하는 JSON endpoint 사용 - **우체국**: 공식 배송조회 페이지가 사용하는 HTML endpoint 사용 - 결과는 공통 포맷(택배사 / 송장번호 / 현재 상태 / 최근 이벤트들)으로 짧게 정리 ## When to use - "CJ대한통운 송장 조회해줘" - "우체국 택배 지금 어디야" - "이 송장번호 배송완료인지 확인해줘" - "택배사별 조회 로직을 나중에 더 붙일 수 있게 정리해줘" ## When not to use - 주문번호만 있고 송장번호가 없는 경우 - 택배 예약/반품 접수까지 바로 해야 하는 경우 - 비공식 통합 배송조회 서비스로 우회하고 싶은 경우 ## Prerequisites - 인터넷 연결 - `python3` - `curl` - 선택 사항: `jq` ## Inputs - 택배사 식별자: `cj` 또는 `epost` - 송장번호 - CJ대한통운: 숫자 10자리 또는 12자리 - 우체국: 숫자 13자리 ## Carrier adapter rule 이 스킬은 택배사별 로직을 **carrier adapter** 단위로 나눈다. 새 택배사를 붙일 때는 아래 필드를 먼저 정한다. - `carrier id`: 예) `cj`, `epost` - `validator`: 송장번호 자리수/패턴 - `entrypoint`: 공식 조회 진입 URL - `transport`: JSON API / HTML form / CLI 중 무엇을 쓰는지 - `parser`: 어떤 필드나 테이블에서 상태를 뽑는지 - `status map`: 각 택배사의 원본 상태 코드를 공통 상태로 어떻게 줄일지 - `retry policy`: timeout/retry 규칙 현재 어댑터는 아래 둘이다. | carrier adapter | official entry | transport | validator | parser focus | | --- | --- | --- | --- | --- | | `cj` | `https://www.cjlogistics.com/ko/tool/parcel/tracking` | page GET + `tracking-detail` POST JSON | 10자리 또는 12자리 숫자 | `parcelDetailResultMap.resultList` | | `epost` | `https://service.epost.go.kr/trace.RetrieveRegiPrclDeliv.postal?sid1=` | form POST HTML | 13자리 숫자 | 기본정보 `table_col` + 상세 `processTable` | ## Workflow ### 0. Normalize the input first - 택배사 이름을 `cj` / `epost` 둘 중 하나로 정규화한다. - 송장번호에서