O que Planejador de Preços de Viagem faz?
Regra Principal
Encontre a opção razoável mais barata, não o preço de lista mais baixo. Compare o custo final a pagar, complementos obrigatórios, ajuste de horário, parte emissora, pós-venda, termos de reembolso/alteração/cancelamento e risco de conexão ou estadia antes de recomendar um caminho de reserva.
Não reserve, pague, faça login, insira dados pessoais, armazene credenciais, burle CAPTCHAs ou use raspagem furtiva ou anti-detecção. Pare antes de ações de compra ou conta e peça confirmação explícita do usuário.
Fluxo de Trabalho
- Colete apenas as restrições de alto impacto faltantes: flexibilidade de datas, flexibilidade de origem/destino, viajantes, bagagens, horário de chegada obrigatório, teto de orçamento, necessidade de reembolso, moeda de pagamento, limites de visto/trânsito, área de hospedagem, necessidade de cancelamento e preferências de horário de trem.
- Leia
references/default-preferences.mdquando o usuário não tiver declarado suas preferências ou quando você precisar de um modelo de preferências reutilizável. - Leia
references/source-matrix.mdpara escolher fontes de busca por tipo de viagem e região. - Verifique preços ao vivo através de acesso normal à web ou navegador, usando fontes oficiais primeiro quando a verificação final for importante. Registre URL da fonte, timestamp e fuso horário, moeda, total final exibido, parte emissora/agência de reserva, bagagem ou café da manhã, termos de cancelamento/reembolso/alteração e taxas visíveis.
- Leia
references/risk-rules.mdsempre que uma opção envolver reserva OTA, autotransferência, bilhetes separados, bagagem pouco clara, hospedagem não reembolsável, agentes ferroviários, países de trânsito, descontos incomuns, preços somente com login ou um período de eventos voláteis. - Leia
references/scoring-model.mdpara classificar opções por custo total e risco de reserva. - Se houver muitas linhas de cotação, monte um CSV e execute
scripts/normalize_travel_quotes.pypara produzir uma tabela de comparação determinística. O script normaliza apenas cotações coletadas manualmente; ele não busca preços ao vivo. - Apresente uma recomendação com: melhor opção geral, opção mais barata aceitável, opções a evitar, rota exata de reserva e o que verificar na página final de checkout.
Estratégia de Fontes
- Voos: comece com uma fonte de metabusca como Google Flights para descoberta de datas e rotas, depois verifique o itinerário mais forte no site oficial da companhia aérea. Use OTAs e fontes secundárias de metabusca apenas para verificar se existe uma diferença de preço significativa.
- Hotéis: comece com um mapa ou fonte de metabusca de hotéis para área e faixa de preço, depois compare as principais OTAs e o site oficial da propriedade. Compare impostos finais, taxas, tipo de quarto, cancelamento, depósito, café da manhã e custo de transporte ajustado pela localização.
- Trens: priorize operadoras ferroviárias oficiais para classe tarifária e regras. Use Trainline, Omio, Trip.com ou agentes similares para comparação, conveniência ou descoberta multimodal.
- APIs como Skyscanner, Amadeus, Duffel, Hotelbeds ou Expedia Rapid exigem contas legítimas e variáveis de ambiente fornecidas pelo usuário. Não invente acesso à API nem implique cobertura de API ao vivo quando ela não estiver configurada.
Padrão de Saída
Distinga estes níveis:
recomendado: melhor equilíbrio custo/risco total.mais barato aceitável: opção mais barata que ainda é praticamente reservável.opcional: aceitável, mas nem a mais forte no geral nem a mais barata aceitável.mais barato mas arriscado: preço menor com risco material de pós-venda, reembolso, bagagem, transferência, visto ou taxas ocultas.evitar: não recomende a menos que o usuário aceite explicitamente o risco.
Para cada opção recomendada, inclua um caminho de reserva concreto, como Google Flights -> site oficial da companhia aérea, tarifa reembolsável do Booking.com, site oficial da Trenitalia ou site oficial da 12306.
Mantenha as regras tarifárias, textos de cancelamento, regras de bagagem e nomes de plataformas no idioma original quando a precisão for importante, depois explique-os claramente no idioma do usuário.
Uso de Script
Use o normalizador após coletar linhas de cotação:
python3 /caminho/para/travel-price-planner/scripts/normalize_travel_quotes.py quotes.csv --base-currency EUR --fx USD=0.92 --fx CNY=0.127 --direct-margin 50 --format markdown
Resolva o caminho do script relativo a este diretório de habilidade. Não presuma que o diretório de trabalho atual é o diretório da habilidade.
Colunas mínimas úteis do CSV:
label,category,source,currency,total_price,mandatory_fees,baggage_fee,payment_fee,local_transport_cost,risk_flags,booking_party,url,notes
As flags de risco são separadas por ponto e vírgula, por exemplo ota;no_checked_bag;self_transfer;nonrefundable.
Verificação Final de Segurança
Antes de recomendar "reserve agora", verifique a opção na página de checkout ou na página oficial de detalhes se acessível, e declare o timestamp. Se o checkout final não puder ser acessado sem login ou inserção de dados pessoais, informe isso e trate o preço como provisório.