foresttrip-vacancy

Sobre foresttrip-vacancy

O Foresttrip Vacancy automatiza a consulta de disponibilidade das áreas de recreação florestal nacionais da Coreia do Sul (자연휴양림) por meio do portal oficial 숲나들e, em foresttrip.go.kr. Trata-se de uma ferramenta estritamente voltada para consultas: ela verifica vagas disponíveis para hospedagem e acampamento por data e exclui deliberadamente o envio de reservas, pagamentos, resolução de captchas, contorno de filas e qualquer tipo de “sniping” repetitivo ou polling agressivo. Um programa auxiliar em Python aciona o Playwright para fazer o login, obter o token CSRF, os cookies e os IDs oficiais das áreas florestais de recreação e, em seguida, chama apenas o endpoint JSON de reservas mensais. Conforme verificado, acessar essa tela sem fazer login retorna um erro 401; portanto, uma sessão autenticada é pré-requisito obrigatório, e a ferramenta não buscará rotas não oficiais nem formas de contornar o captcha quando os dados de autenticação estiverem ausentes.

Os pré-requisitos são o Python 3.9 ou posterior e o navegador Playwright Chromium. As credenciais são lidas a partir das variáveis de ambiente KSKILL_FORESTTRIP_ID e KSKILL_FORESTTRIP_PASSWORD, seguindo uma ordem de resolução documentada que prioriza as variáveis de ambiente existentes, depois um cofre de segredos do agente e, por fim, um arquivo dotenv de fallback em ~/.config/k-skill/secrets.var.env com permissões 0600 e, por fim, solicitando a informação ao usuário. As entradas incluem uma ou mais datas no formato AAAAMMDD, um seletor de escopo (--all para todas as florestas, --forest-id para um insttId específico ou --forest-name para uma correspondência parcial de nome), um formato de saída (--text ou --json), um filtro de categoria opcional (01 para hospedagem, 02 para acampamento ou ambos) e opções avançadas, como --week-range, --concurrency para um a cinco trabalhadores paralelos e uma substituição do cache de sessão.

Os resultados são resumidos de forma conservadora em torno da data e do escopo da consulta, nomes de florestas e quartos ou instalações disponíveis, tipo de hospedagem (hospedagem versus acampamento), capacidade e qualquer contagem de falhas na obtenção de dados, indicando claramente quando não há vagas disponíveis e observando que a disponibilidade real deve ser reconfirmada no site. Os quartos cujo nome contenha “예비” são vagas internas reservadas pelo operador, não exibidas aos usuários, e são automaticamente excluídos; além disso, linhas duplicadas para a mesma floresta, data e quarto são deduplicadas. A documentação também lista modos de falha, notas de segurança e etapas de verificação do mantenedor que não exigem uma conta ativa.

Perguntas frequentes

O sistema pode fazer uma reserva ou pagamento para mim?

Não. Ele é apenas para consultas. O envio de reservas, o pagamento, a resolução de captchas, o desvio da fila e a repetição de tentativas de reserva estão explicitamente fora do escopo.

Quais credenciais e configurações são necessárias?

As variáveis de ambiente KSKILL_FORESTTRIP_ID e KSKILL_FORESTTRIP_PASSWORD, além do Python 3.9+ e do navegador Playwright Chromium. É necessária uma sessão com login e CSRF, pois a tela de pesquisa retorna um código de erro 401 quando acessada sem autenticação.

Como minhas credenciais são obtidas?

Nesta ordem: variáveis de ambiente existentes, depois um cofre secreto do agente, em seguida o arquivo dotenv de fallback em ~/.config/k-skill/secrets.env (permissões 0600) e, por fim, perguntando a você. O próprio auxiliar lê apenas as duas variáveis de ambiente.

Posso filtrar por hospedagem versus acampamento?

Sim. Use --categories 01 para hospedagem (숙박), 02 para acampamento (야영) ou 01,02 para ambos.

Por que alguns quartos não aparecem nos resultados?

Os quartos cujo nome inclui “예비” são vagas internas reservadas pela operadora que não são exibidas na tela de reserva do usuário; portanto, o auxiliar os exclui por padrão. Linhas duplicadas para a mesma floresta, data e quarto também são removidas.

Todos os arquivos