@nomadamas/k-skill 0.1.0

package/skills/ticket-availability/scripts/ticket_availability.py

@@ -0,0 +1,430 @@
+#!/usr/bin/env python3
+"""ticket-availability — YES24 / 인터파크 공연 일정 + 잔여석 조회 CLI.
+
+조회 전용. 예매·결제·로그인 자동화 없음.
+공연법 §4조의2 (매크로 입장권 부정구매·판매 금지) 비적용.
+
+Usage:
+    ticket-availability schedule <url>
+    ticket-availability seats <url> [--all-dates]
+    ticket-availability health
+
+Supported URLs:
+    YES24:    https://ticket.yes24.com/Perf/<perf_id>
+              https://ticket.yes24.com/New/Perf/Detail/View/<perf_id>
+              yes24:<perf_id>
+    인터파크: https://tickets.interpark.com/goods/<goods_code>
+              interpark:<goods_code>
+"""
+from __future__ import annotations
+
+import argparse
+import json
+import re
+import sys
+import time
+from datetime import datetime
+from typing import Any
+
+try:
+    import httpx
+except ModuleNotFoundError:  # pragma: no cover - depends on user environment
+    httpx = None
+
+
+class MissingHttpxError(RuntimeError):
+    """Raised when the optional httpx runtime dependency is unavailable."""
+
+
+def _require_httpx():
+    if httpx is None:
+        raise MissingHttpxError(
+            "Python package 'httpx' is required. Install it with: python3 -m pip install httpx"
+        )
+    return httpx
+
+
+HTTPX_HTTP_ERROR = (
+    getattr(httpx, "HTTPError", MissingHttpxError) if httpx else MissingHttpxError
+)
+
+# ── URL Parsing ───────────────────────────────────────────────────────────────
+
+
+def parse_url(url: str) -> tuple[str, str]:
+    """Return (platform, id). Accepts full URL or `platform:id` shorthand."""
+    if url.startswith("yes24:"):
+        return "yes24", url[6:]
+    if url.startswith("interpark:"):
+        return "interpark", url[10:]
+
+    m = re.search(
+        r"yes24\.com/(?:[Nn]ew/)?[Pp]erf/(?:[Dd]etail/)?(?:[Vv]iew/)?(\d+)", url
+    )
+    if m:
+        return "yes24", m.group(1)
+
+    m = re.search(r"interpark\.com/goods/(\d+)", url, re.IGNORECASE)
+    if m:
+        return "interpark", m.group(1)
+
+    if re.fullmatch(r"\d+", url):
+        raise ValueError(
+            f"플랫폼을 명시하세요: yes24:{url} 또는 interpark:{url}"
+        )
+
+    raise ValueError(f"URL을 인식할 수 없습니다: {url}")
+
+
+def _fmt_date(d: str) -> str:
+    if d and len(d) == 8 and d.isdigit():
+        return f"{d[:4]}-{d[4:6]}-{d[6:]}"
+    return d
+
+
+def _fmt_time(t: str) -> str:
+    if t and len(t) == 4 and t.isdigit():
+        return f"{t[:2]}:{t[2:]}"
+    return t
+
+
+# ── HTTP Setup ────────────────────────────────────────────────────────────────
+
+UA = (
+    "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 "
+    "Chrome/124.0.0.0 Safari/537.36"
+)
+
+HEADERS_YES24 = {
+    "User-Agent": UA,
+    "Referer": "https://ticket.yes24.com/",
+    "Content-Type": "application/x-www-form-urlencoded",
+    "Accept": "*/*",
+    "X-Requested-With": "XMLHttpRequest",
+}
+
+HEADERS_INTERPARK = {
+    "User-Agent": UA,
+    "Referer": "https://tickets.interpark.com/",
+    "Accept": "application/json",
+}
+
+YES24_BASE = "https://ticket.yes24.com"
+INTERPARK_BASE = "https://api-ticketfront.interpark.com"
+
+
+# ── YES24 Client ──────────────────────────────────────────────────────────────
+
+
+class Yes24Client:
+    def __init__(self) -> None:
+        http = _require_httpx()
+        self.http = http.Client(
+            headers=HEADERS_YES24, timeout=20, follow_redirects=True
+        )
+
+    def _dates(self, perf_id: str, month_count: int) -> list[str]:
+        now = datetime.now()
+        months: list[str] = []
+        for delta in range(month_count):
+            month = now.month + delta
+            year = now.year + (month - 1) // 12
+            month = ((month - 1) % 12) + 1
+            months.append(f"{year:04d}-{month:02d}")
+
+        dates: list[str] = []
+        cutoff = now.strftime("%Y%m%d")
+        for month_str in months:
+            r = self.http.post(
+                f"{YES24_BASE}/New/Perf/Sale/Ajax/axPerfDay.aspx",
+                data={
+                    "pGetMode": "days",
+                    "pIdPerf": perf_id,
+                    "pPerfMonth": month_str,
+                    "pIdCode": "",
+                    "pIsMania": "0",
+                },
+            )
+            r.raise_for_status()
+            text = r.text.strip().strip(",")
+            if not text:
+                continue
+            for raw in text.split(","):
+                d = raw.strip()
+                if not d:
+                    continue
+                normalized = d.replace("-", "")
+                if normalized >= cutoff:
+                    dates.append(normalized)
+        return sorted(set(dates))
+
+    def get_dates(self, perf_id: str) -> list[str]:
+        """Available dates within ~3 weeks (fast)."""
+        return self._dates(perf_id, month_count=3)
+
+    def get_all_dates(self, perf_id: str) -> list[str]:
+        """Available dates across 6 months (full schedule)."""
+        return self._dates(perf_id, month_count=6)
+
+    def get_slots(self, perf_id: str, perf_day: str) -> list[dict]:
+        r = self.http.post(
+            f"{YES24_BASE}/NEw/Perf/Detail/Ajax/axPerfPlayTime.aspx",
+            data={"IdPerf": perf_id, "PerfDay": perf_day},
+        )
+        r.raise_for_status()
+        html = r.text
+        slots: list[dict] = []
+        seen: set[str] = set()
+        for m in re.finditer(r"idTime='(\d+)'", html):
+            id_time = m.group(1)
+            if id_time in seen:
+                continue
+            seen.add(id_time)
+            ctx_start = max(0, m.start() - 200)
+            ctx = html[ctx_start : m.end() + 200]
+            time_m = re.search(r"(\d{1,2}:\d{2}|\d[회]|[12]\d{3}회)", ctx)
+            label = time_m.group(0) if time_m else id_time
+            slots.append({"idTime": id_time, "label": label})
+        return slots
+
+    def get_seats(self, id_time: str) -> list[dict]:
+        r = self.http.post(
+            f"{YES24_BASE}/New/Perf/Detail/Ajax/axPerfRemainSeat.aspx",
+            data={"Type": "calendar", "IdTime": id_time, "IdLock": "0"},
+        )
+        r.raise_for_status()
+        html = r.text
+        seats: list[dict] = []
+        for m in re.finditer(
+            r"<dt>([^<]+)</dt>\s*<dd>([^<]*)<span[^>]*>\(잔여:(\d+)석\)</span>",
+            html,
+        ):
+            seats.append(
+                {
+                    "grade": m.group(1).strip(),
+                    "price": m.group(2).strip().rstrip(",").strip(),
+                    "remain": int(m.group(3)),
+                }
+            )
+        if not seats:
+            for i, m in enumerate(re.finditer(r"\(잔여:(\d+)석\)", html)):
+                seats.append({"grade": f"좌석{i+1}", "price": "", "remain": int(m.group(1))})
+        return seats
+
+    def schedule(self, perf_id: str, all_dates: bool) -> list[dict]:
+        """Schedule = dates × slots flattened. No seat lookup."""
+        dates = self.get_all_dates(perf_id) if all_dates else self.get_dates(perf_id)
+        out: list[dict] = []
+        for d in dates:
+            for slot in self.get_slots(perf_id, d):
+                out.append(
+                    {
+                        "date": _fmt_date(d),
+                        "time_label": slot["label"],
+                        "id_time": slot["idTime"],
+                    }
+                )
+        return out
+
+    def all_seats(self, perf_id: str, all_dates: bool) -> dict:
+        result: dict = {}
+        dates = self.get_all_dates(perf_id) if all_dates else self.get_dates(perf_id)
+        for d in dates:
+            for slot in self.get_slots(perf_id, d):
+                seats = self.get_seats(slot["idTime"])
+                key = f"{_fmt_date(d)}|{slot['label']}"
+                result[key] = {
+                    "date": _fmt_date(d),
+                    "time_label": slot["label"],
+                    "id_time": slot["idTime"],
+                    "seats": seats,
+                }
+                time.sleep(0.4)
+        return result
+
+
+# ── Interpark Client ──────────────────────────────────────────────────────────
+
+
+class InterparkClient:
+    def __init__(self) -> None:
+        http = _require_httpx()
+        self.http = http.Client(
+            headers=HEADERS_INTERPARK, timeout=20, follow_redirects=True
+        )
+
+    def get_schedule(self, goods_code: str) -> list[dict]:
+        now = datetime.now()
+        r = self.http.get(
+            f"{INTERPARK_BASE}/v1/goods/{goods_code}/playSeq",
+            params={
+                "goodsCode": goods_code,
+                "isBookableDate": "true",
+                "page": "1",
+                "pageSize": "200",
+                "startDate": now.strftime("%Y%m%d"),
+                "endDate": f"{now.year + 1}{now.month:02d}{now.day:02d}",
+            },
+        )
+        r.raise_for_status()
+        data = r.json()
+        if isinstance(data, list):
+            return data
+        return data.get("response", {}).get("data") or data.get("data") or []
+
+    def get_seats(self, goods_code: str, play_seq: str) -> list[dict]:
+        r = self.http.get(
+            f"{INTERPARK_BASE}/v1/goods/{goods_code}/playSeq/PlaySeq/{play_seq}/REMAINSEAT"
+        )
+        r.raise_for_status()
+        data = r.json()
+        if isinstance(data, dict):
+            return (
+                data.get("remainSeat")
+                or (data.get("data") or {}).get("remainSeat")
+                or data.get("response", {}).get("remainSeat")
+                or []
+            )
+        return []
+
+    def schedule(self, goods_code: str) -> list[dict]:
+        out: list[dict] = []
+        for item in self.get_schedule(goods_code):
+            out.append(
+                {
+                    "date": _fmt_date(item.get("playDate", "")),
+                    "time": _fmt_time(item.get("playTime", "")),
+                    "play_seq": item.get("playSeq", ""),
+                }
+            )
+        return out
+
+    def all_seats(self, goods_code: str) -> dict:
+        result: dict = {}
+        for item in self.get_schedule(goods_code):
+            seq = item.get("playSeq", "")
+            if not seq:
+                continue
+            seats_raw = self.get_seats(goods_code, seq)
+            normalized = [
+                {
+                    "grade": s.get("seatGradeName", s.get("seatGrade", "")),
+                    "remain": int(s.get("remainCnt", 0)),
+                }
+                for s in seats_raw
+            ]
+            key = f"{_fmt_date(item.get('playDate', ''))}|{_fmt_time(item.get('playTime', ''))}|{seq}"
+            result[key] = {
+                "date": _fmt_date(item.get("playDate", "")),
+                "time": _fmt_time(item.get("playTime", "")),
+                "play_seq": seq,
+                "seats": normalized,
+            }
+            time.sleep(0.3)
+        return result
+
+
+# ── CLI ───────────────────────────────────────────────────────────────────────
+
+
+def _dump(obj: Any, compact: bool) -> str:
+    if compact:
+        return json.dumps(obj, ensure_ascii=False, separators=(",", ":"))
+    return json.dumps(obj, ensure_ascii=False, indent=2)
+
+
+def cmd_schedule(args: argparse.Namespace) -> int:
+    platform, pid = parse_url(args.url)
+    if platform == "yes24":
+        out = Yes24Client().schedule(pid, all_dates=args.all_dates)
+    else:
+        out = InterparkClient().schedule(pid)
+    print(_dump({"platform": platform, "id": pid, "schedule": out}, args.compact))
+    return 0
+
+
+def cmd_seats(args: argparse.Namespace) -> int:
+    platform, pid = parse_url(args.url)
+    if platform == "yes24":
+        out = Yes24Client().all_seats(pid, all_dates=args.all_dates)
+    else:
+        out = InterparkClient().all_seats(pid)
+    print(_dump({"platform": platform, "id": pid, "seats": out}, args.compact))
+    return 0
+
+
+def cmd_health(args: argparse.Namespace) -> int:
+    http = _require_httpx()
+    results: dict = {}
+    for name, url in [
+        ("yes24",
+         f"{YES24_BASE}/New/Perf/Sale/Ajax/axPerfDay.aspx"),
+        ("interpark",
+         f"{INTERPARK_BASE}/v1/goods/00000000/playSeq"),
+    ]:
+        try:
+            if name == "yes24":
+                r = http.post(url, headers=HEADERS_YES24,
+                               data={"pGetMode": "days", "pIdPerf": "0",
+                                     "pPerfMonth": "2000-01", "pIdCode": "",
+                                     "pIsMania": "0"}, timeout=10)
+            else:
+                r = http.get(url, headers=HEADERS_INTERPARK,
+                              params={"goodsCode": "00000000",
+                                      "isBookableDate": "true",
+                                      "page": "1", "pageSize": "1",
+                                      "startDate": "20000101",
+                                      "endDate": "20000102"},
+                              timeout=10)
+            results[name] = {"status": r.status_code, "ok": r.status_code < 500}
+        except Exception as e:
+            results[name] = {"status": 0, "ok": False, "error": str(e)}
+    print(_dump(results, args.compact))
+    return 0 if all(v.get("ok") for v in results.values()) else 1
+
+
+def main(argv: list[str] | None = None) -> int:
+    parser = argparse.ArgumentParser(
+        prog="ticket-availability",
+        description="YES24 / 인터파크 공연 일정 + 잔여석 조회 (조회 전용)",
+    )
+    sub = parser.add_subparsers(dest="cmd", required=True)
+
+    def _common(p: argparse.ArgumentParser) -> None:
+        p.add_argument("--compact", action="store_true",
+                       help="One-line JSON (기본: 들여쓰기 출력)")
+
+    p_sch = sub.add_parser("schedule", help="공연 일정 조회")
+    p_sch.add_argument("url", help="공연 URL 또는 platform:id")
+    p_sch.add_argument("--all-dates", action="store_true",
+                       help="YES24 — 6개월 전체 (기본: 3주)")
+    _common(p_sch)
+    p_sch.set_defaults(func=cmd_schedule)
+
+    p_st = sub.add_parser("seats", help="등급별 잔여석 조회 (전 일정)")
+    p_st.add_argument("url", help="공연 URL 또는 platform:id")
+    p_st.add_argument("--all-dates", action="store_true",
+                      help="YES24 — 6개월 전체 (기본: 3주)")
+    _common(p_st)
+    p_st.set_defaults(func=cmd_seats)
+
+    p_h = sub.add_parser("health", help="API endpoint reachability check")
+    _common(p_h)
+    p_h.set_defaults(func=cmd_health)
+
+    args = parser.parse_args(argv)
+    try:
+        return args.func(args)
+    except ValueError as e:
+        print(f"error: {e}", file=sys.stderr)
+        return 2
+    except MissingHttpxError as e:
+        print(f"dependency error: {e}", file=sys.stderr)
+        return 4
+    except HTTPX_HTTP_ERROR as e:
+        print(f"http error: {e}", file=sys.stderr)
+        return 3
+
+
+if __name__ == "__main__":
+    sys.exit(main())

package/skills/ticket-availability/skill.json

@@ -0,0 +1,9 @@
+{
+  "name": "ticket-availability",
+  "description": "YES24 / 인터파크 공연의 공개 일정 + 등급별 잔여석을 단일 HTTP 호출로 조회 (조회 전용, 예매·결제 없음). 돌쇠에서는 가능한 가장 가까운 합법적 공식 단계까지 준비한다.",
+  "profiles": [
+    "browser",
+    "hard-boundary"
+  ],
+  "frontmatter": "name: ticket-availability\ndescription: YES24 / 인터파크 공연의 공개 일정 + 등급별 잔여석을 단일 HTTP 호출로 조회 (조회 전용, 예매·결제 없음). 돌쇠에서는 가능한 가장 가까운 합법적 공식 단계까지 준비한다.\nlicense: MIT\nmetadata:\n  category: lifestyle\n  subcategory: ticket\n  locale: ko-KR\n  phase: v1"
+}

package/skills/toss-securities/instruction.md

@@ -0,0 +1,116 @@
+# Toss Securities
+
+## What this skill does
+
+토스증권 **조회 전용(read-only)** 흐름을 실행한다. 두 경로가 있다.
+
+1. **공식 Open API (권장)** — 토스증권 공식 Open API(`https://openapi.tossinvest.com`)를 OAuth 2.0 Client Credentials 토큰으로 호출.
+2. **tossctl fallback** — 공식 credentials가 없을 때 `JungHoonGhae/tossinvest-cli` 의 `tossctl` 을 사용.
+
+조회 항목:
+
+- 계좌 목록 / 보유 주식
+- 시세(현재가/호가/체결/상하한가/캔들) / 종목 정보 / 매수 유의사항
+- 환율 / 장 운영 캘린더(KR·US)
+- 대기중 주문 조회 / 주문 상세 / 매수가능금액 / 판매가능수량 / 수수료
+- (tossctl fallback) 계좌 요약, 포트폴리오 비중, 관심종목
+
+## When to use
+
+- "토스증권 삼성전자 현재가 확인해줘"
+- "내 보유 주식 보여줘"
+- "대기중 주문 조회해줘"
+- "원달러 환율 알려줘"
+
+## 1. Prefer the official Open API
+
+### Prerequisites
+
+- 토스증권 OpenAPI 콘솔에서 발급한 `client_id` / `client_secret`
+- Node.js 18+ (global `fetch`)
+
+자격 증명은 사용자 환경변수로 두고 helper가 토스 서버로 **직접** 호출한다. 공유 프록시로 보내지 않는다.
+
+| 환경변수 | 설명 |
+|---|---|
+| `TOSSINVEST_CLIENT_ID` | client id (필수) |
+| `TOSSINVEST_CLIENT_SECRET` | client secret (필수) |
+| `TOSSINVEST_ACCOUNT` | accountSeq. 계좌·자산·주문조회에 필요 (선택) |
+| `TOSSINVEST_API_BASE_URL` | 기본 `https://openapi.tossinvest.com` (선택) |
+
+### Workflow
+
+helper는 내부적으로 `POST /oauth2/token` 으로 토큰을 발급(Client Credentials)받아 `Authorization: Bearer` 로 호출한다. 계좌·자산·주문조회 API는 `X-Tossinvest-Account` 헤더가 추가로 필요하다.
+
+```js
+const {
+  getPrices,
+  listOfficialAccounts,
+  getHoldings
+} = require("toss-securities");
+
+async function main() {
+  const prices = await getPrices(["005930", "AAPL"]);
+
+  const accounts = await listOfficialAccounts();
+  const accountSeq = accounts.data.result[0].accountSeq;
+  const holdings = await getHoldings({ account: accountSeq });
+
+  console.log(prices.data);
+  console.log(holdings.data);
+}
+
+main().catch((error) => {
+  console.error(error);
+  process.exitCode = 1;
+});
+```
+
+- `429` 는 `Retry-After`/`X-RateLimit-Reset` 만큼 대기 후 백오프 재시도한다.
+- `401` 은 토큰을 1회 재발급해 재시도한다.
+- `client_secret`/토큰은 에러 메시지에서 마스킹된다.
+
+## 2. tossctl fallback
+
+공식 credentials가 없으면 비공식 `tossctl` 을 fallback으로 쓴다.
+
+### Install `tossctl` first when missing
+
+```bash
+brew tap JungHoonGhae/tossinvest-cli
+brew install tossctl
+tossctl doctor
+tossctl auth doctor
+tossctl auth login
+```
+
+로그인 세션이 없으면 먼저 위 흐름을 끝낸다. 다른 비공식 크롤링이나 임의 HTTP 재구현으로 우회하지 않는다.
+
+지원하는 read-only 명령:
+
+- `tossctl account summary --output json`
+- `tossctl portfolio positions --output json`
+- `tossctl quote get TSLA --output json`
+- `tossctl watchlist list --output json`
+- `tossctl orders completed --market all --output json`
+
+패키지 wrapper(`getAccountSummary`, `getPortfolioPositions`, `getQuote`, `listWatchlist` 등)도 그대로 쓸 수 있다.
+
+## Answer conservatively
+
+- 계좌번호/민감정보는 꼭 필요한 범위만 노출한다.
+- 사용자가 "오늘" 같은 상대 날짜를 말하면 절대 날짜로 풀어 답한다.
+- 이 스킬은 조회 전용이다. 실거래 mutation 은 범위 밖이라고 분명히 말한다.
+
+## Done when
+
+- 공식 API credentials(또는 tossctl 로그인) 상태가 확인되었다.
+- 요청에 맞는 read-only 호출을 실행했다.
+- 결과를 한국어로 짧게 정리했다.
+
+## Failure modes
+
+- 공식 API credentials(`TOSSINVEST_CLIENT_ID`/`SECRET`)가 없으면 `TossCredentialsError` 로 명확히 실패한다.
+- 계좌·자산·주문조회 helper에 `X-Tossinvest-Account` 가 없으면 네트워크 호출 전에 실패한다.
+- tossctl fallback은 `auth login` 전이면 계좌/포트폴리오 조회가 실패할 수 있다.
+- 계좌/주문 정보는 민감하므로 출력 범위를 과도하게 넓히지 않는다.

package/skills/toss-securities/skill.json

@@ -0,0 +1,9 @@
+{
+  "name": "toss-securities",
+  "description": "토스증권 조회형 질문을 공식 Open API(OAuth2)로 우선 처리하고, 공식 credentials가 없으면 tossinvest-cli의 tossctl을 fallback으로 써서 계좌, 보유주식, 시세/종목/시장정보, 주문조회를 안전한 read-only 흐름으로 조회한다. 돌쇠에서는 공식 표면을 통한 후속 액션까지 진행한다.",
+  "profiles": [
+    "vault",
+    "action:account"
+  ],
+  "frontmatter": "name: toss-securities\ndescription: 토스증권 조회형 질문을 공식 Open API(OAuth2)로 우선 처리하고, 공식 credentials가 없으면 tossinvest-cli의 tossctl을 fallback으로 써서 계좌, 보유주식, 시세/종목/시장정보, 주문조회를 안전한 read-only 흐름으로 조회한다. 돌쇠에서는 공식 표면을 통한 후속 액션까지 진행한다.\nlicense: MIT\nmetadata:\n  category: finance\n  locale: ko-KR\n  phase: v1"
+}

package/skills/used-car-price-search/instruction.md

@@ -0,0 +1,109 @@
+# Used Car Price Search
+
+## What this skill does
+
+한국의 대표 렌터카 업체를 먼저 비교하고, 현재는 **가장 기술적으로 구현이 쉬운 공급자**로 확인된 `SK렌터카 다이렉트 타고BUY`를 사용해 중고차 가격을 조회한다.
+
+- 한국의 주요 렌터카 업체로 `SK렌터카`, `롯데렌탈(롯데오토옥션)`, `레드캡렌터카`를 먼저 확인한다.
+- 각 업체의 공개 표면에서 **직접 API 제공 여부**, 웹 크롤링 난이도, 기존 **MCP / Skill** 존재 여부를 먼저 점검한다.
+- 이 저장소와 현재 세션에는 중고차 가격 조회용 전용 **MCP** 나 **Skill** 이 없으므로 새 스킬이 직접 조회를 담당한다.
+- 최종 선택 공급자는 `https://www.skdirect.co.kr/tb` 이다.
+- 이 페이지는 로그인 없이 열리고, HTML 안의 `__NEXT_DATA__` 에 현재 inventory snapshot 이 들어 있어 반복 조회가 쉽다.
+- 결과는 **월 렌트료**와 **인수가**를 함께 보여 준다.
+
+## Provider survey
+
+| 업체 | 점검 결과 | v1 채택 여부 |
+| --- | --- | --- |
+| SK렌터카 다이렉트 `타고BUY` | `https://www.skdirect.co.kr/tb` 공개 HTML 에 `__NEXT_DATA__` inventory snapshot 포함. 로그인/세션 없이 반복 조회 가능. 별도 공개 API 문서는 못 찾았지만 SSR 데이터 추출이 가장 단순함. | 채택 |
+| 롯데렌탈 / 롯데오토옥션 | `https://www.lotteautoauction.net/hp/pub/cmm/viewMain.do` 공개 진입점은 열리지만, 일반 매물 검색은 legacy `.do` 흐름 중심이고 공개 목록 계약이 불명확했다. 추정 목록 URL은 404/에러 페이지가 섞여 v1 공급자로는 불안정했다. | 미채택 |
+| 레드캡렌터카 | 공식 진입점이 `https://biz.redcap.co.kr/rent/` business portal 로 이어졌고, 공개 중고차 inventory 검색 표면이나 직접 API를 확인하지 못했다. | 미채택 |
+
+## When to use
+
+- "아반떼 중고차 가격 봐줘"
+- "SK렌터카 타고BUY에 K3 얼마야?"
+- "캐스퍼 인수가/월 렌트료 같이 알려줘"
+- "중고차 시세를 렌터카 업체 기준으로 보고 싶어"
+
+## When not to use
+
+- 실제 구매/계약/상담 신청까지 자동화해야 하는 경우
+- 특정 VIN/성능기록부/사고이력 원문까지 강제해야 하는 경우
+- 여러 업체 통합 최저가 비교가 필요한 경우
+
+## Prerequisites
+
+- 인터넷 연결
+- `node` 18+
+- `used-car-price-search` package 또는 동일 로직
+
+## Required inputs
+
+### 1. Ask the car model/keyword first if it is missing
+
+차종 키워드가 없으면 먼저 물어본다.
+
+- 권장 질문: `어떤 차종을 찾을까요? 예: 아반떼, K3, 캐스퍼`
+- 너무 넓으면: `제조사나 차종을 조금 더 구체적으로 알려주세요. 예: 현대 아반떼, 기아 K3`
+
+## Official surface used in v1
+
+- SK direct used-car inventory page: `https://www.skdirect.co.kr/tb`
+
+## Workflow
+
+1. 차종 키워드가 없으면 먼저 질문한다.
+2. `SK렌터카`, `롯데렌탈`, `레드캡렌터카` 비교 결과를 짧게 기억하고, 현재 공급자는 `SK렌터카 다이렉트 타고BUY` 임을 유지한다.
+3. `https://www.skdirect.co.kr/tb` HTML 을 가져온다.
+4. HTML 의 `__NEXT_DATA__` JSON 에서 `carListProd` inventory snapshot 을 읽는다.
+5. 차종 키워드로 inventory 를 필터링한다.
+6. 상위 결과에서 `인수가`, `월 렌트료`, `연식`, `주행거리`, `연료`, `변속기`를 정리한다.
+7. 같은 차종이라도 재고가 수시로 바뀔 수 있으므로 snapshot 기준 응답임을 짧게 알린다.
+
+## Node.js example
+
+```js
+const { lookupUsedCarPrices } = require("used-car-price-search")
+
+async function main() {
+  const result = await lookupUsedCarPrices("아반떼", { limit: 5 })
+
+  console.log({
+    provider: result.provider,
+    matchedCount: result.matchedCount,
+    summary: result.summary,
+    items: result.items
+  })
+}
+
+main().catch((error) => {
+  console.error(error)
+  process.exitCode = 1
+})
+```
+
+## Respond conservatively
+
+응답은 아래 순서로 짧게 정리한다.
+
+- 공급자: `SK렌터카 다이렉트 타고BUY`
+- 차종 키워드
+- 매칭된 차량 수
+- 인수가 범위
+- 월 렌트료 범위
+- 대표 차량 2~5개
+- `공개 inventory snapshot 기준이라 실시간 재고/가격은 바뀔 수 있다`는 안내
+
+## Done when
+
+- 주요 렌터카 업체 비교와 공급자 선택 이유를 설명했다.
+- 차종 키워드 기준으로 결과를 최소 1건 이상 또는 보수적 빈 결과로 반환했다.
+- 결과에 `인수가` 와 `월 렌트료` 를 함께 담았다.
+- 라이브 검증에서 **최소 10회 이상** 반복 조회가 가능함을 확인했다.
+
+## Failure modes
+
+- 공개 inventory snapshot 은 페이지 갱신 타이밍에 따라 달라질 수 있다.
+- 별도 공개 API 문서는 찾지 못했으므로 v1 은 HTML 내 `__NEXT_DATA__` 의 안정성에 의존한다.
+- 특정 차종 키워드가 너무 넓으면 유사 모델이 함께 섞일 수 있다.

package/skills/used-car-price-search/skill.json

@@ -0,0 +1,8 @@
+{
+  "name": "used-car-price-search",
+  "description": "주요 한국 렌터카 업체를 비교한 뒤 SK렌터카 다이렉트 타고BUY inventory snapshot 으로 중고차 가격/인수가를 조회한다. 돌쇠에서는 공식 표면을 통한 후속 액션까지 진행한다.",
+  "profiles": [
+    "action:commerce"
+  ],
+  "frontmatter": "name: used-car-price-search\ndescription: 주요 한국 렌터카 업체를 비교한 뒤 SK렌터카 다이렉트 타고BUY inventory snapshot 으로 중고차 가격/인수가를 조회한다. 돌쇠에서는 공식 표면을 통한 후속 액션까지 진행한다.\nlicense: MIT\nmetadata:\n  category: automotive\n  locale: ko-KR\n  phase: v1"
+}