집
foresttrip-vacancy
nomadamas/k-skill
foresttrip.go.kr에서 이용 가능한 한국 국유림 휴양 시설의 숙박 또는 캠핑 예약 가능 여부를 조회하세요. 이 기능은 사용자가 ‘숲나들e’ 또는 ‘자연휴양림 빈 객실/빈자리 조회’를 요청할 때 사용하며, 예약 용도로는 사용하지 마세요.
...모든 것을 확장하십시오소개 foresttrip-vacancy
Foresttrip Vacancy는 foresttrip.go.kr의 공식 '숲나들e' 포털을 통해 한국의 국립 자연휴양림 이용 가능 여부를 자동으로 조회해 줍니다. 이 도구는 순수하게 조회 전용 도구로, 날짜별 숙소 및 캠핑장 이용 가능 여부를 확인하며, 예약 제출, 결제, 보안 문자(CAPTCHA) 해결, 대기열 우회, 반복적인 예약 선점 또는 과도한 폴링은 의도적으로 배제합니다. 파이썬 헬퍼가 Playwright를 구동하여 로그인하고, CSRF 토큰, 쿠키 및 공식 자연휴양림 ID를 획득한 후, 월간 예약 JSON 엔드포인트만 호출합니다. 문서화된 확인 결과, 로그인하지 않고 해당 화면에 접속하면 401 오류가 반환되므로 인증된 세션은 필수 전제 조건이며, 비밀 정보가 누락된 경우 이 스킬은 비공식 경로나 보안 문자 우회 방법을 시도하지 않습니다.
필수 전제 조건은 Python 3.9 이상 및 Playwright Chromium 브라우저입니다. 인증 정보는 KSKILL_FORESTTRIP_ID 및 KSKILL_FORESTTRIP_PASSWORD 환경 변수에서 읽으며, 문서화된 해결 순서에 따라 기존 환경 변수, 에이전트 시크릿 볼트, ~/.config/k-skill/secrets에 있는 대체 dotenv 파일 순으로 우선 순위가 지정됩니다.0600 권한이 설정된 env 파일, 그리고 마지막으로 사용자에게 입력 요청을 표시하는 순서로 처리됩니다. 입력 사항에는 YYYYMMDD 형식의 하나 이상의 날짜, 범위 선택자(모든 산림을 지정하는 --all, 특정 insttId를 지정하는 --forest-id, 또는 부분 이름 일치를 지정하는 --forest-name), 출력 형식(--text 또는 --json), 선택적 카테고리 필터(01: 숙박, 02: 캠핑, 또는 둘 다), 그리고 --week-range, 1~5개의 병렬 작업자 수를 지정하는 --concurrency, 세션 캐시 재정의와 같은 고급 옵션이 포함됩니다.
결과는 쿼리 날짜 및 범위, 이용 가능한 포레스트와 객실 또는 시설 이름, 숙박 대 캠핑 유형, 수용 인원, 데이터 가져오기 실패 횟수 등을 보수적으로 요약하여 표시하며, 공실이 없을 경우 명확히 명시하고 실제 가용성은 해당 사이트에서 재확인해야 함을 안내합니다. 이름에 ‘예비’가 포함된 객실은 운영자가 보유한 내부 예약 공간으로 사용자에게 표시되지 않으며 자동으로 제외되며, 동일한 숲, 날짜 및 객실에 대한 중복 행은 제거됩니다. 또한 이 문서에는 오류 모드, 안전 주의사항, 실제 계정이 필요 없는 관리자 검증 단계가 나열되어 있습니다.
자주 묻는 질문
이 도구를 통해 예약이나 결제를 대신 해줄 수 있나요?
아니요. 이 도구는 조회 전용입니다. 예약 제출, 결제, 보안 문자(CAPTCHA) 해결, 대기열 우회 및 반복적인 스나이핑은 모두 명시적으로 지원 범위에서 제외됩니다.
어떤 인증 정보와 설정이 필요합니까?
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.
모든 파일
6개 파일foresttrip-vacancy 설치
스킬 파일을 다운로드하여 .claude/skills/ 디렉터리에 압축을 풀어주세요.
ZIP 다운로드저장소를 클론하고 스킬 파일을 프로젝트에 복사하세요.
git clone https://github.com/NomaDamas/k-skill/blob/main/foresttrip-vacancy/SKILL.md # Copy SKILL.md to your .claude/skills/ directory
복사
