Kit de Ferramentas de Viagem Hacking: Habilidades em IA e Servidores MCP para Busca de Pontos e Milhas

O Travel Hacking Toolkit é uma coleção de habilidades de IA e servidores MCP que permitem que agentes de IA de programação lidem com o planejamento de viagens usando pontos e milhas. Ele ensina o Claude Code e o OpenCode a responder à pergunta central: "Devo usar pontos ou pagar em dinheiro?" automatizando pesquisas em várias fontes de dados.

Configuração Rápida

Clone o repositório e execute o script de configuração:

git clone https://github.com/borski/travel-hacking-toolkit.git
cd travel-hacking-toolkit
./scripts/setup.sh

O script de configuração orienta você na escolha da sua ferramenta (OpenCode, Claude Code ou ambos), cria arquivos de configuração para chaves de API, instala dependências e, opcionalmente, instala as habilidades em todo o sistema. Para o Claude Code, inicie com:

claude --strict-mcp-config --mcp-config .mcp.json

A flag --strict-mcp-config instrui o Claude Code a carregar os servidores MCP diretamente do arquivo de configuração, o que é mais confiável do que a descoberta automática.

O Que Está Incluído

Servidores MCP (Ferramentas em Tempo Real)

• Skiplagged: Pesquisa de voos com tarifas de cidade oculta (não requer chave de API)
• Kiwi.com: Voos com interligação virtual (não requer chave de API)
• Trivago: Metapesquisa de hotéis em sites de reserva (não requer chave de API)
• Ferryhopper: Rotas de balsa em 33 países, mais de 190 operadoras (não requer chave de API)
• Airbnb: Pesquisa de listagens do Airbnb com correção de geocodificação e filtro por tipo de propriedade (não requer chave de API)
• LiteAPI: Pesquisa de hotéis com tarifas ao vivo e reserva (requer chave LiteAPI)

Habilidades (Conhecimento de API para Sua IA)

• duffel: Pesquisa de voos em tempo real em várias companhias aéreas via API Duffel
• seats-aero: Disponibilidade de voos com milhas em mais de 25 programas de fidelidade (requer chave Seats.aero Pro/Partner)
• awardwallet: Saldos de programas de fidelidade, status de elite, histórico (requer chave AwardWallet Business)
• serpapi: Preços em dinheiro no Google Flights, hotéis, descoberta de destinos (requer chave SerpAPI)
• rapidapi: Preços secundários via Google Flights Live + Booking.com (requer chave RapidAPI)
• atlas-obscura: Tesouros escondidos perto de qualquer destino (não requer chave de API)
• scandinavia-transit: Trens, ônibus, balsas na Noruega/Suécia/Dinamarca (requer chaves Entur + Trafiklab)
• wheretocredit: Taxas de ganho de milhas por companhia aérea e classe de reserva em mais de 50 programas de fidelidade (não requer chave de API)

Como Funciona

As habilidades são arquivos markdown que ensinam sua IA a chamar APIs de viagem. Eles contêm documentação de endpoints, exemplos de curl, filtros úteis de jq e orientações de fluxo de trabalho. Tanto o OpenCode quanto o Claude Code suportam habilidades nativamente. O diretório skills/ é a fonte canônica.

Os servidores MCP dão à sua IA ferramentas em tempo real que ela pode chamar diretamente. As configurações estão em opencode.json para o OpenCode e .mcp.json para o Claude Code. Cinco dos seis servidores MCP não precisam de chaves de API.

Chaves de API Necessárias

Para a experiência completa, adicione no mínimo:

• SEATS_AERO_API_KEY: Para pesquisa de voos com milhas (Pro ~US$ 8/mês)
• SERPAPI_API_KEY: Para comparação de preços em dinheiro (100 pesquisas gratuitas/mês)

Dados de Referência Incluídos

O kit de ferramentas inclui proporções de parceiros de transferência para Chase UR, Amex MR, Bilt, Capital One e Citi TY. As avaliações de pontos são provenientes de TPG, Upgraded Points, OMAAT e View From The Wing. Também contém dados de associação em alianças, resgates vantajosos, janelas de reserva e referências de marcas de cadeias de hotéis.