Back to Details

myrealtrip-search

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

마이리얼트립 검색

MyRealTrip搜索

이 스킬이 하는 일

该技能的功能

마이리얼트립 공식 개발자센터의 MCP 문서에 공개된 엔드포인트를 사용해 여행 검색을 수행한다.
지원 범위:
  • 국내선/국제선 항공권 검색
  • 항공권 날짜별 최저가 캘린더와 프로모션 항공사 조회
  • 숙소 검색 및 상세/객실/리뷰/편의시설 조회
  • 투어·티켓·액티비티 검색, 상세, 날짜별 옵션/가격/예약 가능 여부 조회
  • 현재 한국 시간(KST) 조회
使用MyRealTrip官方开发者中心MCP文档中公开的端点进行旅行搜索。
支持范围:
  • 国内/国际机票搜索
  • 机票日期最低价日历及促销航空公司查询
  • 住宿搜索及详情/客房/评价/设施查询
  • 旅游·门票·活动搜索、详情、日期选项/价格/可预订情况查询
  • 查询当前韩国时间(KST)

동작 방식

运行方式

Claude Code / Codex / Hermes Agent
  → myrealtrip-search/scripts/myrealtrip_mcp.py
    → https://mcp-servers.myrealtrip.com/mcp (Streamable HTTP MCP)
      ├─ searchDomesticFlights / searchInternationalFlights
      ├─ flightsFareCalendar / getPromotionAirlines
      ├─ searchStays / getStayDetail
      ├─ getCategoryList / searchTnas / getTnaDetail / getTnaOptions
      └─ getCurrentTime
이 스킬은 화면 scraping이 아니라 마이리얼트립이 공개한 MCP 서버를 직접 호출한다. 따라서 DOM 선택자나 브라우저 자동화에 의존하지 않는다.
Claude Code / Codex / Hermes Agent
  → myrealtrip-search/scripts/myrealtrip_mcp.py
    → https://mcp-servers.myrealtrip.com/mcp (Streamable HTTP MCP)
      ├─ searchDomesticFlights / searchInternationalFlights
      ├─ flightsFareCalendar / getPromotionAirlines
      ├─ searchStays / getStayDetail
      ├─ getCategoryList / searchTnas / getTnaDetail / getTnaOptions
      └─ getCurrentTime
该技能不使用网页抓取，而是直接调用MyRealTrip公开的MCP服务器。因此不依赖DOM选择器或浏览器自动化。

사용할 때

使用场景

  • "마이리얼트립에서 제주 항공권 찾아줘"
  • "다음 주 오사카 가는 최저가 항공권 봐줘"
  • "부산 해운대 호텔 2박 검색해줘"
  • "이 호텔 객실 타입이랑 취소정책 자세히 봐줘"
  • "오사카 유니버설 스튜디오 티켓 가격 확인해줘"
  • "도쿄 디즈니랜드 날짜별 옵션 확인해줘"
  • "항공권 특가 항공사 있어?"
  • "帮我在MyRealTrip上找济州岛的机票"
  • "帮我看下周去大阪的最低价机票"
  • "帮我搜索釜山海云台的酒店2晚"
  • "帮我详细看下这家酒店的房型和取消政策"
  • "帮我确认大阪环球影城的门票价格"
  • "帮我看下东京迪士尼乐园的日期选项"
  • "有没有特价机票的航空公司？"

사용하지 않을 때

不适用场景

  • 실제 예약/결제/로그인이 필요한 경우
  • 마이리얼트립 계정의 예약 내역이나 개인화 데이터가 필요한 경우
  • 항공권·숙소·투어 외의 파트너 API 수익/예약 내역 조회가 목적일 때
  • 가격·재고를 법적/회계적 증빙 수준으로 확정해야 할 때
  • 需要实际预订/支付/登录的情况
  • 需要MyRealTrip账户的预订记录或个性化数据的情况
  • 目的是查询机票·住宿·旅游之外的合作API收益/预订记录时
  • 需要将价格·库存作为法律/会计级别的确认依据时

준비 사항

准备事项

Python MCP SDK가 필요하다. 없으면 설치한다.
bash
python3 -m pip install mcp
기본 엔드포인트는 공식 문서의 URL이다. 필요할 때만 환경변수로 바꾼다.
bash
export MYREALTRIP_MCP_ENDPOINT="https://mcp-servers.myrealtrip.com/mcp"
Hermes Agent에 MCP 서버로 직접 등록하려면 다음 설정을 쓸 수 있다.
yaml
mcp_servers:
  myrealtrip:
    url: "https://mcp-servers.myrealtrip.com/mcp"
CLI별 공식 연결 명령은 문서 기준 다음과 같다.
bash
claude mcp add --transport http myrealtrip https://mcp-servers.myrealtrip.com/mcp
codex mcp add myrealtrip --url https://mcp-servers.myrealtrip.com/mcp
gemini mcp add -t http -s user myrealtrip https://mcp-servers.myrealtrip.com/mcp
需要Python MCP SDK。如果没有则进行安装。
bash
python3 -m pip install mcp
默认端点为官方文档中的URL。仅在需要时通过环境变量修改。
bash
export MYREALTRIP_MCP_ENDPOINT="https://mcp-servers.myrealtrip.com/mcp"
若要直接在Hermes Agent中注册MCP服务器，可使用以下设置。
yaml
mcp_servers:
  myrealtrip:
    url: "https://mcp-servers.myrealtrip.com/mcp"
各CLI的官方连接命令如下（按文档说明）：
bash
claude mcp add --transport http myrealtrip https://mcp-servers.myrealtrip.com/mcp
codex mcp add myrealtrip --url https://mcp-servers.myrealtrip.com/mcp
gemini mcp add -t http -s user myrealtrip https://mcp-servers.myrealtrip.com/mcp

사용 흐름

使用流程

1. 요청 유형을 분류한다

1. 分类请求类型

  • 국내 항공: 출발지와 도착지가 모두 한국 도시/공항이면 
    searchDomesticFlights
  • 국제 항공: 목적지가 해외면 
    searchInternationalFlights
  • 날짜 유연 항공 최저가: 
    flightsFareCalendar
    후 실제 검색 도구로 재확인
  • 숙소 목록: 
    searchStays
  • 특정 숙소 상세/객실/리뷰/편의시설: 
    searchStays
    로 
    gid
    확보 후 
    getStayDetail
  • 투어·티켓·액티비티 목록: 
    searchTnas
  • 도시별 카테고리 필터가 필요하면 
    getCategoryList
    후 
    searchTnas
  • 특정 투어 상세: 
    searchTnas
    결과의 
    gid
    , 
    url
    로 
    getTnaDetail
  • 날짜별 실제 옵션/가격/가능 여부: 
    getTnaOptions
  • 国内机票: 出发地和目的地均为韩国城市/机场时，使用
    searchDomesticFlights
  • 国际机票: 目的地为海外时，使用
    searchInternationalFlights
  • 日期灵活的机票最低价: 先调用
    flightsFareCalendar
    ，再通过实际搜索工具重新确认
  • 住宿列表: 使用
    searchStays
  • 特定住宿的详情/客房/评价/设施: 通过
    searchStays
    获取
    gid
    后调用
    getStayDetail
  • 旅游·门票·活动列表: 使用
    searchTnas
  • 需要按城市分类筛选时，先调用
    getCategoryList
    再调用
    searchTnas
  • 特定旅游详情: 使用
    searchTnas
    结果中的
    gid
    和
    url
    调用
    getTnaDetail
  • 日期实际选项/价格/可预订情况: 使用
    getTnaOptions

2. 도구 목록과 입력 스키마를 확인한다

2. 查看工具列表和输入 schema

bash
python3 myrealtrip-search/scripts/myrealtrip_mcp.py tools
bash
python3 myrealtrip-search/scripts/myrealtrip_mcp.py tools

3. 항공권 검색

3. 机票搜索

국내선은 두 공항이 모두 한국일 때만 사용한다.
bash
python3 myrealtrip-search/scripts/myrealtrip_mcp.py call searchDomesticFlights \
  --arg origin=GMP \
  --arg destination=CJU \
  --arg departDate=2026-05-20 \
  --arg maxResults=10
국제선은 해외 목적지일 때 사용한다. 사용자가 출발 공항을 말하지 않으면 인천(
ICN
)을 기본값으로 둔다.
bash
python3 myrealtrip-search/scripts/myrealtrip_mcp.py call searchInternationalFlights \
  --json '{"tripType":"ROUND_TRIP","origin":"ICN","destination":"KIX","departDate":"2026-06-10","returnDate":"2026-06-14","passengers":{"adults":1,"children":0,"infants":0},"maxResults":5}'
날짜가 유동적인 최저가 요청은 캘린더를 먼저 본다. 캘린더 가격은 캐시/추정값이므로, 최종 답변 전에 실제 검색 도구로 후보 날짜를 다시 확인한다.
bash
python3 myrealtrip-search/scripts/myrealtrip_mcp.py call flightsFareCalendar \
  --arg from=ICN \
  --arg to=NRT \
  --arg departureDate=2026-06-01 \
  --arg period=4 \
  --arg maxResults=30
특가/할인 항공사 요청은 프로모션 항공사를 먼저 확인한다.
bash
python3 myrealtrip-search/scripts/myrealtrip_mcp.py call getPromotionAirlines
国内机票仅在两个机场均位于韩国时使用。
bash
python3 myrealtrip-search/scripts/myrealtrip_mcp.py call searchDomesticFlights \
  --arg origin=GMP \
  --arg destination=CJU \
  --arg departDate=2026-05-20 \
  --arg maxResults=10
国际机票在目的地为海外时使用。若用户未指定出发机场，默认使用仁川(
ICN
)。
bash
python3 myrealtrip-search/scripts/myrealtrip_mcp.py call searchInternationalFlights \
  --json '{"tripType":"ROUND_TRIP","origin":"ICN","destination":"KIX","departDate":"2026-06-10","returnDate":"2026-06-14","passengers":{"adults":1,"children":0,"infants":0},"maxResults":5}'
日期灵活的最低价请求，先查看日历。日历价格为缓存/估算值，最终答复前需通过实际搜索工具重新确认候选日期。
bash
python3 myrealtrip-search/scripts/myrealtrip_mcp.py call flightsFareCalendar \
  --arg from=ICN \
  --arg to=NRT \
  --arg departureDate=2026-06-01 \
  --arg period=4 \
  --arg maxResults=30
特价/折扣航空公司请求，先查询促销航空公司。
bash
python3 myrealtrip-search/scripts/myrealtrip_mcp.py call getPromotionAirlines

4. 숙소 검색과 상세 조회

4. 住宿搜索及详情查询

bash
python3 myrealtrip-search/scripts/myrealtrip_mcp.py call searchStays \
  --json '{"keyword":"부산 해운대","checkIn":"2026-06-10","checkOut":"2026-06-12","adultCount":2,"childCount":0,"isDomestic":true,"order":"recommended","minReviewRating":4.0}'
사용자가 특정 숙소의 객실, 가격, 편의시설, 리뷰, 취소정책을 묻거나 "자세히"를 요청하면 
searchStays
결과의 
gid
로 상세를 이어서 호출한다.
bash
python3 myrealtrip-search/scripts/myrealtrip_mcp.py call getStayDetail \
  --json '{"gid":123456,"checkIn":"2026-06-10","checkOut":"2026-06-12","adultCount":2,"childCount":0}'
bash
python3 myrealtrip-search/scripts/myrealtrip_mcp.py call searchStays \
  --json '{"keyword":"釜山 海云台","checkIn":"2026-06-10","checkOut":"2026-06-12","adultCount":2,"childCount":0,"isDomestic":true,"order":"recommended","minReviewRating":4.0}'
当用户询问特定住宿的客房、价格、设施、评价、取消政策，或要求“详细查看”时，使用
searchStays
结果中的
gid
继续调用详情接口。
bash
python3 myrealtrip-search/scripts/myrealtrip_mcp.py call getStayDetail \
  --json '{"gid":123456,"checkIn":"2026-06-10","checkOut":"2026-06-12","adultCount":2,"childCount":0}'

5. 투어/티켓/액티비티 검색과 옵션 확인

5. 旅游/门票/活动搜索及选项确认

도시별 카테고리 필터를 쓰려면 카테고리 값을 추측하지 말고 먼저 조회한다.
bash
python3 myrealtrip-search/scripts/myrealtrip_mcp.py call getCategoryList --arg city=Osaka
검색어는 한국어가 가장 잘 맞는다.
bash
python3 myrealtrip-search/scripts/myrealtrip_mcp.py call searchTnas \
  --arg query="오사카 유니버설 스튜디오" \
  --arg perPage=5
상세는 검색 결과의 
gid
와 
url
을 같이 넘긴다.
bash
python3 myrealtrip-search/scripts/myrealtrip_mcp.py call getTnaDetail \
  --json '{"gid":"123456","url":"https://www.myrealtrip.com/offers/123456"}'
날짜별 예약 가능 여부와 실제 가격은 
getTnaOptions
로 확인한다.
bash
python3 myrealtrip-search/scripts/myrealtrip_mcp.py call getTnaOptions \
  --json '{"gid":"123456","url":"https://www.myrealtrip.com/offers/123456","selectedDate":"2026-06-10"}'
如需使用城市分类筛选，请勿猜测分类值，先进行查询。
bash
python3 myrealtrip-search/scripts/myrealtrip_mcp.py call getCategoryList --arg city=Osaka
搜索词使用韩文效果最佳。
bash
python3 myrealtrip-search/scripts/myrealtrip_mcp.py call searchTnas \
  --arg query="大阪环球影城" \
  --arg perPage=5
详情查询需同时传入搜索结果中的
gid
和
url
。
bash
python3 myrealtrip-search/scripts/myrealtrip_mcp.py call getTnaDetail \
  --json '{"gid":"123456","url":"https://www.myrealtrip.com/offers/123456"}'
日期可预订情况及实际价格通过
getTnaOptions
确认。
bash
python3 myrealtrip-search/scripts/myrealtrip_mcp.py call getTnaOptions \
  --json '{"gid":"123456","url":"https://www.myrealtrip.com/offers/123456","selectedDate":"2026-06-10"}'

사용 가능한 도구

可用工具

도구명용도주요 입력
getCurrentTime
현재 KST 조회없음
searchDomesticFlights
국내선 항공권 검색
origin
, 
destination
, 
departDate
, 
returnDate
, 
passengers
, 
cabinClass
, 
maxResults
searchInternationalFlights
국제선 항공권 검색
origin
, 
destination
, 
departDate
, 
returnDate
, 
passengers
, 
cabinClass
, 
directFlightOnly
, 
preferredAirline
flightsFareCalendar
날짜별 최저가 캘린더
from
, 
to
, 
departureDate
, 
period
, 
international
, 
transfer
getPromotionAirlines
프로모션 항공사 조회없음
searchStays
숙소 목록 검색
keyword
, 
checkIn
, 
checkOut
, 
adultCount
, 
childCount
, 
isDomestic
, 가격/평점/시설 필터
getStayDetail
숙소 상세/객실/리뷰/편의시설
gid
, 
checkIn
, 
checkOut
, 
adultCount
, 
childCount
getCategoryList
도시별 TNA 카테고리 조회
city
searchTnas
투어/티켓/액티비티 검색
query
, 
page
, 
perPage
, 
category
, 
sort
getTnaDetail
TNA 상품 상세
gid
, 
url
getTnaOptions
날짜별 예약 가능 여부와 실제 가격
gid
, 
url
, 
selectedDate
工具名用途主要输入
getCurrentTime
查询当前KST时间无
searchDomesticFlights
国内机票搜索
origin
, 
destination
, 
departDate
, 
returnDate
, 
passengers
, 
cabinClass
, 
maxResults
searchInternationalFlights
国际机票搜索
origin
, 
destination
, 
departDate
, 
returnDate
, 
passengers
, 
cabinClass
, 
directFlightOnly
, 
preferredAirline
flightsFareCalendar
日期最低价日历
from
, 
to
, 
departureDate
, 
period
, 
international
, 
transfer
getPromotionAirlines
查询促销航空公司无
searchStays
住宿列表搜索
keyword
, 
checkIn
, 
checkOut
, 
adultCount
, 
childCount
, 
isDomestic
, 价格/评分/设施筛选器
getStayDetail
住宿详情/客房/评价/设施
gid
, 
checkIn
, 
checkOut
, 
adultCount
, 
childCount
getCategoryList
查询城市TNA分类
city
searchTnas
旅游/门票/活动搜索
query
, 
page
, 
perPage
, 
category
, 
sort
getTnaDetail
TNA产品详情
gid
, 
url
getTnaOptions
日期可预订情况及实际价格
gid
, 
url
, 
selectedDate

응답 형식

响应格式

래퍼는 MCP 
CallToolResult
를 JSON으로 출력한다. 보통 
content[].text
에 사람이 읽을 수 있는 검색 결과가 들어온다.
json
{
  "content": [
    {
      "type": "text",
      "text": "검색 결과 ..."
    }
  ],
  "isError": false
}
답변할 때는 원문을 그대로 길게 붙이지 말고 다음 기준으로 정리한다.
  • 항공: 항공사, 출발/도착 시각, 총 소요시간, 직항/경유, 가격, 예약 URL
  • 숙소: 숙소명, 지역, 1박/총액 가격, 평점, 핵심 장점, 상세 확인 필요 여부
  • 투어/TNA: 상품명, 시작가, 평점/리뷰, 포함사항 핵심, 날짜별 옵션 확인 결과, URL
  • 후보가 많으면 상위 3~5개만 비교
  • 가격·좌석·재고·예약 가능 여부는 실시간 변동 가능하다고 명시
包装器会将MCP 
CallToolResult
以JSON格式输出。通常可阅读的搜索结果会包含在
content[].text
中。
json
{
  "content": [
    {
      "type": "text",
      "text": "搜索结果 ..."
    }
  ],
  "isError": false
}
答复时请勿直接粘贴原文，需按以下标准整理：
  • 机票：航空公司、出发/到达时间、总耗时、直飞/中转、价格、预订URL
  • 住宿：住宿名称、地区、1晚/总价、评分、核心优势、是否需要查看详情
  • 旅游/TNA：产品名称、起步价、评分/评价、核心包含内容、日期选项确认结果、URL
  • 候选结果较多时仅对比前3~5个
  • 需明确说明价格·座位·库存·可预订情况可能实时变动

실패 상황과 대응

失败场景及应对

  • Python package 'mcp' is required
    : 
    python3 -m pip install mcp
    후 재시도한다.
  • MCP 엔드포인트 연결 실패: 
    MYREALTRIP_MCP_ENDPOINT
    오타, 네트워크, upstream 장애를 확인한다.
  • 빈 결과: 날짜/지역/인원/공항코드를 바꿔 재검색한다.
  • 항공 검색 실패: 국내/국제 도구 선택이 맞는지 확인한다. 해외 목적지는 반드시 
    searchInternationalFlights
    다.
  • 숙소 상세 실패: 
    searchStays
    결과의 
    gid
    가 최신인지 확인하고 같은 날짜로 다시 검색한다.
  • TNA 옵션 실패: 
    getTnaOptions
    에는 
    searchTnas
    결과의 
    gid
    와 
    url
    , 
    YYYY-MM-DD
    날짜가 모두 필요하다.
  • 캘린더 가격 불일치: 
    flightsFareCalendar
    는 캐시/추정값이므로 실제 검색 결과를 우선한다.
  • 예약/결제 요청: 자동화하지 말고 예약 URL을 제공해 사용자가 직접 진행하게 한다.
  • Python package 'mcp' is required
    : 执行
    python3 -m pip install mcp
    后重试
  • MCP端点连接失败：检查
    MYREALTRIP_MCP_ENDPOINT
    是否输入错误、网络状况或上游故障
  • 无结果：修改日期/地区/人数/机场代码后重新搜索
  • 机票搜索失败：确认国内/国际工具选择是否正确。海外目的地必须使用
    searchInternationalFlights
  • 住宿详情查询失败：确认
    searchStays
    结果中的
    gid
    是否为最新，使用相同日期重新搜索
  • TNA选项查询失败：
    getTnaOptions
    需要
    searchTnas
    结果中的
    gid
    、
    url
    及
    YYYY-MM-DD
    格式的日期
  • 日历价格不一致：
    flightsFareCalendar
    为缓存/估算值，优先以实际搜索结果为准
  • 预订/支付请求：不进行自动化处理，提供预订URL让用户自行操作

완료 기준

完成标准

  • 요청 유형에 맞는 MCP 도구를 선택했다.
  • 필요한 날짜, 인원, 공항/도시, 
    gid
    /
    url
    등 필수 입력을 확보했다.
  • 실제 MCP 호출 결과를 바탕으로 상위 후보를 요약했다.
  • 가격·재고·예약 가능 여부의 변동 가능성을 안내했다.
  • 예약/결제는 자동화하지 않고 마이리얼트립 URL을 제공했다.
  • 选择了符合请求类型的MCP工具
  • 获取了必要的日期、人数、机场/城市、
    gid
    /
    url
    等必填输入项
  • 基于实际MCP调用结果总结了候选结果
  • 告知了价格·库存·可预订情况的变动可能性
  • 未自动化预订/支付流程，提供了MyRealTrip的URL