solmate-skills 1.0.1 → 2.0.0

package/ext-k-skill/docs/features/delivery-tracking.md

@@ -0,0 +1,301 @@
+# 택배 배송조회 가이드
+
+## 이 기능으로 할 수 있는 일
+
+- CJ대한통운 송장 조회
+- 우체국 송장 조회
+- 현재 상태와 최근 이벤트 요약
+- 같은 스킬 안에서 택배사별 carrier adapter 규칙 유지
+
+## 먼저 필요한 것
+
+- 인터넷 연결
+- `python3`
+- `curl`
+
+별도 npm/Python 패키지 설치 없이 공식 endpoint 기준으로 바로 조회한다.
+
+## 입력값
+
+- 택배사: `cj` 또는 `epost`
+- 송장번호
+  - CJ대한통운: 숫자 10자리 또는 12자리
+  - 우체국: 숫자 13자리
+
+## 기본 흐름
+
+1. 택배사별 validator로 자리수를 먼저 확인한다.
+2. CJ는 공식 페이지에서 `_csrf` 를 읽은 뒤 `tracking-detail` JSON endpoint 로 조회한다.
+3. 우체국은 `sid1` 을 `trace.RetrieveDomRigiTraceList.comm` 에 POST해서 HTML 결과를 받는다.
+4. 결과를 공통 포맷으로 정리한다.
+5. 새 택배사를 붙일 때는 같은 carrier adapter 필드(validator / entrypoint / transport / parser / status map / retry policy)를 채운다.
+
+## CJ대한통운 예시
+
+- 진입 페이지: `https://www.cjlogistics.com/ko/tool/parcel/tracking`
+- 상세 endpoint: `https://www.cjlogistics.com/ko/tool/parcel/tracking-detail`
+- 파라미터: `_csrf`, `paramInvcNo`
+
+```bash
+tmp_body="$(mktemp)"
+tmp_cookie="$(mktemp)"
+tmp_json="$(mktemp)"
+invoice="1234567890"
+
+curl -sS -L -c "$tmp_cookie" \
+  "https://www.cjlogistics.com/ko/tool/parcel/tracking" \
+  -o "$tmp_body"
+
+csrf="$(python3 - <<'PY' "$tmp_body"
+import re
+import sys
+text = open(sys.argv[1], encoding="utf-8", errors="ignore").read()
+print(re.search(r'name="_csrf" value="([^"]+)"', text).group(1))
+PY
+)"
+
+curl -sS -L -b "$tmp_cookie" \
+  -H "Content-Type: application/x-www-form-urlencoded; charset=UTF-8" \
+  --data-urlencode "_csrf=$csrf" \
+  --data-urlencode "paramInvcNo=$invoice" \
+  "https://www.cjlogistics.com/ko/tool/parcel/tracking-detail" \
+  -o "$tmp_json"
+
+python3 - <<'PY' "$tmp_json"
+import json
+import sys
+
+status_map = {
+    "11": "상품인수",
+    "21": "상품이동중",
+    "41": "상품이동중",
+    "42": "배송지도착",
+    "44": "상품이동중",
+    "82": "배송출발",
+    "91": "배달완료",
+}
+
+payload = json.load(open(sys.argv[1], encoding="utf-8"))
+events = payload["parcelDetailResultMap"]["resultList"]
+if not events:
+    raise SystemExit("조회 결과가 없습니다.")
+
+latest = events[-1]
+normalized_events = [
+    {
+        "timestamp": event.get("dTime"),
+        "location": event.get("regBranNm"),
+        "status_code": event.get("crgSt"),
+        "status": status_map.get(event.get("crgSt"), event.get("scanNm") or "알수없음"),
+    }
+    for event in events
+]
+print(json.dumps({
+    "carrier": "cj",
+    "invoice": payload["parcelDetailResultMap"]["paramInvcNo"],
+    "status_code": latest.get("crgSt"),
+    "status": status_map.get(latest.get("crgSt"), latest.get("scanNm") or "알수없음"),
+    "timestamp": latest.get("dTime"),
+    "location": latest.get("regBranNm"),
+    "event_count": len(events),
+    "recent_events": normalized_events[-min(3, len(normalized_events)):],
+}, ensure_ascii=False, indent=2))
+PY
+
+rm -f "$tmp_body" "$tmp_cookie" "$tmp_json"
+```
+
+### CJ 공개 출력 예시
+
+아래 값은 2026-03-27 기준 live smoke test(`1234567890`)에서 확인한 정규화 결과다.
+
+```json
+{
+  "carrier": "cj",
+  "invoice": "1234567890",
+  "status_code": "91",
+  "status": "배달완료",
+  "timestamp": "2026-03-21 12:22:13",
+  "location": "경기광주오포",
+  "event_count": 3,
+  "recent_events": [
+    {
+      "timestamp": "2026-03-10 03:01:45",
+      "location": "청원HUB",
+      "status_code": "44",
+      "status": "상품이동중"
+    },
+    {
+      "timestamp": "2026-03-21 10:53:19",
+      "location": "경기광주오포",
+      "status_code": "82",
+      "status": "배송출발"
+    },
+    {
+      "timestamp": "2026-03-21 12:22:13",
+      "location": "경기광주오포",
+      "status_code": "91",
+      "status": "배달완료"
+    }
+  ]
+}
+```
+
+CJ는 JSON 응답이므로 `parcelDetailResultMap.resultList` 를 기준으로 상태를 읽는 편이 가장 안정적이다. 문서 예시는 공통 결과 스키마(`carrier`, `invoice`, `status`, `timestamp`, `location`, `event_count`, `recent_events`, 선택적 `status_code`)만 남기고, 담당자 이름이나 휴대폰 번호가 포함될 수 있는 `crgNm` 원문은 그대로 출력하지 않는다.
+
+## 우체국 예시
+
+- 진입 페이지: `https://service.epost.go.kr/trace.RetrieveRegiPrclDeliv.postal?sid1=`
+- 조회 endpoint: `https://service.epost.go.kr/trace.RetrieveDomRigiTraceList.comm`
+- 파라미터: `sid1`
+
+```bash
+tmp_html="$(mktemp)"
+python3 - <<'PY' "$tmp_html"
+import html
+import json
+import re
+import subprocess
+import sys
+
+invoice = "1234567890123"
+output_path = sys.argv[1]
+
+subprocess.run(
+    [
+        "curl",
+        "--http1.1",
+        "--tls-max",
+        "1.2",
+        "--silent",
+        "--show-error",
+        "--location",
+        "--retry",
+        "3",
+        "--retry-all-errors",
+        "--retry-delay",
+        "1",
+        "--max-time",
+        "30",
+        "-o",
+        output_path,
+        "-d",
+        f"sid1={invoice}",
+        "https://service.epost.go.kr/trace.RetrieveDomRigiTraceList.comm",
+    ],
+    check=True,
+)
+
+page = open(output_path, encoding="utf-8", errors="ignore").read()
+summary = re.search(
+    r"<th scope=\"row\">(?P<tracking>[^<]+)</th>.*?"
+    r"<td>(?P<sender>.*?)</td>.*?"
+    r"<td>(?P<receiver>.*?)</td>.*?"
+    r"<td>(?P<delivered_to>.*?)</td>.*?"
+    r"<td>(?P<kind>.*?)</td>.*?"
+    r"<td>(?P<result>.*?)</td>",
+    page,
+    re.S,
+)
+if not summary:
+    raise SystemExit("기본정보 테이블을 찾지 못했습니다.")
+
+def clean(raw: str) -> str:
+    return " ".join(html.unescape(re.sub(r"<[^>]+>", " ", raw)).split())
+
+def clean_location(raw: str) -> str:
+    text = clean(raw)
+    return re.sub(r"\s*(TEL\s*:?\s*)?\d{2,4}[.\-]\d{3,4}[.\-]\d{4}", "", text).strip()
+
+events = re.findall(
+    r"<tr>\s*<td>(\d{4}\.\d{2}\.\d{2})</td>\s*"
+    r"<td>(\d{2}:\d{2})</td>\s*"
+    r"<td>(.*?)</td>\s*"
+    r"<td>\s*<span class=\"evtnm\">(.*?)</span>(.*?)</td>\s*</tr>",
+    page,
+    re.S,
+)
+
+normalized_events = [
+    {
+        "timestamp": f"{day} {time_}",
+        "location": clean_location(location),
+        "status": clean(status),
+    }
+    for day, time_, location, status, _detail in events
+]
+
+latest_event = normalized_events[-1] if normalized_events else None
+
+print(json.dumps({
+    "carrier": "epost",
+    "invoice": clean(summary.group("tracking")),
+    "status": clean(summary.group("result")),
+    "timestamp": latest_event["timestamp"] if latest_event else None,
+    "location": latest_event["location"] if latest_event else None,
+    "event_count": len(normalized_events),
+    "recent_events": normalized_events[-min(3, len(normalized_events)):],
+}, ensure_ascii=False, indent=2))
+PY
+rm -f "$tmp_html"
+```
+
+### 우체국 공개 출력 예시
+
+아래 값은 2026-03-27 기준 live smoke test(`1234567890123`)에서 확인한 정규화 결과다.
+
+```json
+{
+  "carrier": "epost",
+  "invoice": "1234567890123",
+  "status": "배달완료",
+  "timestamp": "2025.12.04 15:13",
+  "location": "제주우편집중국",
+  "event_count": 2,
+  "recent_events": [
+    {
+      "timestamp": "2025.12.04 15:13",
+      "location": "제주우편집중국",
+      "status": "배달준비"
+    },
+    {
+      "timestamp": "2025.12.04 15:13",
+      "location": "제주우편집중국",
+      "status": "배달완료"
+    }
+  ]
+}
+```
+
+우체국은 HTML 응답이라 기본정보 `table_col` 과 상세 `processTable` 을 파싱해야 한다. 문서 예시는 CJ와 같은 공통 결과 스키마(`carrier`, `invoice`, `status`, `timestamp`, `location`, `event_count`, `recent_events`)만 남기고, 이벤트 location에 섞일 수 있는 `TEL` 번호 조각도 제거한 뒤 수령인/상세 메모 원문은 그대로 출력하지 않는다.
+
+## 결과 정리 기준
+
+### 공통 결과 스키마
+
+- `carrier`: 택배사 식별자 (`cj` 또는 `epost`)
+- `invoice`: 정규화된 송장번호
+- `status`: 현재 배송 상태
+- `timestamp`: 마지막 이벤트 시각
+- `location`: 마지막 이벤트 위치
+- `event_count`: 전체 이벤트 수
+- `recent_events`: 최근 최대 3개 이벤트 목록
+- `status_code`: 필요할 때만 남기는 원본 상태 코드 (현재는 CJ 예시에서만 사용)
+
+## 확장 규칙
+
+다른 택배사를 붙일 때는 새 carrier adapter에 아래만 먼저 정의한다.
+
+- validator
+- official entrypoint
+- transport(JSON / HTML / CLI)
+- parser
+- status map
+- retry policy
+
+## 주의할 점
+
+- CJ는 `_csrf` 없이 바로 `tracking-detail` 만 호출하지 않는다.
+- 우체국은 `curl --http1.1 --tls-max 1.2` 경로를 기본으로 유지한다.
+- 우체국은 JSON이 아니라 HTML 응답이므로 regex/HTML 정리에 대비해야 한다.
+- 비공식 통합 배송조회 서비스로 자동 우회하지 않는다.

package/ext-k-skill/docs/features/fine-dust-location.md

@@ -0,0 +1,128 @@
+# 사용자 위치 미세먼지 조회 가이드
+
+## 이 기능으로 할 수 있는 일
+
+- 지역명/행정구역 힌트로 측정소 후보 찾기
+- 단일 측정소 확정이 어려우면 후보 측정소 목록 반환
+- 정확한 측정소명으로 재조회
+- PM10, PM2.5, 등급, 조회 시각 요약
+
+## 먼저 필요한 것
+
+- [공통 설정 가이드](../setup.md) 완료
+- [보안/시크릿 정책](../security-and-secrets.md) 확인
+- `k-skill-proxy` 또는 에어코리아 OpenAPI key
+
+## 필요한 환경변수
+
+클라이언트 기본값:
+
+- 기본 external proxy URL: `https://k-skill-proxy.nomadamas.org`
+- `KSKILL_PROXY_BASE_URL` 는 override 가 필요할 때만 사용
+
+프록시 없이 direct fallback 으로 쓸 때만:
+
+- `AIR_KOREA_OPEN_API_KEY`
+
+### Credential resolution order
+
+1. **이미 환경변수에 있으면** 그대로 사용한다.
+2. **에이전트가 자체 secret vault(1Password CLI, Bitwarden CLI, macOS Keychain 등)를 사용 중이면** 거기서 꺼내 환경변수로 주입해도 된다.
+3. **`~/.config/k-skill/secrets.env`** (기본 fallback) — plain dotenv 파일, 퍼미션 `0600`.
+4. **아무것도 없으면** 유저에게 물어서 2 또는 3에 저장한다.
+
+## 입력값
+
+- 기본: 지역명/행정구역 힌트(`regionHint`)
+- 재조회: 정확한 측정소명(`stationName`)
+
+## 기본 흐름
+
+1. `KSKILL_PROXY_BASE_URL` 가 있으면 먼저 `k-skill-proxy` 의 `/v1/fine-dust/report` endpoint 를 호출합니다.
+2. `regionHint` 가 들어오면 프록시는 먼저 시도명을 추출하고, `getCtprvnRltmMesureDnsty` 로 해당 시도 측정소 목록을 확보합니다.
+3. region token 이 시도 내 실제 측정소명과 **유일하게** 대응하면 그 측정소로 `getMsrstnAcctoRltmMesureDnsty` 를 호출합니다.
+4. 단일 측정소 확정이 어려우면 `ambiguous_location` 과 `candidate_stations` 를 반환합니다.
+5. 클라이언트/사용자는 후보 중 정확한 측정소명으로 다시 `/v1/fine-dust/report?stationName=...` 를 호출합니다.
+6. PM10, PM2.5, 등급, 조회 시점/조회 시각을 함께 요약합니다.
+
+프록시 예시:
+
+```bash
+python3 scripts/fine_dust.py report --region-hint "서울 강남구" --json
+```
+
+후보 반환 예시:
+
+```bash
+curl -fsS --get 'https://k-skill-proxy.nomadamas.org/v1/fine-dust/report' \
+  --data-urlencode 'regionHint=광주 광산구'
+```
+
+정확한 측정소명 재조회:
+
+```bash
+curl -fsS --get 'https://k-skill-proxy.nomadamas.org/v1/fine-dust/report' \
+  --data-urlencode 'stationName=우산동(광주)'
+```
+
+원본 AirKorea endpoint 형태를 거의 그대로 쓰고 싶으면 passthrough endpoint 도 사용할 수 있습니다. 별도 client API 는 불필요하고, 프록시가 `serviceKey` 만 서버에서 주입합니다.
+
+```bash
+curl -fsS --get 'https://k-skill-proxy.nomadamas.org/B552584/ArpltnInforInqireSvc/getMsrstnAcctoRltmMesureDnsty' \
+  --data-urlencode 'returnType=json' \
+  --data-urlencode 'numOfRows=1' \
+  --data-urlencode 'pageNo=1' \
+  --data-urlencode 'stationName=강남구' \
+  --data-urlencode 'dataTerm=DAILY' \
+  --data-urlencode 'ver=1.4'
+```
+
+## 예시
+
+지역 기반 direct fallback:
+
+```bash
+curl -sG "http://apis.data.go.kr/B552584/MsrstnInfoInqireSvc/getMsrstnList" \
+  --data-urlencode "serviceKey=${AIR_KOREA_OPEN_API_KEY}" \
+  --data-urlencode "returnType=json" \
+  --data-urlencode "numOfRows=50" \
+  --data-urlencode "pageNo=1" \
+  --data-urlencode "addr=서울 강남구"
+```
+
+실시간 측정값:
+
+```bash
+curl -sG "http://apis.data.go.kr/B552584/ArpltnInforInqireSvc/getMsrstnAcctoRltmMesureDnsty" \
+  --data-urlencode "serviceKey=${AIR_KOREA_OPEN_API_KEY}" \
+  --data-urlencode "returnType=json" \
+  --data-urlencode "numOfRows=100" \
+  --data-urlencode "pageNo=1" \
+  --data-urlencode "stationName=중구" \
+  --data-urlencode "dataTerm=DAILY" \
+  --data-urlencode "ver=1.4"
+```
+
+helper script 반복 검증:
+
+```bash
+python3 scripts/fine_dust.py report \
+  --station-file scripts/fixtures/fine-dust-stations.json \
+  --measurement-file scripts/fixtures/fine-dust-measurements.json \
+  --region-hint "서울 강남구"
+```
+
+## fallback / 대체 흐름
+
+- 지역명/행정구역을 먼저 받습니다
+- 단일 측정소를 확정하지 못하면 후보 측정소 목록을 돌려줍니다
+- 사용자는 후보 중 하나를 선택해 `stationName` 으로 다시 조회합니다
+- 측정소 목록 API가 403 이어도 `getCtprvnRltmMesureDnsty` 와 측정소별 실측 API 조합으로 우회합니다
+
+## 주의할 점
+
+- 실시간 수치라 조회 시각을 같이 적어야 합니다
+- PM10/PM2.5 값이 `-` 이거나 비정상이면 등급도 함께 재확인합니다
+- API 가 `khaiGrade` 를 비워 보내면 통합대기등급은 `정보없음` 으로 표시합니다
+- regionHint 는 자연어이므로 단일 측정소가 안 잡히는 경우가 자주 있습니다
+- hosted 모드에서는 upstream AirKorea key 를 클라이언트에 배포하지 않고 proxy 에만 둡니다

package/ext-k-skill/docs/features/hwp.md

@@ -0,0 +1,105 @@
+# HWP 문서 처리 가이드
+
+## 이 기능으로 할 수 있는 일
+
+- `.hwp` 문서를 JSON, Markdown, HTML로 변환
+- 문서 안 이미지를 추출
+- 폴더 단위 배치 처리
+- Windows + 한글 프로그램 설치 환경에서는 직접 문서 조작까지 확장
+
+## 먼저 필요한 것
+
+- 기본 경로: Node.js 18+
+- 기본 패키지: `npm install -g @ohah/hwpjs`
+- 실행 전: `export NODE_PATH="$(npm root -g)"`
+- 직접 제어가 필요할 때만: Windows + 한글(HWP) 프로그램 설치 + Python 3.7+
+
+## 어떤 경로를 선택하나
+
+### 기본값: `@ohah/hwpjs`
+
+다음 상황에서는 `@ohah/hwpjs`를 사용한다.
+
+- macOS / Linux / CI
+- 읽기, 변환, 이미지 추출, 배치 처리
+- Windows여도 한글 프로그램 설치/연동을 확신할 수 없음
+
+### 예외 경로: `hwp-mcp`
+
+다음 조건을 모두 만족할 때만 `hwp-mcp`를 사용한다.
+
+- Windows
+- 한글(HWP) 프로그램이 실제 설치되어 있음
+- 문서 생성, 텍스트 삽입, 표 채우기처럼 실행 중인 한글 직접 제어가 필요함
+
+즉, **변환은 `@ohah/hwpjs`, 직접 조작은 `hwp-mcp`** 가 기본 규칙이다.
+
+## 기본 흐름
+
+1. `node -p "process.platform"` 으로 운영체제를 확인한다.
+2. `win32` 가 아니면 `@ohah/hwpjs`를 사용한다.
+3. `win32` 여도 직접 제어 요건이 분명하지 않으면 `@ohah/hwpjs`를 사용한다.
+4. 직접 조작이 필요하고 한글 설치가 확인되면 `hwp-mcp`를 선택한다.
+5. 결과 파일 생성 여부와 출력 내용을 확인한다.
+
+## 예시
+
+### JSON 변환
+
+```bash
+hwpjs to-json document.hwp -o output.json --pretty
+```
+
+### Markdown 변환 + 이미지 포함
+
+```bash
+hwpjs to-markdown document.hwp -o output.md --include-images
+```
+
+`--include-images` 는 이미지 파일 경로를 따로 만드는 대신 Markdown 안에 base64 `data:` URI로 포함한다.
+
+### HTML 변환
+
+```bash
+hwpjs to-html document.hwp -o output.html
+```
+
+### 이미지 추출
+
+```bash
+hwpjs extract-images document.hwp -o ./images
+```
+
+### 배치 처리
+
+```bash
+hwpjs batch ./documents -o ./output --format json --recursive
+```
+
+## 결과 확인 포인트
+
+- JSON 출력: 파일 생성 여부와 최상위 구조를 확인한다.
+- Markdown 출력: `--include-images` 를 썼다면 이미지 파일 경로가 따로 생기지 않아도 정상이며, Markdown 안 `data:` URI / base64 인라인 포함 여부를 확인한다.
+- HTML 출력: 파일 생성 뒤 브라우저에서 열리는지 확인한다.
+- 이미지 추출: 출력 디렉터리에 실제 이미지 파일이 생겼는지 확인한다.
+- 배치 처리: 입력 개수와 출력 개수가 크게 어긋나지 않는지 확인한다.
+
+이미지를 별도 파일로 떨궈야 한다면 `--include-images` 대신 `--images-dir` 경로를 쓴다.
+
+## 직접 제어가 필요한 경우
+
+`hwp-mcp`는 Windows + 한글 프로그램 설치 환경에서만 고려한다.
+
+```bash
+git clone https://github.com/jkf87/hwp-mcp.git
+cd hwp-mcp
+pip install -r requirements.txt
+```
+
+그 뒤 MCP 서버로 연결해 새 문서 생성, 텍스트 삽입, 표 작성, 저장 같은 작업을 수행한다.
+
+## 주의할 점
+
+- `hwp-mcp`를 Linux/macOS에서 우회 실행하려 하지 않는다.
+- 직접 제어 필요성이 약하면 `@ohah/hwpjs`로 바로 끝내는 편이 더 안정적이다.
+- 배치 작업 후에는 입력 개수와 출력 개수를 같이 확인한다.

package/ext-k-skill/docs/features/k-skill-proxy.md

@@ -0,0 +1,82 @@
+# k-skill 프록시 서버 가이드
+
+## 이 기능으로 할 수 있는 일
+
+- AirKorea 같은 무료/공공 API key를 서버에만 보관
+- `k-skill` 클라이언트는 프록시만 호출
+- 캐시, 인증, rate limit, 로깅을 한곳에서 통제
+
+## 기본 구조
+
+```text
+client/skill -> k-skill-proxy -> upstream public API
+```
+
+현재 기본 엔드포인트는 아래 둘입니다.
+
+- `GET /health`
+- `GET /v1/fine-dust/report`
+- `GET /v1/seoul-subway/arrival`
+- `GET /B552584/:service/:operation` (허용된 AirKorea route passthrough)
+
+## 권장 환경변수
+
+클라이언트(스킬) 쪽:
+
+- `KSKILL_PROXY_BASE_URL=https://your-proxy.example.com`
+
+프록시 서버 쪽:
+
+- `AIR_KOREA_OPEN_API_KEY=...`
+- `SEOUL_OPEN_API_KEY=...`
+- `KSKILL_PROXY_PORT=4020`
+
+## PM2 + cloudflared
+
+1. `pm2 start ecosystem.config.cjs`
+2. `pm2 save`
+3. `pm2 startup` 출력대로 launchd 등록
+4. Cloudflare Tunnel ingress 에 `k-skill-proxy.nomadamas.org -> http://localhost:4020` 추가
+
+## 기본 공개 정책
+
+- 이 프록시는 **무료 API만** 붙인다.
+- 기본값은 **무인증 공개 endpoint** 다.
+- 대신 read-only / allowlisted endpoint / cache / rate limit 을 유지한다.
+- 문제가 생기면 그때 인증이나 더 강한 방어를 덧붙인다.
+
+## 사용법
+
+추가 client API 레이어는 불필요합니다. 필요한 쿼리를 그대로 프록시에 넣으면 되고, 프록시가 upstream API key 만 서버에서 주입합니다.
+
+요약 endpoint:
+
+```bash
+curl -fsS --get 'https://k-skill-proxy.nomadamas.org/v1/fine-dust/report' \
+  --data-urlencode 'regionHint=서울 강남구'
+```
+
+서울 지하철 도착정보 endpoint:
+
+```bash
+curl -fsS --get 'http://127.0.0.1:4020/v1/seoul-subway/arrival' \
+  --data-urlencode 'stationName=강남'
+```
+
+AirKorea passthrough endpoint:
+
+```bash
+curl -fsS --get 'https://k-skill-proxy.nomadamas.org/B552584/ArpltnInforInqireSvc/getMsrstnAcctoRltmMesureDnsty' \
+  --data-urlencode 'returnType=json' \
+  --data-urlencode 'numOfRows=1' \
+  --data-urlencode 'pageNo=1' \
+  --data-urlencode 'stationName=강남구' \
+  --data-urlencode 'dataTerm=DAILY' \
+  --data-urlencode 'ver=1.4'
+```
+
+## 주의할 점
+
+- upstream key는 프록시 서버에서만 관리합니다.
+- client 쪽에는 upstream API key를 배포하지 않습니다.
+- public hosted route rollout 이 끝나기 전에는 서울 지하철 예시를 local/self-host URL 로 검증합니다.