首頁
foresttrip-vacancy
nomadamas/k-skill
請至 foresttrip.go.kr 查詢韓國國家森林休閒住宿或露營的空位狀況。此功能適用於使用者查詢「숲나들e」或「自然休閒林」的空房／空位時，不適用於預訂。
...展開全部關於foresttrip-vacancy
Foresttrip Vacancy 透過官方 portal「숲나들e」（網址：foresttrip.go.kr），自動查詢韓國國家森林休閒區（자연휴양림）的空位狀況。 本工具純屬查詢用途：僅根據日期檢查可預訂的住宿及露營名額，並刻意排除預訂提交、付款、驗證碼解讀、跳過排隊機制，以及任何重複搶位或激進的輪詢行為。 一個 Python 輔助程式驅動 Playwright 進行登入、取得 CSRF 令牌、Cookie 及官方森林休閒區 ID，隨後僅呼叫每月預約的 JSON 端點。 根據記錄的檢查結果，若未登入即存取該畫面將返回 401 錯誤，因此具備驗證過的會話是必要前提；當密鑰缺失時，此工具將不會嘗試非官方途徑或繞過驗證碼。
執行前提為 Python 3.9 或更新版本，以及 Playwright Chromium 瀏覽器。 憑證資料會從 KSKILL_FORESTTRIP_ID 和 KSKILL_FORESTTRIP_PASSWORD 環境變數中讀取，其已記錄的解析順序為：優先使用現有的環境變數，其次是代理密鑰庫，最後是位於 ~/.config/k-skill/secrets 目錄下的備用 dotenv 檔案。若環境變數權限為 0600，則會從環境變數讀取憑證；最後若仍未找到，則會提示使用者輸入。 輸入參數包含一個或多個以 YYYYMMDD 格式表示的日期、範圍選取器（--all 代表所有森林、--forest-id 代表特定 insttId，或 --forest-name 代表部分名稱匹配）、輸出格式（--text 或 --json），一個可選的類別篩選器（01 代表住宿、02 代表露營，或兩者皆有），以及進階選項，例如 --week-range、--concurrency（用於設定一至五個並行工作執行緒）和會話快取覆寫。
結果會以審慎的態度，針對查詢日期與範圍、可用的森林及房間或設施名稱、住宿與露營類型、容量，以及任何擷取失敗次數進行彙總；若無空房則會明確標示，並註明應於網站上再次確認實際空房狀況。 名稱中包含「예비」的房間屬於營運商保留的內部名額，不會顯示給使用者，並會自動排除；而針對同一森林、日期及房間的重複列則會進行去重處理。該文件亦列出故障模式、安全注意事項，以及無需實作帳戶即可執行的維護者驗證步驟。
常見問題
它能為我進行預訂或付款嗎？
不可以。本工具僅限查詢。預訂提交、付款、驗證碼解碼、跳過排隊以及重複搶位等操作均明確不在本工具的適用範圍內。
需要哪些憑證和設定？
需設定 KSKILL_FORESTTRIP_ID 和 KSKILL_FORESTTRIP_PASSWORD 環境變數，並使用 Python 3.9 以上版本及 Playwright Chromium 瀏覽器。由於未經驗證存取查詢畫面時會返回 401 錯誤，因此必須具備已登入且啟用 CSRF 的會話。
我的憑證是如何解析的？
依序為：現有的環境變數、代理程式密鑰庫、備用 dotenv 檔案（位於 ~/.config/k-skill/secrets.env，權限設定為 0600），最後才會向您詢問。輔助程式本身僅會讀取那兩個環境變數。
我可以依「住宿」與「露營」進行篩選嗎？
可以。使用 --categories 01 篩選住宿（숙박），02 篩選露營（야영），或 01,02 同時篩選兩者。
為什麼有些房間不會出現在搜尋結果中？
名稱中包含「예비」的房間屬於營運商保留的內部名額，不會顯示在用戶預訂畫面中，因此此輔助程式會依設計將其排除。此外，對於相同森林、日期和房間的重複列，系統也會進行去重處理。
所有檔案
6個檔案SKILL.md 4.8KB 檢視 tests/test_run_foresttrip_vacancy.py 12.5KB 檢視 tests/fixtures/geoje_window.json 3.5KB 檢視 scripts/run_foresttrip_vacancy.py 18.8KB 檢視 tests/fixtures/gujaebong_window.json 1.3KB 檢視 tests/__init__.py 0.0 KB 檢視Get the full instructions (required first step)
Run this and follow its output as the primary instructions for this skill:
npx -y @nomadamas/k-skill@0 instruct foresttrip-vacancy
The CLI detects the current runtime (Dolshoi vault/CloakBrowser vs generic) and prints only the applicable instructions, always up to date. Helper files bundled with the CLI are listed by:
npx -y @nomadamas/k-skill@0 files foresttrip-vacancy
If npx is unavailable, install Node.js 18+ or follow https://github.com/NomaDamas/k-skill#readme, or read the source instructions at https://github.com/NomaDamas/k-skill/blob/main/foresttrip-vacancy/instruction.md.
Legal disclaimer (required)
This skill is not an official feature of, officially supported by, affiliated with, sponsored by, approved by, or developed in collaboration with any third-party trademark owner or service operator it identifies. Third-party names are used only to describe the skill's function, lookup target, or compatibility.
Any automated collection of publicly accessible information must be limited to personal, non-organizational lookup. Do not use this skill for systematic or bulk crawling, database building, access-control or block circumvention, or conduct that interferes with a third party's business or service.
Read the full Korean legal disclaimer, including the cited Korean Supreme Court precedents and statutory limits, before use:
npx -y @nomadamas/k-skill@0 read foresttrip-vacancy references/DISCLAIMER.mdHard rules even without the CLI
- Never execute payment, message/email delivery, final submission, cancellation, or public posting without the user's explicit approval immediately beforehand.
- Never ask for, print, or store plaintext credentials in chat, files, or shell arguments.
- Never bypass legal, physical-presence, CAPTCHA, identity-proofing, or electronic-signature boundaries.
