Developer resources · 식권대장

식권대장 개발자 리소스

식권대장은 외부 에이전트와 개발자가 지역 식당 카탈로그를 안전하게 읽고 서비스의 구현 맥락을 확인할 수 있도록 문서와 기계 판독 가능한 계약을 제공합니다. 아래 리소스는 모두 공개 읽기 중심이며, 식당 추가·수정·삭제나 리뷰 원본의 임의 변경을 위한 쓰기 API는 제공하지 않습니다.

읽기 전용 REST API

/api/restaurants는 배포에 포함된 식당 카탈로그를 반환합니다. 목록 화면은?view=summary로 가벼운 메뉴 요약을 요청하고, 특정 식당은 ?id=식당ID로 상세 정보를 조회합니다. 외부 Firebase가 일시적으로 응답하지 않아도 정적 카탈로그를 대체 응답으로 사용하므로 에이전트는 빈 결과를 곧바로 폐점이나 품절로 해석하지 않아야 합니다.

OpenAPI 3.1 JSON 보기 →

MCP Streamable HTTP

MCP를 지원하는 에이전트는 /.well-known/mcp에 JSON-RPC 2.0 요청을 보내initialize, tools/list, tools/call 순서로 사용할 수 있습니다.search_restaurants는 이름·메뉴·카테고리로 정적 카탈로그를 찾고,get_restaurant는 식당 ID 또는 이름으로 한 건을 읽습니다. 요청에는Accept: application/json, text/event-stream를 포함하고, Origin을 위조한 브라우저 요청은 차단됩니다.

MCP 엔드포인트 확인 →

데이터 신뢰 범위

기본 식당명·좌표·카테고리는 소스 데이터셋에 포함된 값입니다. 리뷰 평점과 K밥상 오늘 메뉴는 별도 데이터 경로에서 갱신될 수 있으며, 영업시간·가격·메뉴는 방문 시점에 달라질 수 있습니다. 에이전트는 결과를 소개할 때 이 신뢰 범위를 함께 설명하고, 최신성이 중요한 질문에는 연결된 지도나 식당의 공식 안내를 확인하도록 권장해야 합니다. 데이터 오류 제보와 API 연동 문의는 문의 페이지를 사용하세요.

Vercel 배포와 인증 경계

식권대장은 Vercel에서 Next.js 애플리케이션으로 배포되며, 공개 식당 조회 API와 MCP 도구는 읽기 전용으로 제공됩니다. 관리용 Cron 엔드포인트와 외부 데이터 갱신 자격증명은 공개 개발자 API에 포함하지 않습니다. 에이전트가 자동화된 갱신 작업을 요청하더라도 공개 도구로 쓰기를 시도하지 말고, 데이터 오류 제보나 운영 문의는 문의 페이지로 안내하세요. 이 경계를 지키면 검색·추천 작업과 운영 데이터 변경 작업을 구분할 수 있습니다.

기계 판독 리소스