foresttrip-vacancy

Acerca de foresttrip-vacancy

Foresttrip Vacancy automatiza la consulta de disponibilidad de las zonas recreativas forestales nacionales de Corea del Sur (자연휴양림) a través del portal oficial 숲나들e en foresttrip.go.kr. Se trata de una herramienta estrictamente de consulta: comprueba las plazas disponibles de alojamiento y acampada por fecha y excluye deliberadamente el envío de reservas, el pago, la resolución de captchas, el salto de colas y cualquier intento repetido de acaparar plazas o de sondeo agresivo. Un programa auxiliar en Python utiliza Playwright para iniciar sesión, obtener el token CSRF, las cookies y los identificadores oficiales de los bosques recreativos, y a continuación solo llama al punto final JSON de reservas mensuales. Según la comprobación documentada, acceder a esa pantalla sin iniciar sesión devuelve un error 401, por lo que una sesión autenticada es un requisito previo indispensable, y la herramienta no buscará rutas no oficiales ni formas de eludir el captcha cuando falten los datos de acceso.

Los requisitos previos son Python 3.9 o posterior y el navegador Playwright Chromium. Las credenciales se leen a partir de las variables de entorno KSKILL_FORESTTRIP_ID y KSKILL_FORESTTRIP_PASSWORD, con un orden de resolución documentado que da prioridad a las variables de entorno existentes, seguido del almacén de secretos del agente y, por último, al archivo dotenv de reserva ubicado en ~/.config/k-skill/secrets.env con permisos 0600 y, por último, solicitándoselas al usuario. Los datos de entrada incluyen una o más fechas en formato AAAAMMDD, un selector de ámbito (--all para todos los bosques, --forest-id para un insttId específico o --forest-name para una coincidencia parcial del nombre), un formato de salida (--text o --json), un filtro de categoría opcional (01 para alojamiento, 02 para acampada o ambos) y opciones avanzadas como --week-range, --concurrency para entre uno y cinco trabajadores en paralelo, y una anulación de la caché de sesión.

Los resultados se resumen de forma conservadora en torno a la fecha y el ámbito de la consulta, los nombres de bosques, habitaciones o instalaciones disponibles, el tipo de alojamiento (alojamiento frente a acampada), la capacidad y cualquier recuento de errores de recuperación, indicando claramente cuando no hay plazas disponibles y señalando que la disponibilidad real debe reconfirmarse en la página web. Las habitaciones cuyo nombre contenga «예비» son plazas internas reservadas por el operador que no se muestran a los usuarios y se excluyen automáticamente; además, se eliminan las filas duplicadas para el mismo bosque, fecha y habitación. La documentación también enumera los modos de fallo, las notas de seguridad y los pasos de verificación del mantenedor que no requieren una cuenta activa.

Preguntas frecuentes

¿Puede realizar una reserva o un pago por mí?

No. Es solo para consultas. El envío de reservas, el pago, la resolución de captchas, el salto de colas y los intentos repetidos de «sniping» quedan explícitamente fuera de su ámbito de actuación.

¿Qué credenciales y configuración se requieren?

Las variables de entorno KSKILL_FORESTTRIP_ID y KSKILL_FORESTTRIP_PASSWORD, además de Python 3.9 o superior y el navegador Playwright Chromium. Se requiere una sesión iniciada con CSRF, ya que la pantalla de búsqueda devuelve un código de error 401 si se accede a ella sin autenticación.

¿Cómo se resuelven mis credenciales?

Por orden: las variables de entorno existentes, luego un almacén secreto de agente, después el archivo dotenv de reserva en ~/.config/k-skill/secrets.env (permisos 0600) y, por último, preguntándotelo a ti. La propia herramienta auxiliar solo lee las dos variables de entorno.

¿Puedo filtrar por alojamiento frente a acampada?

Sí. Utiliza --categories 01 para alojamiento (숙박), 02 para acampada (야영) o 01,02 para ambos.

¿Por qué algunas habitaciones no aparecen en los resultados?

Las habitaciones cuyo nombre incluye «예비» son plazas internas reservadas por el operador que no se muestran en la pantalla de reservas del usuario, por lo que el asistente las excluye por diseño. Las filas duplicadas para el mismo bosque, fecha y habitación también se eliminan.

Todos los archivos