TL;DR

  • Hermes는 Ryanair 항공권 가격을 대상으로 모든 관측값을 보존하는 REST API·MCP 서버를 제공하며, 무료·회원가입 없이 과거 운임 조회가 가능함
  • 8,710만 건의 운임 관측값과 5,278개 노선, 224개 공항, 36개 국가를 다루는 규모임
  • MCP 서버는 6개 읽기 전용 도구로 AI 비서가 최저가, 가격 이력, 가격 하락, 목적지를 조회하도록 지원함
  • REST API는 공항·노선·최저가·가격 시계열·가격 변동·국가별 최저가 목적지 조회를 제공하며, 게스트 등급은 노선별 30일 이력과 IP당 분당 요청 제한이 적용됨
  • Ryanair와 제휴하지 않은 비공식 서비스이며, 운임은 제안 가격이 아닌 관측값이므로 예약 전 ryanair.com에서 확인해야 함

Ryanair 항공권 가격 API

  • Hermes는 Ryanair 항공권 가격을 위한 비공식 REST API이자 MCP 서버이며, 무료이고 회원가입이 필요하지 않음.
  • 모든 관측값을 보존하므로 지난주 운임도 확인할 수 있음. Ryanair 자체 엔드포인트는 현재 가격만 확인함.
  • 제공 문서는 Swagger UI, OpenAPI 3.1, ReDoc, llms.txt로 구성됨.
  • 운임 관측값은 8,710만 건이며, 추가 전용 방식으로 저장되고 덮어쓰지 않음.
  • 활성 노선은 5,278개이며, 224개 공항과 36개 국가를 포함함.
  • 전체 엔드포인트에서 처리한 누적 요청은 99,382건이며, 최근 24시간 요청은 19,913건임.
  • 요청 통계는 시간별 버킷으로 집계되며 피크 기준으로 정규화됨.

MCP 서버

  • AI 비서를 Hermes에 연결하면 항공편 관련 질문에 답변하도록 구성할 수 있음.
  • MCP 엔드포인트는 다음과 같음: https://hermes.brinkhorst.dev/mcp
  • HTTP 전송 방식으로 Claude에 추가하는 명령은 claude mcp add --transport http hermes https://hermes.brinkhorst.dev/mcp임.
  • JSON 설정을 지원하는 클라이언트에서는 다음 엔드포인트를 hermes 서버로 등록함.
  • 서버 유형은 http이며 URL은 https://hermes.brinkhorst.dev/mcp임.
  • 읽기 전용 도구 6개는 다음과 같음.
  • get_cheapest_fares: 노선별 날짜 최저 운임
  • get_price_history: 관측된 가격 시계열
  • find_price_drops: 네트워크 전체에서 최근 변동한 운임
  • explore_destinations: 현재 위치에서 갈 수 있는 목적지를 최저가 순으로 탐색
  • search_airports: 공항 검색
  • list_routes: 노선 목록 조회
  • “10월에 더블린에서 바르셀로나까지 60유로면 좋은 가격인가?”와 같은 질문을 시도할 수 있음.

REST 빠른 시작

  • https://hermes.brinkhorst.dev/api/v1/routes/DUB/BCN/cheapest는 더블린-바르셀로나 노선의 날짜별 최저 운임을 조회함.
  • https://hermes.brinkhorst.dev/api/v1/anomalies/?kind=drop&limit=10은 최근 가격 하락 이상값 10건을 조회함.
  • 주요 엔드포인트는 다음과 같음.
  • GET /api/v1/airports/: 공항 목록 조회 및 국가·기지별 필터링
  • GET /api/v1/routes/: 방향성이 있는 노선 목록 조회
  • GET /api/v1/routes/{origin}/{destination}/cheapest: 출발지·도착지 노선의 최저 운임 조회
  • GET /api/v1/routes/{origin}/{destination}/history: 가격 시계열 조회
  • GET /api/v1/anomalies/: 최근 가격 하락 및 급등 조회
  • GET /api/v1/explore?country=es: 특정 국가에서 출발하는 최저가 목적지 조회
  • 게스트 등급은 API 키 없이 사용하며, 노선별 30일 가격 이력, IP당 분당 목록·상세 요청 120건, 시계열 요청 30건 제한이 적용됨.

노선 탐색

  • 노선 URL은 브라우저에 페이지를 반환하고 클라이언트에는 JSON을 반환함.
  • 주요 노선은 다음과 같음.
  • 오르후스 → 말라가 (AAR–AGP)
  • 오르후스 → 코르푸 (AAR–CFU)
  • 오르후스 → 그단스크 (AAR–GDN)
  • 오르후스 → 카토비체 (AAR–KTW)
  • 오르후스 → 팔마데마요르카 (AAR–PMI)
  • 오르후스 → 리가 (AAR–RIX)
  • 오르후스 → 런던 스탠스테드 (AAR–STN)
  • 오르후스 → 자다르 (AAR–ZAD)
  • 애버딘 → 말라가 (ABZ–AGP)
  • 애버딘 → 알리칸테 (ABZ–ALC)
  • 애버딘 → 파루 (ABZ–FAO)
  • 애버딘 → 크라쿠프 (ABZ–KRK)
  • 란사로테 → 말라가 (ACE–AGP)
  • 란사로테 → 알리칸테 (ACE–ALC)
  • 란사로테 → 벨파스트 국제공항 (ACE–BFS)
  • 란사로테 → 밀라노 베르가모 (ACE–BGY)
  • 란사로테 → 버밍엄 (ACE–BHX)
  • 란사로테 → 볼로냐 (ACE–BLQ)
  • 란사로테 → 본머스 (ACE–BOH)
  • 란사로테 → 브리스틀 (ACE–BRS)
  • 란사로테 → 브라티슬라바 (ACE–BTS)
  • 란사로테 → 브뤼셀 샤를루아 (ACE–CRL)
  • 란사로테 → 더블린 (ACE–DUB)
  • 란사로테 → 에든버러 (ACE–EDI)
  • 전체 목록에는 5,278개 노선, 224개 공항, 최근 가격 하락이 포함됨.

질문

공식 Ryanair API가 있는가?

  • 운임을 위한 공개 API는 없음.
  • Ryanair의 내부 엔드포인트는 문서화되지 않았고 불안정하며, Hermes는 이를 버전이 지정된 OpenAPI 3.1 계약 뒤에서 래핑함.

항공권 가격용 MCP 서버가 있는가?

  • Hermes가 해당 서버임.
  • /mcp에서 스트리밍 가능한 HTTP 방식으로 제공되며, 키 없이 6개 읽기 전용 도구를 사용할 수 있음.

Ryanair와 제휴한 서비스인가?

  • Ryanair와 제휴하지 않았고 Ryanair의 보증을 받지 않음.
  • 운임은 제안 가격이 아닌 관측값이므로 예약 전 ryanair.com에서 확인해야 함.

비용은 얼마인가?

  • 무료이며 회원가입이 필요하지 않음.
  • 게스트 등급의 요청 제한이 적용됨.
  • Hermes는 Victor Brinkhorst가 구축하고 운영함.
  • 비공식 서비스이며 Ryanair와 제휴하지 않음.