首页
foresttrip-vacancy
nomadamas/k-skill
请访问 foresttrip.go.kr 查询韩国国家森林休闲度假区的空房或露营位。当用户询问“숲나들e”或“自然休养林空房/空位查询”时使用该功能，但不可用于预订。
...展开全部关于foresttrip-vacancy
Foresttrip Vacancy 通过官方门户网站 foresttrip.go.kr 上的 “숲나들e” 系统，自动查询韩国国家森林休闲区（자연휴양림）的空位情况。 这是一款纯粹的查询工具：它按日期检查可预订的住宿和露营名额，并刻意排除预订提交、支付、验证码识别、跳过排队以及任何重复抢订或激进轮询的行为。 一个 Python 辅助程序驱动 Playwright 进行登录、获取 CSRF 令牌、Cookie 以及官方森林休闲区 ID，随后仅调用月度预订的 JSON 接口。 根据记录的检测结果，未登录状态下访问该页面会返回401错误，因此经过身份验证的会话是必要前提；当缺少密钥时，该技能不会寻求非官方途径或绕过验证码。
先决条件是 Python 3.9 或更高版本以及 Playwright Chromium 浏览器。 凭据从 KSKILL_FORESTTRIP_ID 和 KSKILL_FORESTTRIP_PASSWORD 环境变量中读取，其文档中记录的解析顺序为：优先使用现有环境变量，其次是代理密钥库，最后是位于 ~/.config/k-skill/secrets 下的备用 dotenv 文件。env 文件（权限为 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 的会话。
我的凭据如何解析？
按以下顺序：现有环境变量、代理密钥库、位于 ~/.config/k-skill/secrets.env 的备用 dotenv 文件（权限 0600），最后才会向您询问。辅助程序本身仅读取上述两个环境变量。
我可以按住宿与露营进行筛选吗？
可以。使用 --categories 01 筛选住宿（숙박），02 筛选露营（야영），或 01,02 同时筛选两者。
为什么有些房间没有出现在结果中？
名称中包含“예비”的房间属于运营商保留的内部房源，不会显示在用户预订界面上，因此该助手按设计会将其排除在外。对于同一森林、日期和房间的重复行，系统也会进行去重处理。
所有文件
6个文件SKILL.md4.8KB查看tests/test_run_foresttrip_vacancy.py12.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.
