AI 어시스턴트로 사용하기

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

식당 검색 GET /proxy/search?q={키워드}
JSON 배열을 반환합니다. 각 항목은 id, name, vendor, path를 포함합니다.
메뉴 조회 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

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

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

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

브라우저 내 AI 어시스턴트가 WebMCP를 지원하면 아래 도구를 직접 호출할 수 있습니다.

식당 검색
Search Welstory and Shinsegae Food restaurants by name or keyword. Returns id, name, vendor, and path for each match.
welplan.search-restaurants
식당 메뉴 보기
Navigate to a restaurant's daily menu gallery page. Use search-restaurants first to obtain the vendor and id.
welplan.open-restaurant
현재 페이지 정보
Return a structured summary of the currently visible Welplan page.
welplan.get-current-page

/llms.txt

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

/openapi.json

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

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

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

/.well-known/api-catalog

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

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

WebMCP 도구 탐색용 서버 카드.