Naver Booking MCP

국내 네이버 예약 가능 장소를 조회하는 MCP 서버입니다. 현재는 네이버 지도 검색을 자동 수집하지 않고, data/places.json에 seed로 등록한 네이버 예약 업체의 실시간 예약 가능 시간을 조회합니다. 미용실에 한정하지 않고 네이버 예약 businessId가 있는 장소라면 카테고리와 관계없이 등록할 수 있습니다.

Run as MCP

npm run mcp

MCP 클라이언트 설정 예시:

{
  "mcpServers": {
    "naver-booking": {
      "command": "node",
      "args": [
        "/Users/a1101417/Workshop/laboratory/naver-booking-mcp/src/mcp-server.js"
      ]
    }
  }
}

Available tools:

• find_available_naver_bookings: 국내 지역/카테고리/날짜 기준 예약 가능 장소 조회
• get_naver_booking_availability: businessId 1개 예약 가능 시간 조회
• list_seeded_naver_booking_places: 현재 seed로 등록된 조회 가능 장소 목록
• search: ChatGPT connector compatibility search tool
• fetch: ChatGPT connector compatibility detail fetch tool

Run as Remote MCP

ChatGPT custom connectors need a remote MCP endpoint over HTTPS. This server exposes both HTTP/SSE and plain JSON-RPC HTTP endpoints:

PORT=8788 npm run remote

Local endpoints:

http://localhost:8788/sse
http://localhost:8788/mcp

AWS endpoint before TLS:

http://13.236.119.240:8788/sse

For ChatGPT, put this behind HTTPS with a domain, then use:

https://YOUR_DOMAIN/sse

Run locally

REST API도 같이 남겨두었습니다. 단순 HTTP 테스트가 필요할 때 사용합니다.

npm run dev

Health check:

curl http://localhost:8787/health

Search availability:

curl 'http://localhost:8787/availability?query=강남&limit=3'

List registered places:

curl 'http://localhost:8787/places?query=강남'

Check one place:

curl 'http://localhost:8787/places/992240/availability'

GPT Action setup

GPT Actions require an externally reachable HTTPS URL and an OpenAPI schema. For local testing, expose this server with a tunnel such as ngrok or Cloudflare Tunnel, then import:

https://YOUR_PUBLIC_HOST/openapi.yaml

In the GPT editor:

1. Create or edit a GPT.
2. Open Actions and choose Create new action.
3. Authentication: None for local/private testing, or add API key auth at your gateway if exposing publicly.
4. Import the schema from /openapi.yaml or paste openapi.yaml.
5. Use instructions like:

When the user asks for Naver reservations near a domestic Korea location, call findAvailableNaverBookings.
Return only places with available=true. Include the earliest few available times and the bookingUrl.
Say that availability can change in real time.
If the user specifies a category such as hair salon, restaurant, hospital, activity, class, or accommodation, pass it as category. Otherwise use category=all.

OpenAI's GPT Actions docs state that actions connect a GPT to external APIs through authentication plus an OpenAPI schema.

Seed data

Edit data/places.json to add more places:

{
  "businessId": "992240",
  "name": "디온드헤어 강남역점",
  "country": "KR",
  "region": "서울 강남구",
  "area": "강남역",
  "category": "beauty",
  "keywords": ["강남", "강남역", "미용실", "헤어"],
  "bookingUrl": "https://m.booking.naver.com/booking/13/bizes/992240"
}

Limitations

• Naver Map search returned ncaptcha for automated place-list collection in testing.
• This API does not bypass captcha or login.
• It checks known Naver Booking businessId values only. Add restaurants, clinics, classes, activities, and other reservable places to data/places.json as you collect IDs.
• Booking availability is real-time and can change before the user opens the Naver page.