للمطوّرين

ابنِ مع Voyspark.
SDK وCLI وخادم MCP.

مجموعة أدوات مفتوحة المصدر لدمج الطيران والفنادق والمجتمع وتخطيط الرحلات في أي تطبيق أو وكيل ذكاء اصطناعي. TypeScript، رخصة MIT، بلا اعتماديات خارجية في الـ SDK.

عرض على GitHubثبّت الآن

ما هي مجموعة أدوات Voyspark؟

مجموعة من 3 حزم مفتوحة المصدر تربط تطبيقك أو وكيل الذكاء الاصطناعي بمنصة Voyspark — بحث فوري عن الطيران، والفنادق، ومجتمع المسافرين، وإنشاء خطط الرحلات، والمزيد. آمنة الأنواع، مرخّصة بـ MIT، بلا اعتماديات خارجية في الـ SDK.

كيف تعمل

1. اختر واجهة

SDK للاستخدام في شيفرة TypeScript/JavaScript. CLI للتشغيل من طرفيتك. خادم MCP لربط Claude Desktop أو Cursor أو Cline أو أي وكيل ذكاء اصطناعي.

2. نفّذ الاستدعاء

ابحث عن الطيران برمز IATA، والفنادق حسب المدينة، ومنشورات المجتمع بالوسم، وأنشئ خطط رحلات كاملة من موجّه واحد. استجابات JSON محدّدة الأنواع.

3. استخدم النتيجة

تتضمّن كل استجابة روابط حجز بتتبّع عمولة مُضمَّن. تربح دون معالجة المدفوعات — العمولة يدفعها المزوّدون.

كل ما تفعله مجموعة الأدوات

وصول كامل إلى منصة Voyspark عبر 3 واجهات.

بحث فوري

  • الطيران برمز IATA (Travelpayouts/Aviasales)
  • الفنادق حسب المدينة (Hotellook)
  • تأجير السيارات (DiscoverCars)
  • الجولات والتجارب (GetYourGuide)
  • القطارات والمواصلات وتأمين السفر
  • بحث موحّد (مقالات + وجهات + مستخدمون + منشورات + وسوم + مجتمعات)

تخطيط الرحلات

  • محاكي خطط الرحلات: باقة طيران + فندق + خط سير
  • حساب التكلفة الإجمالية التقديرية
  • خط سير يومًا بيوم يُنشئه الذكاء الاصطناعي
  • مقارنة الوجهات (المناخ، التكلفة، الأمان)
  • اقتراح أفضل شهر للسفر

المجتمع والتواصل

  • ملفات شخصية عامة (@username)
  • منشورات المسافرين حسب الوسم
  • 7 مجتمعات موضوعية (السفر البطيء، عشّاق الطعام، العائلات، النساء المنفردات، بعيدًا عن الصور النمطية، اختراق الأميال، السفر المستدام)
  • تقارير رحلات حقيقية
  • الجينوم السفري (ملف التفضيلات)

المحتوى التحريري

  • مقالات المجلة بـ 9 لغات
  • أكثر من 60 دليل وجهة منسّق
  • قصص الويب AMP
  • أدوات مجانية (مدقّق التأشيرات، حاسبة الكربون، أفضل شهر، وغيرها)

للمطوّرين

  • SDK بلغة TypeScript آمن الأنواع، بلا اعتماديات خارجية
  • أداة CLI ملوّنة بأربعة أوامر
  • خادم MCP عبر stdio لـ Claude Desktop/Cursor/Cline/Zed
  • مواصفة OpenAPI 3.1
  • schema.org JSON-LD على كل كيان
  • llms.txt + llms-full.txt + ai-plugin.json
  • تحديد شفّاف للمعدّل حسب IP
  • تتبّع عمولة تلقائي على كل رابط حجز

حالات استخدام واقعية

روبوت سفر على Telegram/WhatsApp

وكيل Claude يتلقّى «جِد لي رحلة من ساو باولو إلى لشبونة في يوليو» ويعيد خيارات بروابط حجز بالعمولة. تربح عن كل حجز مكتمل.

إضافة سفر في Cursor/IDE

يطلب المطوّر «أضف صفحة برحلات رخيصة إلى طوكيو» فيستدعي Cursor أداة voyspark_search_flights، ويتلقّى بيانات مُهيكلة، ويولّد المكوّن.

كونسيرج مع Claude Desktop

يتحدّث العميل مع Claude على الـ Mac، فيستدعي Claude أدوات Voyspark ويبني خطة رحلة كاملة بالطيران + الفنادق + خط السير في ثوانٍ.

تطبيق سفر على Next.js

استورد @voyspark/sdk إلى تطبيق Next.js الخاص بك، واستعلم عن البحث الموحّد ومنشورات المجتمع وخطوط السير — كل ذلك آمن الأنواع.

ثلاث حزم، قاعدة شيفرة واحدة

نفس الـ API. ثلاث واجهات: الشيفرة، الطرفية، وكلاء الذكاء الاصطناعي.

@voyspark/sdk

عميل TypeScript للـ API العام. يعمل على Node 20+ وDeno وBun والمتصفحات الحديثة. آمن الأنواع، بلا اعتماديات.

npm install @voyspark/sdk

@voyspark/cli

الأداة الطرفية voyspark. ابحث عن الطيران والفنادق والمجتمع وأنشئ خطط الرحلات من الطرفية.

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

@voyspark/mcp

خادم MCP لـ Claude Desktop وCursor وCline وZed وأي عميل Model Context Protocol. 4 أدوات، ومصدرَان.

npx @voyspark/mcp

بداية سريعة

SDK (شيفرة)

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

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

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

CLI (طرفية)

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

الأدوات المتاحة عبر MCP

voyspark_search

بحث موحّد عبر المستخدمين والمنشورات والوسوم والمجتمعات والمقالات والوجهات.

voyspark_search_flights

عروض الطيران عبر Travelpayouts (Aviasales) مع روابط حجز مُتتبَّعة بالعمولة.

voyspark_search_hotels

عروض الفنادق عبر Hotellook مع روابط حجز مُتتبَّعة بالعمولة.

voyspark_build_trip_plan

مسودة خطة رحلة — باقة طيران + فندق + خط سير مع تفصيل للتكلفة.

نقاط النهاية العامة

موثّقة بمعيار OpenAPI 3.1. محدودة المعدّل حسب عنوان IP (10/دقيقة، 60/ساعة). طبقة مفتاح الـ API تُطرح في 2026.

الطريقةالمسار
GET/api/search/spotlight
GET/api/search/flights
GET/api/search/hotels
POST/api/trip-plans/simulator

openapi.json

قابلية اكتشاف الذكاء الاصطناعي

يكتشف وكلاء الذكاء الاصطناعي Voyspark تلقائيًا.

llms.txt

llms-full.txt

openapi.json

ai-plugin.json

التسعير

مجاني

$0

حد معدّل حسب IP، 10 طلبات/دقيقة. روابط حجز مُتتبَّعة بالعمولة.

Pro

قريبًا

مفتاح API، 100 طلب/دقيقة، دعم بأولوية، webhooks.

جاهز للبناء؟

أمر npm install واحد وتحصل على الطيران والفنادق ومجتمع Voyspark في تطبيقك.

عرض على GitHubثبّت الآن

المجتمع والدعم

المشكلات والنقاشاتتواصل مع الفريق
Minha viagem
Voyspark AI