subway-lost-property

SKILL.md

Subway Lost Property

What this skill does

지하철에서 잃어버린 물건을 찾기 위해 공식 경로를 구조화한다.

LOST112 습득물 목록 조회에 넣을 검색 조건을 정리한다.

서울교통공사 유실물센터 진입점을 함께 안내한다.

공개 API가 명확하지 않은 상태라 v1은 안내형/하이브리드 범위로 유지한다.

When to use

"강남역에서 지갑 잃어버렸는데 어디서 찾아?"

"2호선 지하철 분실물 조회 방법 알려줘"

"서울 지하철 유실물 공식 사이트로 바로 찾게 도와줘"

Inputs

필수: 역명 또는 보관장소 키워드

선택: 물품명, 호선, 분실/습득 추정 기간

Official surfaces

LOST112 습득물 목록: https://www.lost112.go.kr/find/findList.do

서울교통공사 유실물센터: https://www.seoulmetro.co.kr/kr/page.do?menuIdx=541

LOST112 검색 폼에서 확인되는 핵심 필드는 아래와 같다.

SITE=V: 경찰 이외 기관(지하철, 공항 등)

DEP_PLACE: 보관장소

PRDT_NM: 습득물명

START_YMD, END_YMD: 검색 기간

Workflow

1) Ask for the minimum clues first

바로 추정하지 말고 아래 정보를 먼저 받는다.

어느 역/어느 구간인지

물건 종류가 무엇인지

대략 언제 잃어버렸는지

서울교통공사(1~8호선) 범위인지, 다른 운영사인지

2) Generate the official LOST112 search payload

repo helper를 그대로 써도 된다.

python3 scripts/subway_lost_property.py \
  --station 강남역 \
  --item 지갑 \
  --days 14

helper는 기본적으로 SITE=V 를 사용하고, 역명/물품명/기간을 LOST112 form payload와 referer까지 포함한 runnable curl 예시로 정리해 준다. 예시 curl 은 느린 공식 응답을 감안해 --max-time 60 을 포함하고, 응답 HTML을 lost112-search-result.html 로 저장한다.

3) Optionally verify live reachability

python3 scripts/subway_lost_property.py \
  --station 강남역 \
  --item 지갑 \
  --days 14 \
  --verify-live

--verify-live 는 공식 페이지 접근 가능 여부만 보수적으로 확인한다. 사이트가 느리면 timeout을 그대로 보고하고 manual open으로 전환한다.

4) Guide the user conservatively

먼저 LOST112에서 역명 그대로 검색

결과가 없으면 강남처럼 역 없는 키워드로 재검색

필요하면 호선명도 추가 검색

서울교통공사 유실물센터 페이지를 함께 열어 후속 안내 확인

Done when

사용자가 공식 조회 경로를 바로 열 수 있다.

LOST112 검색 조건(SITE=V, 역명, 물품명, 기간)을 받았다.

자동 조회 보장 범위와 manual fallback을 분명히 설명했다.

Failure modes

공식 사이트 응답이 느리거나 timeout 발생

역명이 실제 보관장소 표기와 달라 검색 결과가 비는 경우

공개 API 부재로 자동 결과 수집이 안정적이지 않은 경우

Notes

v1은 공식 웹 흐름을 안전하게 안내하는 범위다.

완전 자동 조회형으로 확장하려면 캡차/세션/동적 요청 안정성 재검증이 먼저 필요하다.

helper는 공식 HTTPS 진입점만 사용한다.