Para programadores

Constrói com Voyspark.
SDK, CLI e servidor MCP.

Toolkit open-source para integrar voos, hotéis, comunidade e planeamento de viagens em qualquer aplicação ou agente IA. TypeScript, MIT, zero dependências externas no SDK.

Ver no GitHubInstalar agora

O que é o toolkit Voyspark?

É um conjunto de 3 pacotes open-source que liga a sua aplicação ou agente IA à plataforma Voyspark — pesquisa de voos em tempo real, hotéis, comunidade de viajantes, geração de itinerários e mais. Tudo type-safe, MIT, sem dependências externas no SDK.

Como funciona

1. Escolha a interface

SDK para usar em código TypeScript/JavaScript. CLI para correr no terminal. Servidor MCP para ligar Claude Desktop, Cursor, Cline ou qualquer agente IA.

2. Faça a chamada

Procure voos por IATA, hotéis por cidade, publicações da comunidade por hashtag, gere planos de viagem completos a partir de um prompt. Resposta em JSON tipado.

3. Use o resultado

Cada resposta inclui URLs de reserva com tracking afiliado embutido. Fatura sem processar pagamentos — comissão paga pelos fornecedores.

Tudo o que o toolkit faz

Acesso completo à plataforma Voyspark via 3 interfaces.

Pesquisa em tempo real

  • Voos por IATA (Travelpayouts/Aviasales)
  • Hotéis por cidade (Hotellook)
  • Aluguer de carros (DiscoverCars)
  • Passeios e experiências (GetYourGuide)
  • Comboios, transferes e seguros
  • Pesquisa unificada (artigos + destinos + utilizadores + publicações + hashtags + comunidades)

Planeamento de viagem

  • Simulador de plano de viagem: voo + hotel + itinerário
  • Cálculo de custo total estimado
  • Itinerário dia a dia gerado por IA
  • Comparação entre destinos (clima, custo, segurança)
  • Sugestão do melhor mês para viajar

Comunidade & social

  • Perfis públicos (@username)
  • Publicações de viajantes por hashtag
  • 7 comunidades temáticas (slow travel, foodies, família, solo, off-the-postcard, milhas, sustentável)
  • Relatos reais de viagem
  • Travel genome (perfil de gosto)

Conteúdo editorial

  • Artigos do Journal em 7 idiomas
  • Mais de 60 guias de destino curados
  • Web Stories AMP
  • Ferramentas grátis (Visa Checker, Carbon Calc, Best Month, etc.)

Para programadores

  • SDK TypeScript type-safe, zero dependências externas
  • Binário CLI com 4 comandos coloridos
  • Servidor MCP stdio para Claude Desktop/Cursor/Cline/Zed
  • Spec OpenAPI 3.1
  • JSON-LD schema.org em todas as entidades
  • llms.txt + llms-full.txt + ai-plugin.json
  • Limite de taxa transparente por IP
  • Tracking afiliado automático em todos os URLs de reserva

Casos de uso reais

Bot de viagem no Telegram/WhatsApp

Um agente Claude que recebe "procura um voo Lisboa-São Paulo em julho" e devolve opções com URLs de reserva afiliadas. Fatura por reserva concluída.

Plugin de viagem no Cursor/IDE

Programador pede "adiciona página com voos baratos para Tóquio" e o Cursor chama voyspark_search_flights, recebe dados estruturados e gera o componente.

Concierge com Claude Desktop

Cliente conversa com o Claude no Mac, o Claude chama as ferramentas do Voyspark e monta um plano de viagem completo em segundos.

Aplicação de viagem next.js

Importa @voyspark/sdk no seu Next.js, consulta pesquisa unificada, publicações da comunidade e itinerários — tudo type-safe.

Três pacotes, uma codebase

Mesma API. Três interfaces: código, terminal, agentes IA.

@voyspark/sdk

Cliente TypeScript da API pública. Funciona em Node 20+, Deno, Bun e browsers modernos. Type-safe, zero deps.

npm install @voyspark/sdk

@voyspark/cli

Binário voyspark para terminal. Procura voos, hotéis, comunidade e gera planos de viagem directamente da shell.

npx @voyspark/cli flights GRU LIS --depart 2026-07-12

@voyspark/mcp

Servidor MCP para Claude Desktop, Cursor, Cline, Zed e qualquer cliente Model Context Protocol. 4 ferramentas, 2 recursos.

npx @voyspark/mcp

Início rápido

SDK (código)

import { VoysparkClient } from '@voyspark/sdk';

const client = new VoysparkClient({ locale: 'pt-PT' });

const flights = await client.searchFlights({
  origin: 'GRU',
  destination: 'LIS',
  depart: '2026-07-12',
  return: '2026-07-26',
  adults: 2,
});

CLI (terminal)

npm install -g @voyspark/cli

voyspark search "lisboa"

voyspark flights GRU LIS \
  --depart 2026-07-12 \
  --return 2026-07-26 \
  --adults 2

MCP (Claude/Cursor)

// ~/Library/Application Support/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "voyspark": {
      "command": "npx",
      "args": ["-y", "@voyspark/mcp"],
      "env": { "VOYSPARK_LOCALE": "pt-PT" }
    }
  }
}

Ferramentas expostas via MCP

voyspark_search

Pesquisa unificada em utilizadores, publicações, hashtags, comunidades, artigos, destinos.

voyspark_search_flights

Ofertas de voo via Travelpayouts (Aviasales) com URLs de reserva afiliados.

voyspark_search_hotels

Ofertas de hotel via Hotellook com URLs de reserva afiliados.

voyspark_build_trip_plan

Plano de viagem provisório — voo + hotel + itinerário com custos.

Endpoints públicos

Documentados em OpenAPI 3.1. Limite por IP (10/min, 60/h). Chave API chega em 2026.

MétodoCaminho
GET/api/search/spotlight
GET/api/search/flights
GET/api/search/hotels
POST/api/trip-plans/simulator

openapi.json

Descoberta por IA

Agentes IA descobrem o Voyspark automaticamente.

llms.txt

llms-full.txt

openapi.json

ai-plugin.json

Preços

Free

€ 0

Limite por IP, 10 req/min. URLs de reserva afiliados.

Pro

Em breve

Chave API, 100 req/min, suporte prioritário, webhooks.

Pronto para construir?

1 npm install e tem voos, hotéis e a comunidade Voyspark na sua aplicação.

Ver no GitHubInstalar agora

Comunidade & suporte

Issues e discussõesFalar com a equipa