Untuk developer
Bangun dengan Voyspark.
SDK, CLI, dan server MCP.
Toolkit open-source untuk mengintegrasikan penerbangan, hotel, komunitas, dan perencanaan perjalanan ke aplikasi atau agen AI apa pun. TypeScript, MIT, tanpa dependensi eksternal di SDK.
Apa itu toolkit Voyspark?
Sekumpulan 3 paket open-source yang menghubungkan aplikasi atau agen AI Anda ke platform Voyspark — pencarian penerbangan real-time, hotel, komunitas pelancong, pembuatan Trip Plan, dan lainnya. Type-safe, berlisensi MIT, tanpa dependensi eksternal di SDK.
Cara kerjanya
1. Pilih antarmuka
SDK untuk digunakan dalam kode TypeScript/JavaScript. CLI untuk dijalankan dari terminal Anda. Server MCP untuk menghubungkan Claude Desktop, Cursor, Cline, atau agen AI apa pun.
2. Lakukan pemanggilan
Cari penerbangan berdasarkan kode IATA, hotel berdasarkan kota, postingan komunitas berdasarkan tagar, buat Trip Plan lengkap dari sebuah prompt. Respons JSON bertipe.
3. Gunakan hasilnya
Setiap respons menyertakan URL pemesanan dengan pelacakan afiliasi tertanam. Anda memperoleh penghasilan tanpa memproses pembayaran — komisi dibayar oleh penyedia.
Semua yang bisa dilakukan toolkit
Akses lengkap ke platform Voyspark melalui 3 antarmuka.
Pencarian real-time
- Penerbangan berdasarkan IATA (Travelpayouts/Aviasales)
- Hotel berdasarkan kota (Hotellook)
- Sewa mobil (DiscoverCars)
- Tur dan pengalaman (GetYourGuide)
- Kereta, transfer, dan asuransi perjalanan
- Pencarian terpadu (artikel + destinasi + pengguna + postingan + tagar + komunitas)
Perencanaan perjalanan
- Simulator Trip Plan: kombinasi penerbangan + hotel + itinerari
- Perhitungan perkiraan total biaya
- Itinerari harian yang dihasilkan AI
- Perbandingan destinasi (iklim, biaya, keamanan)
- Saran bulan terbaik untuk bepergian
Komunitas & sosial
- Profil publik (@username)
- Postingan pelancong berdasarkan tagar
- 7 komunitas bertema (slow travel, foodie, keluarga, wanita solo, off-the-postcard, hacking miles, berkelanjutan)
- Laporan perjalanan nyata
- Travel genome (profil selera)
Konten editorial
- Artikel Journal dalam 9 bahasa
- 60+ panduan destinasi terkurasi
- AMP Web Stories
- Alat gratis (Visa Checker, Carbon Calc, Best Month, dll.)
Untuk developer
- SDK TypeScript type-safe, tanpa dependensi eksternal
- Biner CLI berwarna dengan 4 perintah
- Server MCP stdio untuk Claude Desktop/Cursor/Cline/Zed
- Spesifikasi OpenAPI 3.1
- JSON-LD schema.org pada setiap entitas
- llms.txt + llms-full.txt + ai-plugin.json
- Pembatasan laju per IP yang transparan
- Pelacakan afiliasi otomatis pada setiap URL pemesanan
Kasus penggunaan nyata
Bot perjalanan di Telegram/WhatsApp
Agen Claude yang menerima "carikan saya penerbangan SP-Lisabon pada bulan Juli" dan mengembalikan pilihan dengan URL pemesanan afiliasi. Anda memperoleh penghasilan per pemesanan yang selesai.
Plugin perjalanan di Cursor/IDE
Developer meminta "tambahkan halaman dengan penerbangan murah ke Tokyo" dan Cursor memanggil voyspark_search_flights, menerima data terstruktur, dan menghasilkan komponennya.
Concierge dengan Claude Desktop
Pelanggan mengobrol dengan Claude di Mac, Claude memanggil tool Voyspark dan menyusun Trip Plan lengkap dengan penerbangan + hotel + itinerari dalam hitungan detik.
Aplikasi perjalanan di Next.js
Impor @voyspark/sdk ke aplikasi Next.js Anda, kueri pencarian terpadu, postingan komunitas, dan itinerari — semuanya type-safe.
Tiga paket, satu basis kode
API yang sama. Tiga antarmuka: kode, terminal, agen AI.
@voyspark/sdk
Klien TypeScript untuk API publik. Berjalan di Node 20+, Deno, Bun, dan peramban modern. Type-safe, tanpa dependensi.
npm install @voyspark/sdk@voyspark/cli
Biner terminal voyspark. Cari penerbangan, hotel, komunitas, dan buat Trip Plan dari shell Anda.
npx @voyspark/cli flights GRU LIS --depart 2026-07-12@voyspark/mcp
Server MCP untuk Claude Desktop, Cursor, Cline, Zed, dan klien Model Context Protocol apa pun. 4 tool, 2 resource.
npx @voyspark/mcpMulai cepat
SDK (kode)
import { VoysparkClient } from '@voyspark/sdk';
const client = new VoysparkClient({ locale: 'id' });
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 2MCP (Claude/Cursor)
// ~/Library/Application Support/Claude/claude_desktop_config.json
{
"mcpServers": {
"voyspark": {
"command": "npx",
"args": ["-y", "@voyspark/mcp"],
"env": { "VOYSPARK_LOCALE": "id" }
}
}
}Tool yang tersedia via MCP
voyspark_search
Pencarian terpadu di seluruh pengguna, postingan, tagar, komunitas, artikel, destinasi.
voyspark_search_flights
Penawaran penerbangan via Travelpayouts (Aviasales) dengan URL pemesanan berpelacakan afiliasi.
voyspark_search_hotels
Penawaran hotel via Hotellook dengan URL pemesanan berpelacakan afiliasi.
voyspark_build_trip_plan
Draf Trip Plan — kombinasi penerbangan + hotel + itinerari dengan rincian biaya.
Endpoint publik
Terdokumentasi dalam OpenAPI 3.1. Dibatasi laju per IP (10/mnt, 60/jam). Tier kunci API hadir pada 2026.
| Metode | Path |
|---|---|
| GET | /api/search/spotlight |
| GET | /api/search/flights |
| GET | /api/search/hotels |
| POST | /api/trip-plans/simulator |
Kemudahan ditemukan AI
Agen AI menemukan Voyspark secara otomatis.
Harga
Gratis
$0
Batas laju per IP, 10 permintaan/mnt. URL pemesanan berpelacakan afiliasi.
Pro
Segera hadir
Kunci API, 100 permintaan/mnt, dukungan prioritas, webhook.
Siap membangun?
Satu npm install dan Anda memiliki penerbangan, hotel, dan komunitas Voyspark di aplikasi Anda.