Seoul Subway Arrival

このスキルの機能

ソウル市民情報システムの実時間地下鉄到着情報 Open API を k-skill-proxy 経由で照会し、駅基準で到着予定の列車情報をまとめます。

使用場面

• "江南駅今何分後到着?"
• "ソウル駅1号線到着情報見せて"
• "蚕室駅もうすぐ入ってくる列車整理してくれ"

前提条件

• 選択肢: jq
• 選択肢: KSKILL_PROXY_BASE_URL (自分でホストするか別のプロキシを使う場合のみ設定。空白にするとデフォルトのホストされた https://k-skill-proxy.nomadamas.org を使用します)

必須環境変数

• なし。KSKILL_PROXY_BASE_URL は選択肢で、空白にするとデフォルトのホストされた https://k-skill-proxy.nomadamas.org を使用します。

ユーザーが個人的にソウル市民情報システムの OpenAPI キーを直接発給する必要はありません。/v1/seoul-subway/arrival ルートはデフォルトのホストされたプロキシから呼び出され、upstream キーはプロキシサーバー側のみに保存されます。別のプロキシを使う場合のみ KSKILL_PROXY_BASE_URL を設定します。

プロキシ解決順序

1. KSKILL_PROXY_BASE_URL がある場合、その値を使用します。
2. ない場合または空白値の場合、デフォルトのホストされたプロキシ https://k-skill-proxy.nomadamas.org を使用します。
3. プロキシを直接運営する場合のみ、プロキシサーバーの upstream キーをサーバー側のみに設定します。

クライアント/ユーザー側では upstream キーを直接扱いません。

入力

• 駅名
• 選択肢: 取得する件数

ワークフロー

1. プロキシベース URL を解決

KSKILL_PROXY_BASE_URL がある場合はその値を使用し、ない場合または空白の場合はデフォルトのホストされたプロキシ https://k-skill-proxy.nomadamas.org を使用します。

2. 公式駅到着エンドポイントを照会

プロキシはソウルの実時間地下鉄 API キーをサーバーから注入し、駅名基準の実時間到着情報のみを公開読み取り専用エンドポイントとして公開します。

BASE="${KSKILL_PROXY_BASE_URL:-https://k-skill-proxy.nomadamas.org}"
curl -fsS --get "${BASE}/v1/seoul-subway/arrival" \
  --data-urlencode 'stationName=강남'

必要に応じて startIndex、endIndex で応答範囲を調整できます。

3. レスポンスをまとめる

可能な限り以下の項目のみ最初にまとめます。

• 路線
• 上行/下行または外線/内線
• 最初の到着メッセージ
• 2番目の到着メッセージ
• 到着予定時間(ある場合は秒単位)

4. ライブデータについて慎重に対応

実時間データは数秒単位で変わる可能性があるため、回答には照会時点も一緒に記載します。

完了条件

• リクエストされた駅の到着予定列車がまとめられている
• ライブデータの基準時点が明示されている
• upstream キーがクライアントに公開されていない

障害モード

• プロキシ upstream キー未設定
• クォータ超過
• 駅名表記不一致

注記

• ソウル市民情報システムのガイドでは実時間地下鉄 Open API に日々の呼び出し制限がある可能性があると案内されています
• プロキシ運営/環境変数設定は docs/features/k-skill-proxy.md を参照してください
• エンドポイントパスは API バージョン変更の可能性があるため、失敗時はデータセットコンソールの最新サンプル URL を再確認してください