foresttrip-vacancy

概要foresttrip-vacancy

Foresttrip Vacancyは、foresttrip.go.krの公式ポータル「숲나들e」を通じて、韓国の国立森林レクリエーションエリア（자연휴양림）の空き状況検索を自動化するツールです。 これはあくまで照会専用のツールであり、日付ごとの空室状況（宿泊・キャンプ）を確認する機能のみを備えており、予約の送信、支払い、キャプチャの解決、待ち行列のバイパス、および繰り返しのスナイピングや過度なポーリングは意図的に排除されています。 Python製のヘルパープログラムがPlaywrightを駆動し、ログイン、CSRFトークン、クッキー、および公式の自然休養林IDの取得を行い、その後、月単位予約用のJSONエンドポイントのみを呼び出します。 文書化された検証時点では、ログインせずにその画面にアクセスすると401エラーが返されるため、認証済みセッションが必須の前提条件となります。また、このツールは、認証情報が不足している場合に、非公式なルートやキャプチャ回避を試みることはありません。

前提条件として、Python 3.9以降およびPlaywright Chromiumブラウザが必要です。 認証情報は、KSKILL_FORESTTRIP_ID および KSKILL_FORESTTRIP_PASSWORD 環境変数から読み込まれます。ドキュメントに記載されている解決順序では、既存の環境変数、次にエージェントのシークレットボールト、そして ~/.config/k-skill/secrets にあるフォールバック用の dotenv ファイルの順に優先されます。0600の権限を持つenv、そして最後にユーザーへのプロンプト表示の順で試行されます。 入力には、YYYYMMDD形式の1つ以上の日付、スコープセレクタ（すべてのフォレストの場合は --all、特定の insttId の場合は --forest-id、部分一致の場合は --forest-name）、出力形式（--text または --json）、オプションのカテゴリフィルター（01：宿泊施設、02：キャンプ場、または両方）、および --week-range、1～5 個の並列ワーカーを設定する --concurrency、セッションキャッシュのオーバーライドなどの高度なオプションが含まれます。

結果は、クエリの日付と範囲、利用可能なフォレストおよび部屋または施設名、宿泊施設とキャンプ場の種類、収容人数、およびフェッチ失敗回数について、控えめに見積もられて要約されます。空室がない場合は明示的に示され、実際の空き状況はサイトで再確認する必要があることが注記されます。 名称に「예비」を含む部屋は、運営者が確保している内部枠であり、ユーザーには表示されず自動的に除外されます。また、同じフォレスト、日付、部屋に関する重複行は削除されます。ドキュメントには、障害モード、安全上の注意事項、および有効なアカウントを必要としないメンテナーによる検証手順も記載されています。

よくある質問

このツールを使って予約や支払いはできますか？

いいえ。本ツールはクエリ専用です。予約の送信、支払い、キャプチャの解決、待ち行列のバイパス、および繰り返しのスナイピングは、すべて明示的に対象外となっています。

必要な認証情報と設定は？

環境変数 KSKILL_FORESTTRIP_ID および KSKILL_FORESTTRIP_PASSWORD、さらに Python 3.9 以降と Playwright Chromium ブラウザが必要です。認証なしでアクセスすると検索画面が 401 を返すため、CSRF 対応のログイン済みセッションが必要です。

認証情報はどのように解決されますか？

優先順位は、既存の環境変数、次にエージェントのシークレットボールト、その次に ~/.config/k-skill/secrets.env（権限 0600）にあるフォールバック用の dotenv ファイル、そして最後にユーザーへの問い合わせとなります。ヘルパー自体は、これら 2 つの環境変数のみを読み取ります。

宿泊とキャンプで絞り込みはできますか？

はい。宿泊（숙박）の場合は --categories 01、キャンプ（야영）の場合は 02、両方を含む場合は 01,02 を指定してください。

なぜ一部の部屋が検索結果に表示されないのですか？

名前に「예비」を含む部屋は、運営者が管理する内部用枠であり、ユーザーの予約画面には表示されないため、ヘルパーは設計上これらを除外しています。また、同じ森林、日付、部屋に関する重複行も削除されます。

すべてのファイル