Para desenvolvedores

Construa com Voyspark.
SDK, CLI e MCP server.

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

Ver no GitHub Instalar agora

O que é o toolkit Voyspark?

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

Como funciona

1. Escolha a interface

SDK pra usar em código TypeScript/JavaScript. CLI pra rodar no terminal. MCP server pra conectar Claude Desktop, Cursor, Cline ou qualquer agente IA.

2. Faça a chamada

Busque voos por IATA, hotéis por cidade, posts da comunidade por hashtag, gere trip plans completos a partir de um prompt. Retorno em JSON tipado.

3. Use o resultado

Cada resposta inclui URLs de reserva com tracking afiliado embutido. Você fatura sem precisar processar pagamentos — comissão paga pelos provedores.

Tudo que o toolkit faz

Acesso completo à plataforma Voyspark via 3 interfaces.

Busca em tempo real

Voos por IATA (Travelpayouts/Aviasales)
Hotéis por cidade (Hotellook)
Aluguel de carros (DiscoverCars)
Passeios e experiências (GetYourGuide)
Trens, transfers e seguros de viagem
Busca unificada (artigos + destinos + users + posts + hashtags + comunidades)

Planejamento de viagem

Trip plan simulator: combo voo + hotel + roteiro
Cálculo de custo total estimado
Itinerário dia a dia gerado por IA
Comparação entre destinos (clima, custo, segurança)
Sugestão de melhor mês pra viajar

Comunidade & social

Perfis públicos (@username)
Posts de viajantes por hashtag
7 comunidades temáticas (slow travel, foodies, family, solo, off-the-postcard, milhas, sustentável)
Trip reports reais
Travel genome (perfil de gosto)

Conteúdo editorial

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

Para developers

TypeScript SDK type-safe, zero deps externas
CLI binário com 4 comandos coloridos
MCP server stdio pra Claude Desktop/Cursor/Cline/Zed
OpenAPI 3.1 spec
JSON-LD schema.org em todas entidades
llms.txt + llms-full.txt + ai-plugin.json
Rate limiting transparente por IP
Affiliate tracking automático em todas booking URLs

Casos de uso reais

Bot de viagem no Telegram/WhatsApp

Um agente Claude que recebe "acha um voo SP-Lisboa em julho" e devolve opções com URLs de reserva afiliadas. Você fatura por reserva concluída.

Plugin de viagem no Cursor/IDE

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

Concierge com Claude Desktop

Cliente conversa com Claude no Mac, Claude chama as tools do Voyspark e monta trip plan completo com voos + hotéis + roteiro em segundos.

App de viagem next.js

Importa @voyspark/sdk no seu Next.js, consulta busca unificada, posts 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 pra terminal. Busca voos, hotéis, comunidade e gera trip plans direto do shell.

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

@voyspark/mcp

MCP server pra Claude Desktop, Cursor, Cline, Zed e qualquer cliente Model Context Protocol. 4 tools, 2 resources.

npx @voyspark/mcp

Quick start

SDK (código)

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

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

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-BR" }
    }
  }
}

Tools expostas via MCP

voyspark_search

Busca unificada em users, posts, hashtags, comunidades, artigos, destinos.

voyspark_search_flights

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

voyspark_search_hotels

Ofertas de hotel via Hotellook com booking URLs afiliados.

voyspark_build_trip_plan

Trip plan draft — combo voo + hotel + roteiro com custos.

Endpoints públicos

Documentados em OpenAPI 3.1. Rate-limited por IP (10/min, 60/h). API key chega em 2026.

Método	Caminho	Descrição
GET	/api/search/spotlight	Busca unificada
GET	/api/search/flights	Ofertas de voo
GET	/api/search/hotels	Ofertas de hotel
POST	/api/trip-plans/simulator	Simulador de trip plan

openapi.json

AI discoverability

Agentes IA descobrem o Voyspark automaticamente.

llms.txt

llms-full.txt

openapi.json

ai-plugin.json

Preços

Free

R$ 0

Rate limit por IP, 10 req/min. Affiliate-tracked booking URLs.

Pro

Em breve

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

Pronto pra construir?

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