Para desarrolladores

Construye con Voyspark.
SDK, CLI y servidor MCP.

Toolkit open-source para integrar vuelos, hoteles, comunidad y planificación de viajes en cualquier aplicación o agente IA. TypeScript, MIT, cero dependencias externas en el SDK.

Ver en GitHubInstalar ahora

¿Qué es el toolkit Voyspark?

Un conjunto de 3 paquetes open-source que conecta tu aplicación o agente IA a la plataforma Voyspark — búsqueda de vuelos en tiempo real, hoteles, comunidad de viajeros, generación de itinerarios y más. Type-safe, MIT, cero dependencias externas en el SDK.

Cómo funciona

1. Elige la interfaz

SDK para usar en código TypeScript/JavaScript. CLI para correr en terminal. Servidor MCP para conectar Claude Desktop, Cursor, Cline o cualquier agente IA.

2. Haz la llamada

Busca vuelos por código IATA, hoteles por ciudad, publicaciones por hashtag, genera planes de viaje completos desde un prompt. JSON tipado.

3. Usa el resultado

Cada respuesta incluye URLs de reserva con tracking afiliado embebido. Ganas sin procesar pagos — comisión pagada por proveedores.

Todo lo que hace el toolkit

Acceso completo a la plataforma Voyspark a través de 3 interfaces.

Búsqueda en tiempo real

  • Vuelos por IATA (Travelpayouts/Aviasales)
  • Hoteles por ciudad (Hotellook)
  • Alquiler de coches (DiscoverCars)
  • Tours y experiencias (GetYourGuide)
  • Trenes, traslados y seguros de viaje
  • Búsqueda unificada (artículos + destinos + usuarios + publicaciones + hashtags + comunidades)

Planificación de viaje

  • Simulador de plan de viaje: vuelo + hotel + itinerario
  • Cálculo de coste total estimado
  • Itinerario día a día generado por IA
  • Comparación entre destinos (clima, coste, seguridad)
  • Sugerencia del mejor mes para viajar

Comunidad & social

  • Perfiles públicos (@username)
  • Publicaciones de viajeros por hashtag
  • 7 comunidades temáticas (slow travel, foodies, familia, solo mujer, off-the-postcard, millas, sostenible)
  • Reportes reales de viaje
  • Travel genome (perfil de gusto)

Contenido editorial

  • Artículos del Journal en 7 idiomas
  • Más de 60 guías de destino curadas
  • Web Stories AMP
  • Herramientas gratis (Visa Checker, Carbon Calc, Best Month, etc.)

Para desarrolladores

  • SDK TypeScript type-safe, cero dependencias externas
  • Binario CLI con 4 comandos a color
  • Servidor MCP stdio para Claude Desktop/Cursor/Cline/Zed
  • Spec OpenAPI 3.1
  • JSON-LD schema.org en cada entidad
  • llms.txt + llms-full.txt + ai-plugin.json
  • Rate limiting transparente por IP
  • Tracking afiliado automático en todas las URLs de reserva

Casos de uso reales

Bot de viaje en Telegram/WhatsApp

Un agente Claude que recibe "búscame un vuelo Madrid-Lisboa en julio" y devuelve opciones con URLs afiliadas. Ganas por reserva concluida.

Plugin de viaje en Cursor/IDE

Dev pide "añade una página con vuelos baratos a Tokio" y Cursor llama voyspark_search_flights, recibe datos estructurados y genera el componente.

Concierge con Claude Desktop

Cliente conversa con Claude en Mac, Claude llama las herramientas de Voyspark y arma un plan de viaje completo en segundos.

App de viaje Next.js

Importa @voyspark/sdk en tu Next.js, consulta búsqueda unificada, publicaciones e itinerarios — todo type-safe.

Tres paquetes, una codebase

Misma API. Tres interfaces: código, terminal, agentes IA.

@voyspark/sdk

Cliente TypeScript de la API pública. Funciona en Node 20+, Deno, Bun y navegadores modernos. Type-safe, cero deps.

npm install @voyspark/sdk

@voyspark/cli

Binario voyspark para terminal. Busca vuelos, hoteles, comunidad y genera planes de viaje desde la shell.

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

@voyspark/mcp

Servidor MCP para Claude Desktop, Cursor, Cline, Zed y cualquier cliente Model Context Protocol. 4 herramientas, 2 recursos.

npx @voyspark/mcp

Inicio rápido

SDK (código)

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

const client = new VoysparkClient({ locale: 'es' });

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": "es" }
    }
  }
}

Herramientas expuestas vía MCP

voyspark_search

Búsqueda unificada en usuarios, publicaciones, hashtags, comunidades, artículos, destinos.

voyspark_search_flights

Ofertas de vuelo vía Travelpayouts (Aviasales) con URLs de reserva afiliados.

voyspark_search_hotels

Ofertas de hotel vía Hotellook con URLs de reserva afiliados.

voyspark_build_trip_plan

Plan de viaje provisional — vuelo + hotel + itinerario con costes.

Endpoints públicos

Documentados en OpenAPI 3.1. Límite por IP (10/min, 60/h). Clave API llega en 2026.

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

openapi.json

Descubrimiento por IA

Los agentes IA descubren Voyspark automáticamente.

llms.txt

llms-full.txt

openapi.json

ai-plugin.json

Precios

Gratis

$0

Límite por IP, 10 req/min. URLs de reserva afiliados.

Pro

Próximamente

Clave API, 100 req/min, soporte prioritario, webhooks.

¿Listo para construir?

Un npm install y tienes vuelos, hoteles y la comunidad Voyspark en tu app.

Ver en GitHubInstalar ahora

Comunidad y soporte

Issues y discusionesContactar al equipo