Per sviluppatori

Costruisci con Voyspark.
SDK, CLI e server MCP.

Toolkit open-source per integrare voli, hotel, comunità e pianificazione viaggi in qualsiasi applicazione o agente IA. TypeScript, MIT, zero dipendenze esterne nell'SDK.

Vedi su GitHubInstalla ora

Cos'è il toolkit Voyspark?

Un set di 3 pacchetti open-source che collega la tua applicazione o agente IA alla piattaforma Voyspark — ricerca voli in tempo reale, hotel, comunità di viaggiatori, generazione di itinerari e altro. Type-safe, MIT, zero dipendenze esterne nell'SDK.

Come funziona

1. Scegli l'interfaccia

SDK per codice TypeScript/JavaScript. CLI per terminale. Server MCP per collegare Claude Desktop, Cursor, Cline o qualsiasi agente IA.

2. Fai la chiamata

Cerca voli per IATA, hotel per città, post per hashtag, genera trip plan completi da un prompt. Risposta in JSON tipizzato.

3. Usa il risultato

Ogni risposta include URL di prenotazione con tracking affiliato incorporato. Guadagni senza processare pagamenti — commissione pagata dai provider.

Tutto quello che fa il toolkit

Accesso completo alla piattaforma Voyspark tramite 3 interfacce.

Ricerca in tempo reale

  • Voli per IATA (Travelpayouts/Aviasales)
  • Hotel per città (Hotellook)
  • Noleggio auto (DiscoverCars)
  • Tour ed esperienze (GetYourGuide)
  • Treni, trasferimenti e assicurazione viaggio
  • Ricerca unificata (articoli + destinazioni + utenti + post + hashtag + comunità)

Pianificazione del viaggio

  • Simulatore di trip plan: combo volo + hotel + itinerario
  • Calcolo costo totale stimato
  • Itinerario giorno per giorno generato dall'IA
  • Confronto tra destinazioni (clima, costo, sicurezza)
  • Suggerimento del miglior mese per viaggiare

Comunità & social

  • Profili pubblici (@username)
  • Post di viaggiatori per hashtag
  • 7 comunità tematiche (slow travel, foodies, famiglia, solo donne, off-the-postcard, miglia, sostenibile)
  • Veri trip report
  • Travel genome (profilo di gusto)

Contenuto editoriale

  • Articoli del Journal in 7 lingue
  • Oltre 60 guide di destinazione curate
  • Web Stories AMP
  • Strumenti gratuiti (Visa Checker, Carbon Calc, Best Month, ecc.)

Per sviluppatori

  • SDK TypeScript type-safe, zero dipendenze esterne
  • Binario CLI colorato con 4 comandi
  • Server MCP stdio per Claude Desktop/Cursor/Cline/Zed
  • Spec OpenAPI 3.1
  • JSON-LD schema.org su ogni entità
  • llms.txt + llms-full.txt + ai-plugin.json
  • Rate limiting trasparente per IP
  • Tracking affiliato automatico su ogni URL di prenotazione

Casi d'uso reali

Bot di viaggio su Telegram/WhatsApp

Un agente Claude che riceve "trovami un volo Roma-Lisbona a luglio" e restituisce opzioni con URL affiliati. Guadagni per ogni prenotazione.

Plugin di viaggio in Cursor/IDE

Dev chiede "aggiungi una pagina con voli economici per Tokyo" e Cursor chiama voyspark_search_flights, riceve i dati e genera il componente.

Concierge con Claude Desktop

Cliente parla con Claude su Mac, Claude chiama i tool di Voyspark e costruisce un trip plan completo in pochi secondi.

App di viaggio in Next.js

Importa @voyspark/sdk nel tuo Next.js, interroga ricerca unificata, post e itinerari — tutto type-safe.

Tre pacchetti, una codebase

Stessa API. Tre interfacce: codice, terminale, agenti IA.

@voyspark/sdk

Client TypeScript dell'API pubblica. Funziona su Node 20+, Deno, Bun e browser moderni. Type-safe, zero deps.

npm install @voyspark/sdk

@voyspark/cli

Binario voyspark per terminale. Cerca voli, hotel, comunità e genera trip plan direttamente dalla shell.

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

@voyspark/mcp

Server MCP per Claude Desktop, Cursor, Cline, Zed e qualsiasi client Model Context Protocol. 4 strumenti, 2 risorse.

npx @voyspark/mcp

Avvio rapido

SDK (codice)

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

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

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

CLI (terminale)

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

Strumenti esposti via MCP

voyspark_search

Ricerca unificata su utenti, post, hashtag, comunità, articoli, destinazioni.

voyspark_search_flights

Offerte di volo via Travelpayouts (Aviasales) con URL di prenotazione affiliati.

voyspark_search_hotels

Offerte di hotel via Hotellook con URL di prenotazione affiliati.

voyspark_build_trip_plan

Trip plan provvisorio — volo + hotel + itinerario con costi.

Endpoint pubblici

Documentati in OpenAPI 3.1. Limite per IP (10/min, 60/h). Chiave API nel 2026.

MetodoPercorso
GET/api/search/spotlight
GET/api/search/flights
GET/api/search/hotels
POST/api/trip-plans/simulator

openapi.json

Scoperta da IA

Gli agenti IA scoprono Voyspark automaticamente.

llms.txt

llms-full.txt

openapi.json

ai-plugin.json

Prezzi

Free

€ 0

Limite per IP, 10 req/min. URL di prenotazione affiliati.

Pro

In arrivo

Chiave API, 100 req/min, supporto prioritario, webhook.

Pronto a costruire?

Un npm install e hai voli, hotel e la comunità Voyspark nella tua app.

Vedi su GitHubInstalla ora

Comunità e supporto

Issue e discussioniContatta il team