메뉴 알림 받기 Slack · Discord · Teams LLM APIs 이용 약관

DEVELOPER API

Welplan 구내식당 메뉴 API

삼성웰스토리·신세계푸드 식당 검색과 날짜별 메뉴 조회를 위한 API 및 피드 문서입니다.

AI 어시스턴트로 사용하기

AI 어시스턴트는 아래 두 단계로 Welplan을 사용할 수 있습니다.

  1. 식당 검색 GET /proxy/search?q={키워드}

    JSON 배열을 반환합니다. 각 항목은 id, name, vendor, path를 포함합니다.

  2. 메뉴 조회 GET /restaurants/{vendor}/{id}/{slug}/{YYYYMMDD}

    날짜 세그먼트를 생략하면 오늘 메뉴로 이동합니다. Accept: text/markdown 헤더를 추가하면 마크다운으로 응답합니다.

/llms.txt — AI 어시스턴트를 위한 전체 사용 안내서

HTTP Endpoints

GET /proxy/search?q=...

키워드로 웰스토리·신세계푸드 식당을 검색합니다. JSON 배열로 응답합니다.

GET /restaurants/[vendor]/[id]/[slug]/[date]

식당의 하루 전체 메뉴 갤러리 페이지. Accept: text/markdown으로 메뉴 목록을 텍스트로 받을 수 있습니다.

GET /restaurants/[vendor]/[id]/[slug]/[date]/rss.xml

식당의 하루 메뉴 RSS 2.0 피드. 식사 시간별로 메뉴 목록을 HTML 리스트로 제공합니다.

GET /rss.xml

전체 식당의 향후 7일 메뉴 RSS 피드.

GET /api/health

서비스 상태 확인용 헬스체크 엔드포인트.

Markdown Negotiation

모든 HTML 페이지는 Accept: text/markdown 헤더를 통해 마크다운으로 응답합니다. 브라우저는 기존과 동일하게 HTML을 받습니다.

curl https://welplan.pmh.codes/restaurants/welstory/REST000007/r5-b1f/$(date +%Y%m%d) \
  -H "Accept: text/markdown"

Streamable HTTP MCP

표준 MCP 클라이언트에서 인증 없이 https://welplan.pmh.codes/mcp에 연결할 수 있습니다. 전송 방식은 Streamable HTTP이며 JSON 응답과 CORS를 지원합니다.

curl https://welplan.pmh.codes/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'
  • 식당 검색

    Search Welstory and Shinsegae Food cafeteria restaurants by name, location, or keyword.

    search_restaurants
  • 날짜별 식당 메뉴 조회

    Get every meal period and menu for a restaurant on a date. Use search_restaurants first.

    get_restaurant_menu

기존 브라우저 WebMCP도 유지됩니다. 지원 브라우저에서는 document.modelContextImperative API를 통해 3개 도구를 사용할 수 있습니다.

Discovery Endpoints

LLMs.txt

/llms.txt

AI 어시스턴트를 위한 사용 안내서 (llms.txt 표준).

OpenAPI

/openapi.json

OpenAPI 3.1 — 검색 및 메뉴 엔드포인트 명세.

Agent Skills

/.well-known/agent-skills/index.json

에이전트 스킬 탐색 인덱스 (SHA-256 다이제스트 포함).

API Catalog

/.well-known/api-catalog

RFC 9727 API 카탈로그 (application/linkset+json).

MCP Server Card

/.well-known/mcp/server-card.json

Streamable HTTP MCP 엔드포인트와 표준 도구 탐색용 서버 카드.

삼성웰스토리, 신세계푸드 및 각 사의 브랜드명, 식당명에 포함된 회사명·브랜드명 등 모든 상표는 해당 권리자에게 귀속됩니다. Welplan은 해당 상표권자 및 관련 회사와 제휴, 후원, 승인, 위탁, 대리 또는 그 밖의 공식 관계가 전혀 없는 독립적인 사이트 및 애플리케이션이며, 해당 회사들은 Welplan의 개발·운영·검수에 참여하지 않습니다. 서비스 이용약관, 개인정보 처리방침데이터 삭제 요청 안내를 확인할 수 있으며, 문의 및 건의사항은 GitHub 저장소 또는 pmh_only@pmh.codes로 연락해 주세요.