foresttrip-vacancy

Über foresttrip-vacancy

Foresttrip Vacancy automatisiert die Verfügbarkeitsabfrage für Südkoreas staatliche Walderholungsgebiete (자연휴양림) über das offizielle Portal „숲나들e“ unter foresttrip.go.kr. Es handelt sich ausschließlich um ein reines Abfrage-Tool: Es prüft freie Übernachtungs- und Campingplätze nach Datum und schließt bewusst die Übermittlung von Reservierungen, Zahlungen, das Lösen von CAPTCHAs, das Umgehen von Warteschlangen sowie wiederholtes „Sniping“ oder aggressives Abfragen aus. Ein Python-Hilfsprogramm steuert Playwright an, um sich anzumelden, das CSRF-Token, Cookies und die offiziellen Erholungswald-IDs abzurufen, und ruft anschließend ausschließlich den JSON-Endpunkt für monatliche Reservierungen auf. Zum Zeitpunkt der dokumentierten Überprüfung führt der Zugriff auf diesen Bildschirm ohne Anmeldung zu einem 401-Fehler; daher ist eine authentifizierte Sitzung eine erforderliche Voraussetzung, und das Tool sucht nicht nach inoffiziellen Wegen oder Captcha-Umgehungen, wenn die Zugangsdaten fehlen.

Voraussetzungen sind Python 3.9 oder höher sowie der Playwright-Chromium-Browser. Die Anmeldedaten werden aus den Umgebungsvariablen „KSKILL_FORESTTRIP_ID“ und „KSKILL_FORESTTRIP_PASSWORD“ gelesen, wobei die dokumentierte Auswertungsreihenfolge wie folgt ist: Zuerst werden vorhandene Umgebungsvariablen bevorzugt, dann ein Agent-Secret-Vault und schließlich als Fallback die „dotenv“-Datei unter ~/.config/k-skill/secrets.env mit den Berechtigungen 0600 und schließlich durch Abfrage beim Benutzer. Zu den Eingaben gehören ein oder mehrere Datumsangaben im Format JJJJMMTT, ein Bereichsauswahlparameter (--all für alle Forests, --forest-id für eine bestimmte insttId oder --forest-name für eine teilweise Namensübereinstimmung), ein Ausgabeformat (--text oder --json), einen optionalen Kategoriefilter (01 für Unterkünfte, 02 für Camping oder beides) sowie erweiterte Optionen wie --week-range, --concurrency für ein bis fünf parallele Worker und eine Überschreibung des Session-Caches.

Die Ergebnisse werden konservativ in Bezug auf das Abfragedatum und den Umfang, die verfügbaren Wald-, Zimmer- oder Einrichtungsnamen, die Art der Unterkunft (Übernachtung oder Camping), die Kapazität sowie die Anzahl der Abruffehler zusammengefasst, wobei deutlich angegeben wird, wenn keine freien Plätze vorhanden sind, und darauf hingewiesen wird, dass die tatsächliche Verfügbarkeit auf der Website erneut bestätigt werden sollte. Zimmer, deren Name „예비“ enthält, sind vom Betreiber reservierte interne Plätze, die den Nutzern nicht angezeigt werden und automatisch ausgeschlossen werden; doppelte Zeilen für denselben Wald, dasselbe Datum und dasselbe Zimmer werden dedupliziert. Die Dokumentation listet außerdem Fehlermodi, Sicherheitshinweise und Überprüfungsschritte für Betreuer auf, für die kein Live-Konto erforderlich ist.

FAQ

Kann das Tool für mich eine Reservierung vornehmen oder eine Zahlung tätigen?

Nein. Es handelt sich um ein reines Abfrage-Tool. Das Einreichen von Reservierungen, Zahlungen, das Lösen von CAPTCHAs, das Umgehen von Warteschlangen und wiederholtes „Sniping“ fallen ausdrücklich nicht in den Anwendungsbereich.

Welche Anmeldedaten und welche Konfiguration sind erforderlich?

Die Umgebungsvariablen `KSKILL_FORESTTRIP_ID` und `KSKILL_FORESTTRIP_PASSWORD` sowie Python 3.9+ und der Playwright-Chromium-Browser. Eine angemeldete Sitzung mit CSRF ist erforderlich, da der Suchbildschirm ohne Authentifizierung den Status 401 zurückgibt.

Wie werden meine Anmeldedaten ermittelt?

In dieser Reihenfolge: vorhandene Umgebungsvariablen, dann ein Agent-Secret-Vault, dann die Fallback-dotenv-Datei unter ~/.config/k-skill/secrets.env (Berechtigungen 0600) und schließlich durch Abfrage bei Ihnen. Der Helper selbst liest nur die beiden Umgebungsvariablen aus.

Kann ich nach „Unterkunft“ und „Camping“ filtern?

Ja. Verwende --categories 01 für Unterkünfte (숙박), 02 für Camping (야영) oder 01,02 für beides.

Warum erscheinen einige Zimmer nicht in den Ergebnissen?

Zimmer, deren Name „예비“ enthält, sind interne, vom Betreiber reservierte Plätze, die auf dem Reservierungsbildschirm für Benutzer nicht angezeigt werden; daher schließt der Helfer sie bewusst aus. Doppelte Zeilen für denselben Wald, dasselbe Datum und dasselbe Zimmer werden ebenfalls entfernt.

Alle Dateien