Geliştiriciler için

Voyspark ile geliştir.
SDK, CLI ve MCP sunucusu.

Uçuşları, otelleri, topluluğu ve gezi planlamasını herhangi bir uygulamaya veya yapay zeka aracısına entegre etmek için açık kaynaklı araç seti. TypeScript, MIT, SDK'da sıfır harici bağımlılık.

GitHub'da görüntüleŞimdi kur

Voyspark araç seti nedir?

Uygulamanızı veya yapay zeka aracınızı Voyspark platformuna bağlayan 3 açık kaynaklı paketten oluşan bir set — gerçek zamanlı uçuş arama, oteller, gezgin topluluğu, gezi planı oluşturma ve daha fazlası. Tip güvenli, MIT lisanslı, SDK'da sıfır harici bağımlılık.

Nasıl çalışır

1. Bir arayüz seç

TypeScript/JavaScript kodunda kullanmak için SDK. Terminalinizden çalıştırmak için CLI. Claude Desktop, Cursor, Cline veya herhangi bir yapay zeka aracısını bağlamak için MCP sunucusu.

2. Çağrıyı yap

IATA koduyla uçuş, şehre göre otel, hashtag'e göre topluluk gönderileri ara; bir istemden eksiksiz gezi planları oluştur. Tipli JSON yanıtları.

3. Sonucu kullan

Her yanıt, gömülü ortaklık takibi içeren rezervasyon URL'leri içerir. Ödeme işlemi yapmadan kazanırsınız — komisyon sağlayıcılar tarafından ödenir.

Araç setinin yaptığı her şey

3 arayüz üzerinden Voyspark platformuna tam erişim.

Gerçek zamanlı arama

  • IATA ile uçuşlar (Travelpayouts/Aviasales)
  • Şehre göre oteller (Hotellook)
  • Araç kiralama (DiscoverCars)
  • Turlar ve deneyimler (GetYourGuide)
  • Trenler, transferler ve seyahat sigortası
  • Birleşik arama (makaleler + destinasyonlar + kullanıcılar + gönderiler + hashtag'ler + topluluklar)

Gezi planlama

  • Gezi planı simülatörü: uçuş + otel + rota kombinasyonu
  • Tahmini toplam maliyet hesabı
  • Yapay zeka tarafından oluşturulan gün gün rota
  • Destinasyon karşılaştırması (iklim, maliyet, güvenlik)
  • Seyahat için en iyi ay önerisi

Topluluk ve sosyal

  • Herkese açık profiller (@username)
  • Hashtag'e göre gezgin gönderileri
  • 7 temalı topluluk (yavaş seyahat, gurmeler, aile, yalnız kadınlar, kartpostal dışı, mil hackleme, sürdürülebilir)
  • Gerçek gezi notları
  • Seyahat genomu (zevk profili)

Editoryal içerik

  • 9 dilde Journal makaleleri
  • 60+ özenle seçilmiş destinasyon rehberi
  • AMP Web Hikayeleri
  • Ücretsiz araçlar (Vize Denetleyici, Karbon Hesaplayıcı, En İyi Ay vb.)

Geliştiriciler için

  • Tip güvenli TypeScript SDK, sıfır harici bağımlılık
  • 4 komutlu renkli CLI ikili dosyası
  • Claude Desktop/Cursor/Cline/Zed için stdio MCP sunucusu
  • OpenAPI 3.1 spesifikasyonu
  • Her varlıkta schema.org JSON-LD
  • llms.txt + llms-full.txt + ai-plugin.json
  • Şeffaf IP hız sınırlaması
  • Her rezervasyon URL'sinde otomatik ortaklık takibi

Gerçek dünya kullanım senaryoları

Telegram/WhatsApp'ta seyahat botu

"Temmuzda SP-Lizbon uçuşu bul" isteğini alıp ortaklık rezervasyon URL'leriyle seçenekler döndüren bir Claude aracısı. Tamamlanan her rezervasyon başına kazanırsınız.

Cursor/IDE'de seyahat eklentisi

Geliştirici "Tokyo'ya ucuz uçuşların olduğu bir sayfa ekle" der, Cursor voyspark_search_flights'ı çağırır, yapılandırılmış veri alır ve bileşeni oluşturur.

Claude Desktop ile konsiyerj

Müşteri Mac'te Claude ile sohbet eder, Claude Voyspark araçlarını çağırır ve saniyeler içinde uçuş + otel + rota içeren eksiksiz bir gezi planı oluşturur.

Next.js'te seyahat uygulaması

@voyspark/sdk'yı Next.js uygulamanıza aktarın; birleşik aramayı, topluluk gönderilerini ve rotaları sorgulayın — hepsi tip güvenli.

Üç paket, tek kod tabanı

Aynı API. Üç arayüz: kod, terminal, yapay zeka aracıları.

@voyspark/sdk

Herkese açık API için TypeScript istemcisi. Node 20+, Deno, Bun ve modern tarayıcılarda çalışır. Tip güvenli, sıfır bağımlılık.

npm install @voyspark/sdk

@voyspark/cli

voyspark terminal ikili dosyası. Kabuğundan uçuş, otel, topluluk ara ve gezi planları oluştur.

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

@voyspark/mcp

Claude Desktop, Cursor, Cline, Zed ve herhangi bir Model Context Protocol istemcisi için MCP sunucusu. 4 araç, 2 kaynak.

npx @voyspark/mcp

Hızlı başlangıç

SDK (kod)

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

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

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

MCP üzerinden sunulan araçlar

voyspark_search

Kullanıcılar, gönderiler, hashtag'ler, topluluklar, makaleler ve destinasyonlar arasında birleşik arama.

voyspark_search_flights

Ortaklık takipli rezervasyon URL'leriyle Travelpayouts (Aviasales) üzerinden uçuş teklifleri.

voyspark_search_hotels

Ortaklık takipli rezervasyon URL'leriyle Hotellook üzerinden otel teklifleri.

voyspark_build_trip_plan

Gezi planı taslağı — maliyet dökümüyle birlikte uçuş + otel + rota kombinasyonu.

Herkese açık uç noktalar

OpenAPI 3.1 ile belgelenmiştir. IP bazlı hız sınırı (10/dk, 60/sa). API anahtarı katmanı 2026'da geliyor.

YöntemYol
GET/api/search/spotlight
GET/api/search/flights
GET/api/search/hotels
POST/api/trip-plans/simulator

openapi.json

Yapay zeka keşfedilebilirliği

Yapay zeka aracıları Voyspark'ı otomatik olarak keşfeder.

llms.txt

llms-full.txt

openapi.json

ai-plugin.json

Fiyatlandırma

Ücretsiz

$0

IP hız sınırı, 10 istek/dk. Ortaklık takipli rezervasyon URL'leri.

Pro

Yakında

API anahtarı, 100 istek/dk, öncelikli destek, webhook'lar.

Geliştirmeye hazır mısın?

Tek bir npm install ile uçuşlar, oteller ve Voyspark topluluğu uygulamanızda.

GitHub'da görüntüleŞimdi kur

Topluluk ve destek

Sorunlar ve tartışmalarEkiple iletişime geç
Minha viagem
Voyspark AI