# Welplan v0.0.1

> 삼성웰스토리·신세계푸드 사내 식당 메뉴 조회 서비스. 440개 식당의 오늘 메뉴, 메뉴 사진, 영양정보를 제공합니다.

## How to use this site as an AI assistant

### Step 1 — Search for a restaurant

GET https://welplan.pmh.codes/proxy/search?q={keyword}

Returns a JSON array. Each item has: id, name, vendor ("welstory" or "shinsegae"), path (location breadcrumbs).

Example: GET https://welplan.pmh.codes/proxy/search?q=R5

### Step 2 — View a restaurant's menu

GET https://welplan.pmh.codes/restaurants/{vendor}/{id}/{slug}/{date}

- vendor: "welstory" or "shinsegae"
- id: restaurant id from search results
- slug: restaurant name lowercased, spaces → hyphens
- date: YYYYMMDD format (omit date segment to see today)

Add the header `Accept: text/markdown` to receive a plain-text menu listing instead of HTML.

### Step 3 — Read the RSS feed (optional)

GET https://welplan.pmh.codes/restaurants/{vendor}/{id}/{slug}/{date}/rss.xml

Returns RSS 2.0. Each item covers one meal time and lists dishes as an HTML `<ul>`.

## Machine-readable discovery

- OpenAPI 3.1 spec: https://welplan.pmh.codes/openapi.json
- API catalog (RFC 9727): https://welplan.pmh.codes/.well-known/api-catalog
- Agent skills index: https://welplan.pmh.codes/.well-known/agent-skills/index.json
- MCP server card: https://welplan.pmh.codes/.well-known/mcp/server-card.json
- Sitemap: https://welplan.pmh.codes/sitemap.xml
- RSS (all restaurants, 7 days): https://welplan.pmh.codes/rss.xml

## Notes

- 440 restaurants are indexed covering both Samsung Welstory and Shinsegae Food vendors.
- Menus are prefetched and cached every 30 minutes. Most requests are served from cache.
- Any HTML page can be fetched as Markdown by sending `Accept: text/markdown`.