Foresttrip Vacancy

このスキルの機能

숲나들e 公式サイト(https://foresttrip.go.kr/index.jsp)の自然休養林の予約可能な客室を日付に基づいて照会する自動化を実現します。

このスキルは照会専用の自動化です。予約申請、決済、キャプチャ処理、待機列の回避、反復的なスナイピングはスコープに含まれません。

使用場面

• "このように、自然休養林に空き客室がありますか？"
• "숲나들e 2026年5月4日に予約可能な場所を照会してください"
• "自然休養林の空き室を全体照会してください"
• "関心のある休養林の中で予約可能な客室だけを教えてください"

使用しない場面

• 予約申請または決済まで自動化する必要がある場合
• キャプチャを解く、または待機列を回避する必要がある場合
• アカウント情報をチャットウィンドウに直接入力する場合
• aggressive polling、スナイピング、反復予約試行が必要な場合

前提条件

• Python 3.9+
• Playwright Chromium ブラウザ

python3 -m pip install playwright
python3 -m playwright install chromium
python3 scripts/run_foresttrip_vacancy.py --check-deps

必須環境変数

• KSKILL_FORESTTRIP_ID
• KSKILL_FORESTTRIP_PASSWORD

オプション:

• なし

認証情報の解決順序

1. すでに環境変数に設定されている場合、そのまま使用します。
2. エージェントが独自のシークレットボルト(1Password CLI、Bitwarden CLI、macOS Keychain など)を使用している場合、そこから取得して環境変数として注入することができます。
3. ~/.config/k-skill/secrets.env (デフォルトフォールバック) — plain dotenv ファイル、パーミッション 0600。
4. 何もない場合、ユーザーに確認して2または3に保存します。

デフォルトパスに保存することはフォールバックに過ぎず、強制されません。 Helper自体は KSKILL_FORESTTRIP_ID、KSKILL_FORESTTRIP_PASSWORD 環境変数だけを読みます。vault または secrets.env を使用する場合でも、実行前にその値を環境変数として注入します。

入力

• 日付: YYYYMMDD、複数の日付の場合はカンマ区切り YYYYMMDD,YYYYMMDD
• 照会範囲:
  • --all: 全自然休養林を照会
  • --forest-id: 特定の insttId を照会
  • --forest-name: 公式休養林名の部分一致を照会
• 出力形式:
  • --text: 人間用のサマリー
  • --json: 構造化結果
• 選択フィルター:
  • --categories 01: 宿泊
  • --categories 02: キャンプ/キャンピング
  • --categories 01,02: 宿泊 + キャンプ/キャンピング
• 高度な実行オプション:
  • --week-range N: --dates を省略した場合のみ、今日から N週間の範囲を照会
  • --concurrency N: 並列照会ワーカー数、1-5 の範囲
  • --session-cache PATH: ログインセッションキャッシュパスをオーバーライド

ワークフロー

1. 認証情報が利用可能であることを確認

KSKILL_FORESTTRIP_ID、KSKILL_FORESTTRIP_PASSWORD が設定されているかを確認します。ない場合は認証情報の解決順序に従って確保します。

シークレットがないという理由で、代替サイト、キャプチャ回避、非公式の予約経路を探しません。

2. 実行時の依存関係がない場合はインストール

python3 -m pip install playwright
python3 -m playwright install chromium

3. 空き状況照会を実行

このスキルの helper を通じて照会します。Helper は Playwright で숲나들e にログインして CSRF/cookie と公式休養林 ID リストを取得した後、月別予約照会 JSON エンドポイントのみを呼び出します。

2026-04-29 確認時点で、ログインなしで月別予約照会画面にアクセスすると 401 Unauthorized が返され、照会エンドポイントは JSON の代わりに案内 HTML を返します。したがって、現在の helper はログインセッション/CSRF 確保を必須前提としています。

全自然休養林で特定の日付を照会:

python3 scripts/run_foresttrip_vacancy.py --all --text --dates 20260504

JSON 出力:

python3 scripts/run_foresttrip_vacancy.py --all --json --dates 20260504

キャンプ/キャンピングのみを照会:

python3 scripts/run_foresttrip_vacancy.py --all --text --dates 20260504 --categories 02

特定の休養林名で照会:

python3 scripts/run_foresttrip_vacancy.py --forest-name 유명산 --text --dates 20260504

4. 結果を慎重に要約

応答は以下の項目を中心に短くまとめます。

• 照会日付
• 照会範囲
• 予約可能な休養林名
• 客室/施設名
• 宿泊/キャンピング区分
• 定員または収容人数
• fetch failure がある場合は失敗数

結果がない場合は「照会時点では予約可能な客室がありません」と述べます。実際の予約可能性は숲나들e 画面で再確認できることを付け加えます。

完了条件

• リクエスト日付と照会範囲が明確である。
• 読み取り専用月別予約照会 helper を最低 1 回実行した。
• 空き客室がある場合は、日付/休養林/客室をまとめた。
• 空き客室がない場合は、ないと明確に述べた。
• 予約/決済/待機列回避は試みなかった。

障害モード

• ログイン失敗: KSKILL_FORESTTRIP_ID、KSKILL_FORESTTRIP_PASSWORD を確認
• Playwright ブラウザ未インストール: python3 -m playwright install chromium
• fetch failure が一部発生: 結果と失敗数を一緒に報告し、必要に応じて --refresh-session で 1 回再照会 -숲나들e 表示変更: helper のログイン/セッション bootstrap またはパーサーの確認が必要

メンテナーレビューノート

メンテナーがこのスキルを確認するために숲나들e アカウントを新規作成する必要はありません。

アカウントなしで可能な検証:

• ./scripts/validate-skills.sh
• python3 -m py_compile foresttrip-vacancy/scripts/run_foresttrip_vacancy.py
• python3 foresttrip-vacancy/scripts/run_foresttrip_vacancy.py --help
• python3 foresttrip-vacancy/scripts/run_foresttrip_vacancy.py --check-deps
• npm run ci

実際のライブスモークテストは、貢献者またはすでに숲나들e アカウントを持つユーザーが選択的に実行します。PR には forests_scanned、fetch_failures、filter_hits などの非機密サマリーのみを残し、アカウント情報、セッション Cookie、個人の照会詳細は共有しません。

セーフティノート

• 照会専用スキルです。
• 予約、決済、キャプチャ処理、待機列回避、攻撃的な反復照会は行いません。
• アカウントシークレットは環境変数または ~/.config/k-skill/secrets.env でのみ処理します。