---
title: "hotel-search"
description: "같은 호텔의 여러 예약 사이트(Booking·Agoda·Trip.com·Klook·공식사이트) 실시간 요금을 한 번에 비교해 최저가와 각 사이트 예약 링크를 찾는 스킬입니다. \"신라호텔 서울 8월 1일부터 2박 최저가 비교해줘\", \"이 호텔 부킹이랑 아고다 중 어디가 싸? 예약 링크도 줘\", \"제주 그랜드하얏트 이번 주말 가격이랑 싼 날짜 알려줘\"처럼 말하면 됩니다. Xotelo(트립어드바이저 메타서치) API 를 표준 라이브러리로 직접 호출합니다 — 브라우저·hyve 없이 동작."
pack: itda-travel
slug: hotel-search
status: experimental
tags: ["hotel", "price", "comparison", "travel", "tripadvisor", "xotelo", "ota", "booking", "agoda", "read-only", "api"]
---
# hotel-search 사용 가이드

같은 호텔이 예약 사이트마다 값이 다른데, 그걸 한 번에 비교해서 **어디가 제일 싼지 + 각
사이트 예약 링크 + 언제가 싼지**까지 알려주는 스킬입니다. 평소 말하듯 부탁하면 됩니다.

## ⚠️ 실험적 스킬

개인 참고용으로 만든 실험 스킬입니다. **검색·비교만** 하고 예약·결제는 하지 않습니다.
값은 트립어드바이저 메타서치 기준이라 **실제 예약가와 다를 수 있으니**, 예약 직전엔 링크로
들어가 그 사이트에서 최종 확인하세요.

## 먼저 알아두세요

- **가입이나 키 발급이 필요 없습니다.** 무료 공개 데이터를 씁니다.
- 보여드리는 **가격은 찾아본 그 순간 기준**입니다. 회원가·카드할인·쿠폰이 붙으면 달라져요.
- 값은 **원화로 환산해** 함께 보여드립니다(달러로 모아 환율로 바꾼 참고값). 실제 결제 통화는
  각 사이트에서 확인하세요.
- 한 사이트가 방마다 값이 다른 건 반영하지 않고, **그 사이트에서 예약 가능한 가장 싼 방 기준**
  하나로 비교합니다. 날짜에 따라 뜨는 사이트 수(2~4곳)가 달라질 수 있어요.

## 시작하려면 — 호텔을 특정할 수 있어야 합니다

네, **대략의 호텔 이름만 알아도 시작됩니다.** 정확한 정식명칭이 아니어도, 지역과 함께 말해 주면
알아서 그 호텔을 찾아 비교합니다. 트립어드바이저에 올라온 호텔이면 대부분 됩니다.

- `/hotel-search 그 장충동 신라호텔, 이번 주말 얼마야?`
- `/hotel-search 제주 그랜드하얏트 다음 주 금요일 1박 가격 비교해줘`

## 이렇게 말해보세요

**한 호텔 가격 비교 + 예약 링크**

- `/hotel-search 신라호텔 서울 8월 1일부터 2박, 어디가 제일 싸?`
- `/hotel-search 노보텔 동대문 내일 1박, 부킹이랑 아고다 중 어디가 싸? 예약 링크도 같이 줘`
- `/hotel-search 노보텔 동대문 내일 1박, 성인 2명 가격이랑 각 사이트 링크 알려줘`

각 사이트(부킹닷컴·아고다·트립닷컴·클룩 등)의 1박가·총액을 한 표로 모아 **제일 싼 곳을 표시**하고,
사이트마다 **예약 링크**를 함께 드립니다. 다만 사이트별로 링크가 조금 다릅니다:
- **부킹닷컴**은 그 호텔·그 날짜로 **바로** 들어갑니다.
- **아고다·트립닷컴·클룩·공식사이트**는 그 호텔의 해당 사이트 페이지를 **검색으로** 열어 드립니다
  (그 사이트들은 링크에 내부 코드가 필요해 바로가기가 안 되기 때문). 검색 최상단이 그 호텔이니
  한 번 더 눌러 들어가시면 됩니다.

**지역 + 예산으로 찾기**

- `/hotel-search 장충동에서 내일 1박, 8만~13만원대 호텔 찾아줘`
- `/hotel-search 명동 근처 이번 주말 10만원 안쪽 호텔 있어?`

이럴 땐 먼저 그 지역의 호텔 후보를 웹에서 찾아 **목록으로 보여드리고, 어느 호텔을 볼지 여쭙습니다.**
고르시면 그 호텔 가격을 조회해 **예산에 드는지** 확인해 드려요. ("다 비교해줘" 하시면 후보 전부를
한꺼번에 조회합니다.) 여러 곳을 차례로 확인하는 방식이라 한 호텔만 볼 때보다 조금 더 걸리고,
그 지역·그 예산에 맞는 호텔이 없으면 "못 찾음"으로 정직하게 알려드립니다.

**언제 예약하면 싼지 (가격 달력)**

- `/hotel-search 신라호텔 서울 이번 달 언제가 제일 싸?`
- `/hotel-search 노보텔 동대문 다음 달 중에 싼 날짜만 알려줘`

날짜별로 싼 날·보통·비싼 날을 갈라 보여드려, 하루 이틀 옮겨 싸게 잡을 수 있게 돕습니다.

## 무엇을 알려주나요

- 사이트별 **1박가·전체 숙박 총액**(원화 병기), 그리고 **제일 싼 곳** 표시
- 사이트별 **예약 링크**(부킹닷컴은 바로, 나머지는 검색으로 그 호텔 페이지까지)
- 싼 날/비싼 날 **가격 달력**

## 예약은 어떻게 하나요

이 스킬은 예약·결제를 하지 않습니다. 마음에 드는 값이 있으면 함께 드리는 **예약 링크**를 열어
그 사이트에서 직접 진행하세요. 예약 직전 실제 값·조건(조식·취소규정)을 꼭 확인하시고요.

## 지금은 안 되는 것들

- 예약·결제·취소는 하지 않습니다(검색·비교 전용).
- 회원가·카드할인·쿠폰이 반영된 최종가는 알 수 없습니다.
- 방 종류(디럭스/스위트)별 가격은 구분하지 않습니다 — 사이트별 최저가 하나만 비교합니다.
- 트립어드바이저에 없는 호텔은 조회할 수 없습니다.
- 이름 검색이 무료로 안 되기 때문에, 지역+예산 찾기는 후보를 하나씩 확인하는 방식입니다.

## 잘 안 될 때

- **값이 안 나올 때** — 그 날짜에 매진이거나, 날짜가 잘못됐거나, 트립어드바이저 미등재
  호텔일 수 있어요. 날짜·호텔명을 확인해 다시 말해 주세요.
- **엉뚱한 호텔을 찾을 때** — 같은 이름이 여러 곳일 수 있으니 지역을 붙여 주세요
  ("장충동 신라호텔"처럼).
- **예약 링크로 갔더니 값이 조금 다를 때** — 사이트 실시간가·회원가 차이입니다. 링크의
  실제 값이 최종이에요.