foresttrip-vacancy

À propos foresttrip-vacancy

Foresttrip Vacancy automatise la recherche de disponibilités dans les zones de loisirs forestières nationales (자연휴양림) de Corée du Sud via le portail officiel 숲나들e, accessible à l’adresse foresttrip.go.kr. Il s’agit d’un outil strictement dédié à la recherche : il vérifie les disponibilités d’hébergement et de camping par date et exclut délibérément la soumission de réservation, le paiement, la résolution de captcha, le contournement de la file d’attente, ainsi que tout « sniping » répété ou interrogation agressive. Un script Python pilote Playwright pour se connecter, obtenir le jeton CSRF, les cookies et les identifiants officiels des zones de loisirs forestières, puis appelle uniquement le point de terminaison JSON dédié aux réservations mensuelles. D’après les tests documentés, l’accès à cet écran sans connexion renvoie un code d’erreur 401 ; une session authentifiée est donc une condition préalable obligatoire, et l’outil ne recherchera pas de voies non officielles ni de contournements de captcha en cas d’absence d’informations d’identification.

Les prérequis sont Python 3.9 ou une version ultérieure, ainsi que le navigateur Chromium de Playwright. Les identifiants sont lus à partir des variables d’environnement KSKILL_FORESTTRIP_ID et KSKILL_FORESTTRIP_PASSWORD, selon un ordre de résolution documenté qui privilégie les variables d’environnement existantes, puis un coffre-fort de secrets de l’agent, puis un fichier dotenv de secours situé dans ~/.config/k-skill/secrets.env avec des permissions 0600, et enfin en demandant à l’utilisateur de les saisir. Les données d’entrée comprennent une ou plusieurs dates au format AAAAMMJJ, un sélecteur de périmètre (--all pour toutes les forêts, --forest-id pour un insttId spécifique ou --forest-name pour une correspondance partielle de nom), un format de sortie (--text ou --json), un filtre de catégorie facultatif (01 pour l’hébergement, 02 pour le camping, ou les deux), ainsi que des options avancées telles que --week-range, --concurrency pour un à cinq processus parallèles, et une dérogation au cache de session.

Les résultats sont résumés de manière prudente en fonction de la date et de la portée de la requête, des noms de forêts, de chambres ou d’établissements disponibles, du type d’hébergement (hébergement ou camping), de la capacité d’accueil et du nombre d’échecs de récupération, en indiquant clairement lorsqu’il n’y a pas de place disponible et en précisant que la disponibilité réelle doit être reconfirmée sur le site. Les chambres dont le nom contient « 예비 » sont des créneaux internes réservés par l’opérateur qui ne sont pas affichés aux utilisateurs et sont automatiquement exclues ; les lignes en double pour une même forêt, une même date et une même chambre sont dédupliquées. La documentation répertorie également les modes de défaillance, les consignes de sécurité et les étapes de vérification par le responsable de maintenance qui ne nécessitent pas de compte actif.

FAQ

Peut-il effectuer une réservation ou un paiement à ma place ?

Non. Il s’agit d’un outil de requête uniquement. La soumission de réservation, le paiement, la résolution de captcha, le contournement de la file d’attente et les tentatives répétées de sniping sont tous explicitement exclus de son champ d’application.

Quels identifiants et quelle configuration sont nécessaires ?

Les variables d’environnement KSKILL_FORESTTRIP_ID et KSKILL_FORESTTRIP_PASSWORD, ainsi que Python 3.9+ et le navigateur Playwright Chromium. Une session connectée avec CSRF est requise, car l’écran de recherche renvoie un code d’erreur 401 lorsqu’on y accède sans authentification.

Comment mes identifiants sont-ils déterminés ?

Dans l’ordre : les variables d’environnement existantes, puis un coffre-fort de secrets d’agent, puis le fichier dotenv de secours situé dans ~/.config/k-skill/secrets.env (droits d’accès 0600), et enfin en vous demandant de les saisir. L’assistant lui-même ne lit que les deux variables d’environnement.

Puis-je filtrer par type d’hébergement (hébergement) ou de camping ?

Oui. Utilisez --categories 01 pour l’hébergement (숙박), 02 pour le camping (야영), ou 01,02 pour les deux.

Pourquoi certaines chambres n’apparaissent-elles pas dans les résultats ?

Les chambres dont le nom contient « 예비 » sont des emplacements internes réservés par l’opérateur qui n’apparaissent pas sur l’écran de réservation des utilisateurs ; l’assistant les exclut donc par défaut. Les lignes en double correspondant à une même forêt, une même date et une même chambre sont également supprimées.

Tous les fichiers