Skill

myrealtrip-search

Searches flights, stays, tours/tickets/activities via MyRealTrip's official Streamable HTTP MCP server. Returns details, prices, and booking links without scraping.

Python

api-development

npx claudepluginhub nomadamas/k-skill --plugin k-skill

Popularity

Stars

5,395

Forks

592

Invocation

How this skill is triggered — by the user, by Claude, or both

Slash command

/k-skill:myrealtrip-search

User invocable

Model invocable

Inline context

Default effort

Context Preview

The summary Claude sees in its skill listing — used to decide when to auto-load this skill

마이리얼트립 공식 개발자센터의 MCP 문서에 공개된 엔드포인트를 사용해 여행 검색을 수행한다.

Supporting Files

scripts/myrealtrip_mcp.pyscripts/test_myrealtrip_mcp.py

SKILL.md

250 lines · ~1.8k tokens

Similar Skills

flight-ticket-search

5.4k

Searches Google Flights for flight tickets, returns candidates with prices, booking links, and date/month/year comparisons. Useful for checking cheapest flights and planning travel.

1 file

k-skill

flyai

642

Searches flights, hotels, attractions, concerts, cruises, visas, car rentals, and event tickets with natural language via Fliggy MCP for real-time booking and trip planning.

8 files

flyai

airnz-flights

Search public Air New Zealand fare snapshots and timetable data via lightweight CLI. No login or booking. Use for flight numbers, times, duration, stops on NZ domestic routes.

4 files

nz-skills

Stats

LanguageJavaScript

Stars5,395

Forks592

MaintenanceExcellent

Last CommitJun 6, 2026

Actions

View Source View Plugin View on GitHub View README

Help us improve

Share bugs, ideas, or general feedback.

Stats

Actions

Help us improve

Share bugs, ideas, or general feedback.

마이리얼트립 검색

이 스킬이 하는 일

마이리얼트립 공식 개발자센터의 MCP 문서에 공개된 엔드포인트를 사용해 여행 검색을 수행한다.

MCP 엔드포인트: https://mcp-servers.myrealtrip.com/mcp
문서: https://docs.myrealtrip.com/#/api/mcp/overview
연결 가이드: https://docs.myrealtrip.com/#/api/mcp/setup
인증: 문서 기준 별도 인증 없음

지원 범위:

국내선/국제선 항공권 검색
항공권 날짜별 최저가 캘린더와 프로모션 항공사 조회
숙소 검색 및 상세/객실/리뷰/편의시설 조회
투어·티켓·액티비티 검색, 상세, 날짜별 옵션/가격/예약 가능 여부 조회
현재 한국 시간(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 선택자나 브라우저 자동화에 의존하지 않는다.

사용할 때

"마이리얼트립에서 제주 항공권 찾아줘"
"다음 주 오사카 가는 최저가 항공권 봐줘"
"부산 해운대 호텔 2박 검색해줘"
"이 호텔 객실 타입이랑 취소정책 자세히 봐줘"
"오사카 유니버설 스튜디오 티켓 가격 확인해줘"
"도쿄 디즈니랜드 날짜별 옵션 확인해줘"
"항공권 특가 항공사 있어?"

사용하지 않을 때

실제 예약/결제/로그인이 필요한 경우
마이리얼트립 계정의 예약 내역이나 개인화 데이터가 필요한 경우
항공권·숙소·투어 외의 파트너 API 수익/예약 내역 조회가 목적일 때
가격·재고를 법적/회계적 증빙 수준으로 확정해야 할 때

준비 사항

Python MCP SDK가 필요하다. 없으면 설치한다.

python3 -m pip install mcp

기본 엔드포인트는 공식 문서의 URL이다. 필요할 때만 환경변수로 바꾼다.

export MYREALTRIP_MCP_ENDPOINT="https://mcp-servers.myrealtrip.com/mcp"

Hermes Agent에 MCP 서버로 직접 등록하려면 다음 설정을 쓸 수 있다.

mcp_servers:
  myrealtrip:
    url: "https://mcp-servers.myrealtrip.com/mcp"

CLI별 공식 연결 명령은 문서 기준 다음과 같다.

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. 요청 유형을 분류한다

국내 항공: 출발지와 도착지가 모두 한국 도시/공항이면 searchDomesticFlights
국제 항공: 목적지가 해외면 searchInternationalFlights
날짜 유연 항공 최저가: flightsFareCalendar 후 실제 검색 도구로 재확인
숙소 목록: searchStays
특정 숙소 상세/객실/리뷰/편의시설: searchStays로 gid 확보 후 getStayDetail
투어·티켓·액티비티 목록: searchTnas
도시별 카테고리 필터가 필요하면 getCategoryList 후 searchTnas
특정 투어 상세: searchTnas 결과의 gid, url로 getTnaDetail
날짜별 실제 옵션/가격/가능 여부: getTnaOptions

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

python3 myrealtrip-search/scripts/myrealtrip_mcp.py tools

3. 항공권 검색

국내선은 두 공항이 모두 한국일 때만 사용한다.

python3 myrealtrip-search/scripts/myrealtrip_mcp.py call searchDomesticFlights \
  --arg origin=GMP \
  --arg destination=CJU \
  --arg departDate=2026-05-20 \
  --arg maxResults=10

국제선은 해외 목적지일 때 사용한다. 사용자가 출발 공항을 말하지 않으면 인천(ICN)을 기본값으로 둔다.

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}'

날짜가 유동적인 최저가 요청은 캘린더를 먼저 본다. 캘린더 가격은 캐시/추정값이므로, 최종 답변 전에 실제 검색 도구로 후보 날짜를 다시 확인한다.

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

특가/할인 항공사 요청은 프로모션 항공사를 먼저 확인한다.

python3 myrealtrip-search/scripts/myrealtrip_mcp.py call getPromotionAirlines

4. 숙소 검색과 상세 조회

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로 상세를 이어서 호출한다.

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. 투어/티켓/액티비티 검색과 옵션 확인

도시별 카테고리 필터를 쓰려면 카테고리 값을 추측하지 말고 먼저 조회한다.

python3 myrealtrip-search/scripts/myrealtrip_mcp.py call getCategoryList --arg city=Osaka

검색어는 한국어가 가장 잘 맞는다.

python3 myrealtrip-search/scripts/myrealtrip_mcp.py call searchTnas \
  --arg query="오사카 유니버설 스튜디오" \
  --arg perPage=5

상세는 검색 결과의 gid와 url을 같이 넘긴다.

python3 myrealtrip-search/scripts/myrealtrip_mcp.py call getTnaDetail \
  --json '{"gid":"123456","url":"https://www.myrealtrip.com/offers/123456"}'

날짜별 예약 가능 여부와 실제 가격은 getTnaOptions로 확인한다.

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`

응답 형식

래퍼는 MCP CallToolResult를 JSON으로 출력한다. 보통 content[].text에 사람이 읽을 수 있는 검색 결과가 들어온다.

{
  "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을 제공해 사용자가 직접 진행하게 한다.

완료 기준

요청 유형에 맞는 MCP 도구를 선택했다.
필요한 날짜, 인원, 공항/도시, gid/url 등 필수 입력을 확보했다.
실제 MCP 호출 결과를 바탕으로 상위 후보를 요약했다.
가격·재고·예약 가능 여부의 변동 가능성을 안내했다.
예약/결제는 자동화하지 않고 마이리얼트립 URL을 제공했다.

myrealtrip-search

Popularity

Invocation

Context Preview

Supporting Files

SKILL.md

Similar Skills

Help us improve

Help us improve

Find plugins for your project

myrealtrip-search

Popularity

Invocation

Context Preview

Supporting Files

SKILL.md

마이리얼트립 검색

이 스킬이 하는 일

동작 방식

사용할 때

사용하지 않을 때

준비 사항

사용 흐름

1. 요청 유형을 분류한다

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

3. 항공권 검색

4. 숙소 검색과 상세 조회

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

사용 가능한 도구

응답 형식

실패 상황과 대응

완료 기준

Similar Skills

Help us improve

마이리얼트립 검색

이 스킬이 하는 일

동작 방식

사용할 때

사용하지 않을 때

준비 사항

사용 흐름

1. 요청 유형을 분류한다

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

3. 항공권 검색

4. 숙소 검색과 상세 조회

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

사용 가능한 도구

응답 형식

실패 상황과 대응

완료 기준