Communitygithub.com

Planejador de Preços de Viagem

Uma habilidade do Codex para comparar voos, hotéis, trens e itinerários mistos de viagem por custo total e risco.

O que é Planejador de Preços de Viagem?

O Planejador de Preços de Viagem (Travel Price Planner) é uma habilidade especializada projetada para agentes de IA como o Codex, que ajuda usuários a planejar viagens comparando opções de voos, hotéis, trens e itinerários mistos. A habilidade foca em encontrar a opção de menor custo total e risco, em vez de apenas o preço de lista mais baixo. Ela suporta múltiplas fontes de busca (como Google Flights, Booking.com e operadoras oficiais de trem) e inclui um fluxo de trabalho estruturado: coleta de restrições do usuário, consulta a referências como `default-preferences.md` e `source-matrix.md`, verificação de preços ao vivo, avaliação de riscos usando `risk-rules.md`, classificação de opções com `scoring-model.md` e normalização de cotações com um script Python. A habilidade enfatiza segurança, proibindo ações como fazer login, inserir dados pessoais ou burlar CAPTCHAs, e sempre solicita confirmação explícita do usuário antes de recomendar uma reserva. Recomendações são categorizadas em níveis como 'recomendado', 'mais barato aceitável' e 'mais barato mas arriscado', com caminhos de reserva concretos e verificações finais de segurança.

Funciona com~Claude Code✓Codex CLI~Cursor
npx skills add AichenFilm/travel-price-planner-skill

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

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

  1. 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.
  2. Leia references/default-preferences.md quando o usuário não tiver declarado suas preferências ou quando você precisar de um modelo de preferências reutilizável.
  3. Leia references/source-matrix.md para escolher fontes de busca por tipo de viagem e região.
  4. 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.
  5. Leia references/risk-rules.md sempre 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.
  6. Leia references/scoring-model.md para classificar opções por custo total e risco de reserva.
  7. Se houver muitas linhas de cotação, monte um CSV e execute scripts/normalize_travel_quotes.py para produzir uma tabela de comparação determinística. O script normaliza apenas cotações coletadas manualmente; ele não busca preços ao vivo.
  8. 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.

Habilidades Relacionadas