foresttrip-vacancy

О нас foresttrip-vacancy

Foresttrip Vacancy автоматизирует поиск свободных мест в национальных лесных зонах отдыха Южной Кореи (자연휴양림) через официальный портал 숲나들e по адресу foresttrip.go.kr. Это исключительно инструмент только для запросов: он проверяет наличие свободных мест для проживания и кемпинга по дате и сознательно исключает отправку бронирований, оплату, решение капчи, обход очередей, а также любые повторные попытки «снайпинга» или агрессивный опрос. Вспомогательная программа на Python управляет Playwright для входа в систему, получения токена CSRF, файлов cookie и официальных идентификаторов лесопарков, а затем вызывает только JSON-конечную точку для ежемесячного бронирования. По состоянию на момент документированной проверки доступ к этому экрану без входа в систему возвращает статус 401, поэтому авторизованная сессия является обязательным предварительным условием, и скрипт не будет искать неофициальные пути или способы обхода капчи при отсутствии секретных данных.

Требования: Python 3.9 или более поздней версии и браузер Playwright Chromium. Учетные данные считываются из переменных среды KSKILL_FORESTTRIP_ID и KSKILL_FORESTTRIP_PASSWORD с задокументированным порядком определения, при котором предпочтение отдается существующим переменным среды, затем хранилищу секретов агента, а затем резервному файлу dotenv в ~/.config/k-skill/secrets.env с правами доступа 0600 и, наконец, запрос у пользователя. Входные данные включают одну или несколько дат в формате ГГГГММДД, селектор области действия (--all для всех лесов, --forest-id для конкретного insttId или --forest-name для частичного совпадения имени), формат вывода (--text или --json), опциональный фильтр по категориям (01 — размещение, 02 — кемпинг или оба), а также расширенные параметры, такие как --week-range, --concurrency (от одного до пяти параллельных рабочих процессов) и переопределение кэша сеанса.

Результаты обобщаются с учетом даты и области действия запроса, доступных названий лесных массивов, номеров комнат или объектов, типа размещения (проживание или кемпинг), вместимости и количества неудачных попыток получения данных; при этом четко указывается, если свободных мест нет, и делается примечание о необходимости повторного подтверждения фактической доступности на сайте. Номера, в названии которых содержится слово «예비», представляют собой внутренние слоты, зарезервированные оператором и не отображаемые пользователям; они автоматически исключаются из результатов, а дубликаты строк для одного и того же леса, даты и номера удаляются. В документации также перечислены режимы сбоев, меры безопасности и шаги по проверке со стороны разработчика, для которых не требуется действующая учетная запись.

Часто задаваемые вопросы

Может ли он сделать бронирование или оплату за меня?

Нет. Программа предназначена только для запросов. Отправка бронирования, оплата, решение капчи, обход очереди и повторные попытки бронирования явно выходят за рамки возможностей программы.

Какие учетные данные и настройки требуются?

Переменные среды KSKILL_FORESTTRIP_ID и KSKILL_FORESTTRIP_PASSWORD, а также Python 3.9+ и браузер Playwright Chromium. Требуется сеанс с авторизацией и защитой от CSRF, так как экран поиска возвращает код ошибки 401 при доступе без аутентификации.

Как определяются мои учетные данные?

В следующем порядке: сначала существующие переменные среды, затем хранилище секретных данных агента, затем резервный файл dotenv в ~/.config/k-skill/secrets.env (права доступа 0600) и, наконец, запрашиваются у вас. Сама утилита считывает только две переменные среды.

Можно ли фильтровать результаты по типу размещения (гостиница или кемпинг)?

Да. Используйте --categories 01 для проживания (숙박), 02 для кемпинга (야영) или 01,02 для обоих вариантов.

Почему некоторые номера не отображаются в результатах?

Номера, в названии которых есть слово «예비», являются внутренними слотами, зарезервированными оператором и не отображаемыми на экране бронирования для пользователей, поэтому утиля по замыслу их исключает. Дубликаты строк для одного и того же леса, даты и номера также удаляются.

Все файлы