한국 모든 숙박·관광·문화 데이터 API

"K-STAY API에서 한옥체험업 영업중 통계 가져와서 분석해줘:
 https://k-stay.ai/api/hanok/stats"

curl -s https://k-stay.ai/api/tourism/inbound | jq '.by_country_2025[:5]'

K-STAY Open API는 한국 숙박·관광 데이터를 제공합니다.
- Base: https://k-stay.ai/api
- 인증: 불필요
- 주요 엔드포인트:
  - /stats (외도민업 통계)
  - /hanok/stats (한옥체험업)
  - /tourism/inbound (외국인 관광객)
  - /festivals (전국 축제)
- 자세한 스펙: https://k-stay.ai/openapi.json

# 외도민업 종합 통계
curl https://k-stay.ai/api/stats

# 서울 한옥체험업만
curl "https://k-stay.ai/api/hanok/listings?sido=서울특별시&limit=100"

# 외국인 관광객 통계
curl https://k-stay.ai/api/tourism/inbound

# 이번 달 축제
curl https://k-stay.ai/api/festivals

// Node.js / 브라우저 동일
const res = await fetch('https://k-stay.ai/api/hanok/stats');
const data = await res.json();
console.log(data.overview.active); // 2522

// 카카오맵 + K-STAY API
const listings = await fetch(
  'https://k-stay.ai/api/hanok/listings?sido=경상북도&limit=500'
).then(r => r.json());

listings.listings.forEach(h => {
  new kakao.maps.Marker({
    position: new kakao.maps.LatLng(h.lat, h.lng),
    title: h.name
  });
});

import requests

# 한옥체험업 통계
data = requests.get('https://k-stay.ai/api/hanok/stats').json()
print(f"영업중: {data['overview']['active']}곳")

# 외국인 관광객 — pandas로 분석
import pandas as pd
tourism = requests.get('https://k-stay.ai/api/tourism/inbound').json()
df = pd.DataFrame(tourism['by_country_2025'])
print(df.nlargest(5, 'visitors'))

MCP (Model Context Protocol) 서버 — 네이티브 통합 ✅

K-STAY 공식 MCP 서버가 준비 완료되었습니다. Claude Desktop·Claude Code·Cursor에서 K-STAY의 모든 데이터를 16개 native 도구로 사용할 수 있습니다.

🚀 Claude Desktop 설정

설정 파일 위치:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

다음 내용을 추가하고 Claude Desktop 재시작:

{
  "mcpServers": {
    "k-stay": {
      "command": "npx",
      "args": ["-y", "@k-stay/mcp-server"]
    }
  }
}

🛠️ Claude Code (CLI) 설정

claude mcp add k-stay -- npx -y @k-stay/mcp-server

📋 제공 도구 16개

# 통계 및 메타
get_stats · get_categories_overview · get_registrations_monthly
get_data_sources · get_monthly_report

# 한옥 (51 마을 + 55 명품고택 + 2,522 영업장)
get_hanok_stats · search_hanok_listings
get_hanok_villages · get_meongpum_gotaek

# 숙박 카테고리
get_temple_stays · search_lodging · get_lodging_stats

# 관광·문화
get_inbound_tourism · get_kculture_hotspots
get_korea100 · get_festivals

💬 사용 예시 (자연어 → 도구 호출 자동)

# 사용자가 자연어로 물으면 Claude가 알아서 호출
"한옥체험업이 가장 많은 시군구 5곳"
→ Claude: (get_hanok_stats 호출)
  경주시 363, 종로구 332, 전주시 298, 안동시 184, 순천시 74곳

"10월 외국인 많이 오는 축제는?"
→ Claude: (get_festivals with month=10)
  진주남강유등 280만명, 안동탈춤 150만명...

"서울 한옥 체험할 곳 5개 추천"
→ Claude: (search_hanok_listings with sido='서울특별시', limit=5)
  ...

🔗 GitHub · 로컬 빌드

git clone https://github.com/josanku/wehome-insight.git
cd wehome-insight/mcp-server
npm install && npm run build
node dist/index.js   # stdio MCP 서버 기동

자세한 안내: github.com/josanku/wehome-insight/tree/main/mcp-server