subway-lost-property

地鐵遺失物

此技能的功能

為尋找在地鐵遺失的物品，結構化官方查詢路徑。

• 整理要輸入 LOST112「습득물 목록 조회」的搜尋條件。
• 同時引導首爾交通公社遺失物中心入口。
• 由於公開 API 不明確，v1 維持在引導型/混合型範圍。

使用時機

• 「在江南站弄丟錢包，要去哪裡找？」
• 「告訴我查詢2號線地鐵遺失物的方法」
• 「幫我直接連到首爾地鐵遺失物官方網站」

輸入

• 必填：站名或保管地點關鍵字
• 選填：物品名稱、路線、遺失/拾獲推估期間

官方管道

• 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：搜尋期間

工作流程

1) 先詢問最少線索

不要直接推測，先取得以下資訊。

• 哪一站/哪個區間
• 物品種類是什麼
• 大概何時遺失
• 是否為首爾交通公社（1~8號線）範圍，或其他營運商

2) 產生官方 LOST112 搜尋 payload

可以直接使用 repo helper。

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

helper 預設使用 SITE=V，並將站名/物品名稱/期間整理成包含 referer 的可執行 curl 範例。範例 curl 考量官方回應較慢，包含 --max-time 60，並將回應 HTML 儲存為 lost112-search-result.html。

3) 可選：驗證即時連通性

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

--verify-live 僅保守確認官方頁面是否可存取。若網站緩慢，則直接回報逾時並轉為手動開啟。

4) 保守引導使用者

• 先在 LOST112 以站名直接搜尋
• 若無結果，以「강남」等不含「역」的關鍵字重新搜尋
• 必要時加入路線名稱再次搜尋
• 同時開啟首爾交通公社遺失物中心頁面，確認後續指引

完成條件

• 使用者能直接開啟官方查詢路徑。
• 已取得 LOST112 搜尋條件（SITE=V、站名、物品名稱、期間）。
• 清楚說明自動查詢保證範圍與手動備援方式。

失敗模式

• 官方網站回應緩慢或逾時
• 站名與實際保管地點標示不符，導致搜尋結果為空
• 因缺乏公開 API，自動結果收集不穩定

備註

• v1 範圍為安全引導官方網頁流程。
• 若要擴展為全自動查詢型，需先重新驗證驗證碼/ session/動態請求穩定性。
• helper 僅使用官方 HTTPS 入口。