seoul-eventslisted

# seoul-events ソウルオープンデータ広場のソウル文化イベント情報API(culturalEventInfo)で、ソウル市内のコンサート・展示・祭り・公演を検索するスキル。サンプルキーで実データ取得を確認済み。件数は変動する観測値で、2026-09-19時点では日付フィルタ `2026-10` が159件、ジャンル「축제」が1,507件。 ソウル市内に限定される。韓国全国の祭り・イベントは [kto-tour](../kto-tour/SKILL.md)(日本語対応)を使う。 ## キーの取得 ソウルオープンデータ広場(data.seoul.go.kr)で利用申請すると即時発行される(無料)。動作確認だけならサンプルキー `sample` がそのまま使える(1〜5件まで)。 ## 基本の流れ ### 1. サンプルキーで動作確認(実測済み) ```bash curl -s -m 30 "http://openapi.seoul.go.kr:8088/sample/json/culturalEventInfo/1/3/" ``` ### 2. 月・ジャンル・タイトルで絞る パスに検索条件を追加できる:`/{KEY}/json/culturalEventInfo/{START}/{END}/{CODENAME}/{TITLE}/{DATE}/` ```bash # 対象月は実行時に指定する MONTH=$(date -d "+1 month" +%Y-%m) curl -s -m 30 "http://openapi.seoul.go.kr:8088/sample/json/culturalEventInfo/1/3/%20/%20/${MONTH}" # ジャンル「축제」(祭り)で絞る(件数は変動) curl -s -m 30 "http://openapi.seoul.go.kr:8088/sample/json/culturalEventInfo/1/3/%EC%B6%95%EC%A0%9C" ``` - 空の条件は `%20`(スペース)で埋める。韓国語はURLエンコードする。 - `CODENAME` は部分一致。「콘서트」(コンサート)、「축제」(祭り)、「전시」(展示)などが使える(いずれも実測済み)。「축제-문화/예술」のような厳密な分類名もあるが、`/` を含むので部分一致の短い語で絞るほうが無難。 - `DATE` は `YYYY-MM` 形式で、その月に重なるイベントを返す。`TITLE` はタイトル部分一致。 ## 読み方 - `TITLE` / `PLACE` / `GUNAME`: タイトル、会場、区(강남구 など)。 - `DATE`: 「2026-10-31~2026-10-31」形式の期間。`STRTDATE` / `END_DATE` は日時型、`PRO_TIME` は開催時間帯(「12:00~17:00」)。 - `IS_FREE`: 「무료」(無料)/「유료」(有料)。`USE_FEE`: 料金の自由記述(空欄あり)。 - `PLAYER` / `PROGRAM`: 出演者・プログラム(空欄多め)。 - `ORG_LINK` / `HMPG_ADDR`: 主催者ページとソウル文化ポータルの詳細ページ。旅行者には `HMPG_ADDR` を渡すと確実。 - `MAIN_IMG`: ポスター画像URL。`LAT` / `LOT`: 緯度経度。 ## 実レスポンス例(2026