public-restroom-nearby

SKILL.md

Public Restroom Nearby

What this skill does

유저가 알려준 현재 위치를 기준으로 근처 공중화장실 / 개방화장실 을 찾는다.

위치는 자동으로 추정하지 않는다.

반드시 먼저 현재 위치를 질문한다.

화장실 데이터는 공식 공중화장실정보 표준데이터를 기본으로 사용한다.

KAKAO_REST_API_KEY 또는 kakaoRestApiKey 옵션이 있으면 Kakao Local REST API로 공중화장실, 개방화장실, OL7 주유소를 추가 조회해 병합한다.

위치 문자열은 Kakao Map anchor 검색으로 좌표를 잡고, 가능한 경우 해당 시도 데이터만 좁혀서 조회한다.

좌표를 직접 받으면 바로 nearby 계산으로 들어간다.

When to use

"근처 화장실 찾아줘"

"서울역 근처 공중화장실 있어?"

"광화문 주변 개방화장실 몇 군데만 보여줘"

"지금 여기서 가까운 화장실 지도 링크 줘"

Mandatory first question

위치 정보 없이 바로 검색하지 말고 반드시 먼저 물어본다.

권장 질문: 현재 위치를 알려주세요. 동네/역명/랜드마크/위도·경도 중 편한 형식으로 보내주시면 근처 공중화장실을 찾아볼게요.

위치가 애매하면: 가까운 역명이나 동 이름으로 한 번만 더 알려주세요.

Official surfaces

공공데이터포털 공중화장실 표준데이터 안내: https://www.data.go.kr/data/15012892/standard.do

전국 CSV: https://file.localdata.go.kr/file/download/public_restroom_info/info

지역별 CSV: https://file.localdata.go.kr/file/download/public_restroom_info/info?orgCode=<시도코드>

파일 소개 페이지: https://file.localdata.go.kr/file/public_restroom_info/info

Kakao Map 모바일 검색: https://m.map.kakao.com/actions/searchView?q=<query>

Kakao Map 장소 패널 JSON: https://place-api.map.kakao.com/places/panel3/<confirmId>

Workflow

유저에게 반드시 현재 위치를 묻는다.

위치 문자열을 받으면 Kakao Map으로 anchor 후보를 고르고 좌표를 확보한다.

anchor 주소에서 시도(서울/경기/부산 등)를 추론할 수 있으면 해당 지역 CSV로 좁힌다.

공식 공중화장실정보 CSV를 내려받고, Kakao REST API 키가 있으면 keyword.json?query=공중화장실, keyword.json?query=개방화장실, category.json?category_group_code=OL7 결과를 추가한다.

Kakao distance 필드는 버리고 모든 결과를 위·경도 haversine 거리로 직접 재계산한다.

좌표 50m 이내 중복은 동일 시설로 보고 CSV 결과를 우선 보존한다.

보통 3~5개만 짧게 정리하고, 필요하면 URL 인코딩된 지도 링크(map.kakao.com/link/map/...)를 같이 준다.

Responding

결과는 보통 아래 필드를 포함해 짧게 정리한다.

화장실명

구분명(공중화장실 / 개방화장실)

거리

주소

개방시간/상세

지도 링크

Node.js example

const { searchNearbyPublicRestroomsByLocationQuery } = require("public-restroom-nearby");

async function main() {
  const result = await searchNearbyPublicRestroomsByLocationQuery("광화문", {
    limit: 3
  });

  console.log(result.anchor);
  console.log(result.items);
}

main().catch((error) => {
  console.error(error);
  process.exitCode = 1;
});

Done when

유저의 현재 위치를 먼저 확인했다.

공식 데이터 기반으로 최소 1개 이상 nearby restroom 을 찾았거나, 못 찾은 이유와 다음 질문을 제시했다.

가장 가까운 결과를 3~5개 이내로 정리했다.

Failure modes

Kakao REST API 키가 없으면 CSV 단일 소스로 동작하므로 누락 POI가 있을 수 있다.

Kakao Map anchor 가 애매하면 위치 기준점이 흔들릴 수 있다.

공개 표준데이터는 실시간 점유/잠금 상태를 주지 않으므로 개방시간 중심으로만 안내해야 한다.

CSV 인코딩/컬럼 구조가 바뀌면 정규화 로직을 다시 확인해야 한다.