Communitygithub.com

Travel Price Planner

항공편, 호텔, 기차 및 복합 여행 일정을 총 비용과 위험도에 따라 비교하는 Codex 스킬입니다.

Travel Price Planner란 무엇인가요?

Travel Price Planner는 AI 에이전트가 항공편, 호텔, 기차 및 여러 교통 수단을 결합한 복합 여행 일정을 총 비용과 위험도 기준으로 비교하고 추천할 수 있도록 설계된 Codex 스킬입니다. 이 스킬은 단순한 최저가 검색을 넘어, 최종 지불 비용, 필수 추가 요금, 일정 적합성, 발권 주체, 애프터서비스, 환불/변경/취소 조건, 연결편 또는 숙박 위험 등을 종합적으로 평가하여 가장 합리적인 옵션을 제시합니다. 이 스킬은 Google Flights, Skyscanner와 같은 메타검색 엔진이나 공식 항공사/철도사 웹사이트 등 일반 웹 브라우저 접근을 통해 실시간 가격을 확인합니다. 사용자가 별도로 API 자격 증명을 제공하지 않는 한, 유료 API(Amadeus, Skyscanner 등)를 사용하지 않으며 로그인, 개인 정보 입력, 결제, 캡차 우회 등의 행위를 금지합니다. 위험 평가를 위해 OTA(온라인 여행사) 예약, 셀프 환승, 분리 발권, 환불 불가 숙소, 철도 대행사 등의 상황에 대한 위험 규칙을 참조하며, 점수 모델을 통해 각 옵션의 총 비용과 예약 위험도를 순위화합니다. 수집된 견적 데이터는 내장된 정규화 스크립트를 통해 CSV 형식으로 정리되어 일관된 비교표를 생성합니다. 최종적으로 사용자에게 최적 옵션, 가장 저렴한 수용 가능 옵션, 피해야 할 옵션, 구체적인 예약 경로(e.g. Google Flights -> 항공사 공식 사이트) 및 최종 결제 페이지에서 확인해야 할 사항을 제시합니다. 이 스킬은 Cursor, Codex, Claude Code 등 다양한 AI 에이전트 플랫폼에서 사용할 수 있도록 설계되었습니다.

지원 대상~Claude Code✓Codex CLI~Cursor
npx skills add AichenFilm/travel-price-planner-skill

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

여행 가격 플래너

핵심 규칙

최저 정가가 아닌, 가장 합리적인 옵션을 찾습니다. 예약 경로를 추천하기 전에 최종 지불 비용, 필수 추가 요금, 일정 적합성, 발권 주체, 애프터서비스, 환불/변경/취소 조건, 연결편 또는 숙박 위험을 비교합니다.

예약, 결제, 로그인, 개인 정보 입력, 자격 증명 저장, 캡차 우회, 또는 탐지 회피 스크래핑을 수행하지 마십시오. 구매 또는 계정 관련 작업 직전에 멈추고 명시적인 사용자 확인을 요청하십시오.

작업 흐름

  1. 누락된 영향력이 큰 제약 조건만 수집합니다: 날짜 유연성, 출발지/도착지 유연성, 여행자 수, 수하물, 도착 시간, 예산 상한, 환불 필요성, 결제 통화, 비자/경유 제한, 숙소 지역, 취소 필요성, 철도 시간 선호도.
  2. 사용자가 자신의 선호도를 밝히지 않았거나 재사용 가능한 선호도 템플릿이 필요할 때 references/default-preferences.md를 읽습니다.
  3. references/source-matrix.md를 읽어 여행 유형과 지역에 따라 검색 소스를 선택합니다.
  4. 일반 웹 또는 브라우저 접근을 통해 실시간 가격을 확인하며, 최종 확인이 중요할 때는 공식 소스를 우선 사용합니다. 소스 URL, 타임스탬프 및 시간대, 통화, 최종 표시 총액, 발권/예약 주체, 수하물 또는 조식, 취소/환불/변경 조건, 표시된 수수료를 기록합니다.
  5. 옵션에 OTA 예약, 셀프 환승, 분리 발권, 불명확한 수하물, 환불 불가 숙소, 철도 대행사, 경유 국가, 비정상적인 할인, 로그인 전용 가격, 또는 변동성이 큰 이벤트 기간이 포함될 때마다 references/risk-rules.md를 읽습니다.
  6. references/scoring-model.md를 읽어 총 비용과 예약 위험도에 따라 옵션 순위를 매깁니다.
  7. 견적 행이 많으면 CSV를 생성하고 scripts/normalize_travel_quotes.py를 실행하여 결정론적 비교표를 생성합니다. 이 스크립트는 수동으로 수집된 견적만 정규화하며 실시간 가격을 가져오지 않습니다.
  8. 다음을 포함한 추천을 제시합니다: 최적 종합 옵션, 가장 저렴한 수용 가능 옵션, 피해야 할 옵션, 정확한 예약 경로, 최종 결제 페이지에서 확인해야 할 사항.

소스 전략

  • 항공편: 날짜 및 경로 탐색을 위해 Google Flights와 같은 메타검색 소스로 시작한 후, 가장 유력한 일정을 항공사 공식 사이트에서 확인합니다. 의미 있는 가격 차이가 있는지 확인하기 위해서만 OTA 및 보조 메타검색 소스를 사용합니다.
  • 호텔: 지역 및 가격대 탐색을 위해 지도 또는 호텔 메타검색 소스로 시작한 후, 주요 OTA와 숙소 공식 사이트를 비교합니다. 최종 세금, 수수료, 객실 유형, 취소 조건, 보증금, 조식, 위치 조정 교통비를 비교합니다.
  • 기차: 운임 등급과 규정을 위해 공식 철도 운영사를 우선시합니다. 비교, 편의 또는 복합 교통편 발견을 위해 Trainline, Omio, Trip.com 또는 유사 대행사를 사용합니다.
  • Skyscanner, Amadeus, Duffel, Hotelbeds 또는 Expedia Rapid와 같은 API는 합법적인 계정과 사용자가 제공한 환경 변수가 필요합니다. API 접근 권한을 임의로 만들거나 구성되지 않은 라이브 API 적용을 암시하지 마십시오.

출력 기준

다음 등급을 구분합니다:

  • recommended: 최적의 총 비용/위험 균형.
  • cheapest acceptable: 실질적으로 예약 가능한 가장 저렴한 옵션.
  • optional: 수용 가능하지만 종합적으로 가장 강력하지도 않고 가장 저렴한 수용 가능 옵션도 아님.
  • cheaper but risky: 낮은 가격이지만 실질적인 애프터서비스, 환불, 수하물, 환승, 비자 또는 숨은 수수료 위험이 있는 옵션.
  • avoid: 사용자가 명시적으로 위험을 수락하지 않는 한 추천하지 않음.

각 추천 옵션에 대해 Google Flights -> 항공사 공식 사이트, Booking.com 환불 가능 요금, Trenitalia 공식 사이트, 12306 공식 사이트와 같은 구체적인 예약 경로를 포함하십시오.

정확성이 중요한 경우 원어 운임 규칙, 취소 텍스트, 수하물 규칙 및 플랫폼 이름을 유지한 후 사용자 언어로 명확히 설명하십시오.

스크립트 사용

견적 행을 수집한 후 정규화 도구를 사용하십시오:

python3 /path/to/travel-price-planner/scripts/normalize_travel_quotes.py quotes.csv --base-currency EUR --fx USD=0.92 --fx CNY=0.127 --direct-margin 50 --format markdown

이 스킬 디렉토리를 기준으로 스크립트 경로를 확인하십시오. 현재 작업 디렉토리가 스킬 디렉토리라고 가정하지 마십시오.

최소 필수 CSV 열:

label,category,source,currency,total_price,mandatory_fees,baggage_fee,payment_fee,local_transport_cost,risk_flags,booking_party,url,notes

위험 플래그는 세미콜론으로 구분됩니다. 예: ota;no_checked_bag;self_transfer;nonrefundable

최종 안전 확인

"지금 예약"을 추천하기 전에, 접근 가능하다면 결제 페이지 또는 공식 상세 페이지에서 옵션을 확인한 후 타임스탬프를 명시하십시오. 로그인 또는 개인 정보 입력 없이 최종 결제 페이지에 도달할 수 없으면 그 사실을 명시하고 가격을 잠정적인 것으로 처리하십시오.

관련 스킬