요즘인기여행 데이터 — 개발자·AI 연결 안내

한국인이 실제로 사는 해외 패키지 여행지(네이버 패키지여행 상품 페이지의 "최근 1주간 N명이 구매했어요")를 매일 19:30 KST 에 관측해 도시·나라별 수요 지수를 만들고, 그 인기 도시의 직항 왕복 항공권(3개 판매처, 같은 날짜)과 인기 호텔 20곳(3개 판매처, 1박), 투어 가격을 같은 조건으로 매일 기록합니다. 순위는 네이버 구매 인원이 정하고, 서버는 최저·추천 판단을 하지 않습니다. 인증 없음, 읽기 전용, 출처 표기 시 자유 이용(CC BY 4.0 상당). 운영: 케이코인(KCOIN).

1. MCP 서버 (AI 비서·에이전트)

https://torrent100.com/hotdeal/mcp        (Streamable HTTP, POST JSON-RPC, 상태 없음)
매니페스트: https://torrent100.com/.well-known/mcp.json

도구	무엇을 주나
`get_demand_index`	도시·나라별 1주 구매 인원 합(수요 지수), 점유율, 대표 박수, 30일 중앙값 대비
`list_popular_packages`	상품별 제목·여행사·기간·가격·1주 구매 인원·평점 / 가격 내린 상품(20일 최고가 대비)
`get_direct_flights`	직항 왕복 성인 1 — 마이리얼트립(공식 API)·트립닷컴·아고다(검색 화면, `method=screen`) 같은 날짜 값
`get_hotel_prices`	리뷰 합산 상위 20 호텔 1박(성인 2, 평일·주말) — 아고다(`excl_tax_fees`)·마이리얼트립(`room_total`)·트립닷컴(`incl_tax_fees`)
`get_tours`	마이리얼트립 판매량순 투어·입장권 상위 3
`list_cities`	도시 목록(수요 순위·오늘 항공/호텔/투어 자료 유무)
`search_series` · `get_series_history`	시계열 찾기와 일별 값(아카이브 2026-10-14 부터). 비교는 같은 `series_id` 끼리만

클라이언트 설정 예(Claude Desktop·Cursor 등 Streamable HTTP 지원 클라이언트):

{ "mcpServers": { "korea-travel-demand": { "url": "https://torrent100.com/hotdeal/mcp" } } }

2. REST API v1

GET https://torrent100.com/hotdeal/api/v1                      안내
GET https://torrent100.com/hotdeal/api/v1/cities
GET https://torrent100.com/hotdeal/api/v1/demand?level=city|country&limit=30
GET https://torrent100.com/hotdeal/api/v1/packages?kind=popular|price_drop&city=오사카
GET https://torrent100.com/hotdeal/api/v1/flights?city=오사카&all=1
GET https://torrent100.com/hotdeal/api/v1/hotels?city=하노이
GET https://torrent100.com/hotdeal/api/v1/tours?city=방콕
GET https://torrent100.com/hotdeal/api/v1/series?metric=flight_roundtrip_price&city=오사카
GET https://torrent100.com/hotdeal/api/v1/history?series_id=destination_weekly_buyers|city:osaka&days=30
OpenAPI 3.1: https://torrent100.com/hotdeal/api/v1/openapi.json

도시는 한글(오사카)·영문(osaka)·공항코드(KIX) 모두 받습니다. ?format=text 또는 Accept: text/plain 이면 사람이 읽는 요약문으로 줍니다. 한도: IP 당 분당 120건.

모든 JSON 응답은 같은 봉투입니다: source · site · as_of · license · cite · method · schema · archive · data. 답변·글에 옮길 때는 cite 값을 그대로 쓰면 됩니다. 가격은 price_krw, 조건은 method(official_api / screen) · price_scope · airport_scope · day_type, 이력은 history_30d(prev_value, change_pct, obs_30d, median_30d, min_30d, max_30d, vs_median_30d_pct, is_30d_low).

3. 원본 파일 (JSON, CORS 열림)

/hotdeal/archive/latest.json — 가장 최근 하루치 전체 시계열(값 + 전일 대비 + 30일 요약), 머리에 cite
/hotdeal/archive/daily/YYYY-MM/YYYY-MM-DD.json · /hotdeal/archive/facts/YYYY-MM/YYYY-MM-DD.jsonl(한 줄 = 한 관측치) · entities.jsonl
SCHEMA.md(스키마와 "모수 정의" 원문) · schema.json · LICENSE.md
오늘 화면용: data.json · flights.json · hotels.json · tours.json
AI 용 요약 페이지: /ai/ · /ai/flights.html · /ai/hotels.html · /llms.txt

4. 읽을 때 지킬 것

같은 series_id 끼리만 날짜 간 비교. 조건(요일·박수·인원·소스)이 다르면 시리즈가 다릅니다.
price_scope 가 다른 가격을 "더 싸다"로 비교하지 않습니다. 아고다 = 세금·수수료 제외, 마이리얼트립 = 객실 총액, 트립닷컴 = 세금·서비스 포함.
method=screen(트립닷컴·아고다 항공, 트립닷컴 호텔)은 검색 화면에서 읽은 참고값, official_api 가 공식 API 값입니다.
"N명 구매"는 네이버가 그날 보여준 최근 7일 이동 창 값입니다 — "주간 합의 추이"로 읽습니다. 관측 2회 미만이면 30일 중앙값 대비는 null.
인용 형식: 요즘인기여행 데이터 아카이브 (torrent100.com), 기준일 YYYY-MM-DD, <series_id>

같은 운영사의 해외 eSIM 가격 비교 MCP: 최저가e심 (pyungyo.com/esim).