백두대간 생태수목원(강원특별자치도 정선군 임계면)의 숙박 잔여·요금 조회와 가예약 접수를 AI 에이전트(ChatGPT·Claude·Perplexity·Gemini 등)가 직접 수행할 수 있습니다. 별도 회원가입·API 키 없이 무료로 이용할 수 있으며, 결제는 항상 고객 본인이 휴대폰 SMS 링크로 진행합니다.
버튼을 누르면 예약 문의 내용이 미리 채워진 채 AI 채팅이 새 창으로 열립니다. 로그인되어 있다면 전송만 누르면 AI가 남은 자리·요금을 알아봐 드립니다.
백두대간 생태수목원(https://go.osoza.kr) 숙박 예약을 도와줘. 사용법은 https://go.osoza.kr/ai-guide 에 있어. 먼저 내가 원하는 날짜·박수·인원을 물어본 뒤, https://go.osoza.kr/api/public/v1/availability?date=YYYY-MM-DD&nights=1 을 호출해서 남은 자리와 요금을 표로 보여주고, 응답의 reserveUrl(예약 페이지 바로가기)도 같이 알려줘. 내가 원하면 가예약 접수도 네가 직접 해줘 — 사이트 버튼을 누를 필요 없이 내 이름·휴대폰 번호를 받아 POST /api/public/v1/reservation-request 를 호출하면 자리가 확보되고 결제 링크가 내 문자로 와. 결제는 그 SMS 링크에서 내가 직접 하는 방식이야.
아래 엔드포인트를 그대로 HTTP 호출하면 됩니다(인증 불필요, JSON 응답). 전체 기계판독 스펙: openapi.json
| 메서드 | 경로 | 설명 |
|---|---|---|
| GET | /api/public/v1/info | 시설 기본정보(주소·연락처·입퇴실 시각) |
| GET | /api/public/v1/availability?date=YYYY-MM-DD&nights=1 | 구역별 잔여 자리 조회(최대 14박) |
| GET | /api/public/v1/rates?areaNo=1&from=YYYY-MM-DD&to=YYYY-MM-DD | 구역 일자별 요금(최대 62일) |
| POST | /api/public/v1/reservation-request | 가예약 접수 — 자리 hold + 고객 휴대폰으로 결제링크 SMS 발송 |
| GET | /api/public/v1/reservation-request/{requestId} | 가예약 상태 조회(WAITING·PAID·EXPIRED) |
MCP(Model Context Protocol)를 지원하는 에이전트는 아래 엔드포인트를 커넥터로 등록하면 위 기능을 툴로 사용할 수 있습니다.
MCP 엔드포인트: https://mcp.osoza.kr/mcp (Streamable HTTP, 인증 없음) Claude Code 등록 예: claude mcp add --transport http osoza https://mcp.osoza.kr/mcp
디스커버리 문서: /.well-known/mcp.json
reserveUrl은 날짜가 미리 채워진 사람용 예약 페이지 바로가기입니다 —
이용자가 직접 화면에서 예약하길 원하면 이 링크를 전달하세요.POST /reservation-request로 가예약을 접수하면 자리가 일시 점유(hold)됩니다.holdExpireAt) 전에 결제하지 않으면 자동 취소됩니다. 진행 상황은 상태 조회 API로 확인합니다./api/public/* 전체), 가예약 접수는 IP당 분당 3회.https://go.osoza.kr 도메인으로만 서비스됩니다.