Pour les développeurs

Construis avec Voyspark.
SDK, CLI et serveur MCP.

Toolkit open-source pour intégrer vols, hôtels, communauté et planification de voyage dans toute application ou agent IA. TypeScript, MIT, zéro dépendance externe dans le SDK.

Voir sur GitHubInstaller

Qu'est-ce que le toolkit Voyspark ?

Un ensemble de 3 paquets open-source qui connecte votre application ou agent IA à la plateforme Voyspark — recherche de vols en temps réel, hôtels, communauté de voyageurs, génération d'itinéraires et plus. Type-safe, MIT, zéro dépendance externe dans le SDK.

Comment ça marche

1. Choisissez l'interface

SDK pour code TypeScript/JavaScript. CLI pour le terminal. Serveur MCP pour connecter Claude Desktop, Cursor, Cline ou tout agent IA.

2. Faites l'appel

Recherchez vols par IATA, hôtels par ville, posts par hashtag, générez des plans de voyage complets depuis un prompt. JSON typé.

3. Utilisez le résultat

Chaque réponse inclut des URLs de réservation avec tracking d'affiliation embarqué. Vous gagnez sans traiter les paiements — commission payée par les fournisseurs.

Tout ce que fait le toolkit

Accès complet à la plateforme Voyspark via 3 interfaces.

Recherche en temps réel

  • Vols par IATA (Travelpayouts/Aviasales)
  • Hôtels par ville (Hotellook)
  • Location de voiture (DiscoverCars)
  • Activités et excursions (GetYourGuide)
  • Trains, transferts et assurance voyage
  • Recherche unifiée (articles + destinations + utilisateurs + posts + hashtags + communautés)

Planification de voyage

  • Simulateur de plan de voyage : vol + hôtel + itinéraire
  • Calcul du coût total estimé
  • Itinéraire jour par jour généré par IA
  • Comparaison entre destinations (climat, coût, sécurité)
  • Suggestion du meilleur mois pour voyager

Communauté & social

  • Profils publics (@username)
  • Posts de voyageurs par hashtag
  • 7 communautés thématiques (slow travel, foodies, famille, solo femmes, off-the-postcard, miles, durable)
  • Vrais récits de voyage
  • Travel genome (profil de goût)

Contenu éditorial

  • Articles du Journal en 7 langues
  • Plus de 60 guides de destination curatés
  • Web Stories AMP
  • Outils gratuits (Visa Checker, Carbon Calc, Best Month, etc.)

Pour développeurs

  • SDK TypeScript type-safe, zéro dépendance externe
  • Binaire CLI coloré avec 4 commandes
  • Serveur MCP stdio pour Claude Desktop/Cursor/Cline/Zed
  • Spec OpenAPI 3.1
  • JSON-LD schema.org sur chaque entité
  • llms.txt + llms-full.txt + ai-plugin.json
  • Limite de débit transparente par IP
  • Tracking d'affiliation automatique sur tous les URLs de réservation

Cas d'usage réels

Bot de voyage sur Telegram/WhatsApp

Un agent Claude qui reçoit « trouve un vol Paris-Lisbonne en juillet » et renvoie des options avec URLs d'affiliation. Vous gagnez par réservation.

Plugin de voyage dans Cursor/IDE

Dev demande « ajoute une page avec vols pas chers vers Tokyo » et Cursor appelle voyspark_search_flights, reçoit les données et génère le composant.

Conciergerie avec Claude Desktop

Client discute avec Claude sur Mac, Claude appelle les outils Voyspark et construit un plan complet en quelques secondes.

App de voyage en Next.js

Importez @voyspark/sdk dans votre Next.js, interrogez la recherche unifiée, les posts et itinéraires — tout type-safe.

Trois packages, une codebase

Même API. Trois interfaces: code, terminal, agents IA.

@voyspark/sdk

Client TypeScript de l'API publique. Fonctionne sur Node 20+, Deno, Bun et navigateurs modernes. Type-safe, zéro dep.

npm install @voyspark/sdk

@voyspark/cli

Binaire voyspark pour terminal. Recherche vols, hôtels, communauté et génère des plans de voyage depuis le shell.

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

@voyspark/mcp

Serveur MCP pour Claude Desktop, Cursor, Cline, Zed et tout client Model Context Protocol. 4 outils, 2 ressources.

npx @voyspark/mcp

Démarrage rapide

SDK (code)

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

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

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

Outils exposés via MCP

voyspark_search

Recherche unifiée sur utilisateurs, posts, hashtags, communautés, articles, destinations.

voyspark_search_flights

Offres de vol via Travelpayouts (Aviasales) avec URLs de réservation affiliés.

voyspark_search_hotels

Offres d'hôtel via Hotellook avec URLs de réservation affiliés.

voyspark_build_trip_plan

Plan de voyage provisoire — vol + hôtel + itinéraire avec coûts.

Endpoints publics

Documentés en OpenAPI 3.1. Limite par IP (10/min, 60/h). Clé API en 2026.

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

openapi.json

Découvrabilité IA

Les agents IA découvrent Voyspark automatiquement.

llms.txt

llms-full.txt

openapi.json

ai-plugin.json

Tarifs

Gratuit

0 €

Limite par IP, 10 req/min. URLs de réservation affiliés.

Pro

Bientôt

Clé API, 100 req/min, support prioritaire, webhooks.

Prêt à construire ?

Un npm install et vous avez vols, hôtels et la communauté Voyspark dans votre app.

Voir sur GitHubInstaller

Communauté et support

Issues et discussionsContacter l'équipe