開発者向け

Voysparkで構築しよう。
SDK、CLI、MCPサーバー。

フライト、ホテル、コミュニティ、旅プランニングを任意のアプリケーションやAIエージェントに統合するオープンソースのツールキット。TypeScript製、MITライセンス、SDKは外部依存ゼロ。

GitHubで見る今すぐインストール

Voysparkツールキットとは？

アプリケーションやAIエージェントをVoysparkプラットフォームに接続する3つのオープンソースパッケージのセット — リアルタイムのフライト検索、ホテル、旅行者コミュニティ、旅プラン生成など。型安全、MITライセンス、SDKは外部依存ゼロ。

仕組み

1. インターフェースを選ぶ

TypeScript／JavaScriptコード内で使用するSDK。ターミナルから実行するCLI。Claude Desktop、Cursor、Cline、任意のAIエージェントを接続するMCPサーバー。

2. 呼び出す

IATAコードでフライト、都市でホテル、ハッシュタグでコミュニティ投稿を検索し、プロンプトから完全な旅プランを生成。型付きJSONレスポンス。

3. 結果を活用

すべてのレスポンスには、アフィリエイト追跡が埋め込まれた予約URLが含まれます。決済処理なしで報酬を得られます — 手数料はプロバイダーから支払われます。

ツールキットでできるすべて

3つのインターフェースを通じたVoysparkプラットフォームへの完全アクセス。

リアルタイム検索

  • IATAによるフライト（Travelpayouts／Aviasales）
  • 都市によるホテル（Hotellook）
  • レンタカー（DiscoverCars）
  • ツアーと体験（GetYourGuide）
  • 電車、送迎、旅行保険
  • 統合検索（記事＋目的地＋ユーザー＋投稿＋ハッシュタグ＋コミュニティ）

旅のプランニング

  • 旅プランシミュレーター：フライト＋ホテル＋旅程の組み合わせ
  • 推定総コスト計算
  • AIによる日ごとの旅程生成
  • 目的地比較（気候、コスト、安全性）
  • 最適な旅行月の提案

コミュニティとソーシャル

  • 公開プロフィール（@username）
  • ハッシュタグによる旅行者投稿
  • 7つのテーマ別コミュニティ（スロートラベル、フーディー、家族、ソロ女性、絵葉書からの脱却、マイルハッキング、サステナブル）
  • 本物の旅行レポート
  • トラベルゲノム（テイストプロフィール）

編集コンテンツ

  • 7言語のジャーナル記事
  • 60以上のキュレーション済み目的地ガイド
  • AMP Webストーリー
  • 無料ツール（ビザチェッカー、カーボン計算機、ベストマンスなど）

開発者向け

  • 型安全なTypeScript SDK、外部依存ゼロ
  • 4コマンドのカラーCLIバイナリ
  • Claude Desktop／Cursor／Cline／Zed向けstdio MCPサーバー
  • OpenAPI 3.1仕様
  • 全エンティティ上のschema.org JSON-LD
  • llms.txt + llms-full.txt + ai-plugin.json
  • 透明なIPレート制限
  • 全予約URLでの自動アフィリエイト追跡

実際のユースケース

Telegram／WhatsApp上のトラベルボット

「7月のSP-リスボン便を探して」を受け取り、アフィリエイト予約URL付きのオプションを返すClaudeエージェント。完了した予約ごとに報酬を獲得。

Cursor／IDE向けトラベルプラグイン

開発者が「東京への格安便のページを追加して」と依頼すると、Cursorがvoyspark_search_flightsを呼び出し、構造化データを受け取ってコンポーネントを生成。

Claude Desktopによるコンシェルジュ

顧客がMacでClaudeとチャットすると、ClaudeがVoysparkツールを呼び出し、フライト＋ホテル＋旅程の完全な旅プランを数秒で構築。

Next.js上のトラベルアプリ

@voyspark/sdkをNext.jsアプリにインポートし、統合検索、コミュニティ投稿、旅程をクエリ — すべて型安全。

3つのパッケージ、1つのコードベース

同じAPI。3つのインターフェース：コード、ターミナル、AIエージェント。

@voyspark/sdk

パブリックAPI向けTypeScriptクライアント。Node 20+、Deno、Bun、モダンブラウザで動作。型安全、依存ゼロ。

npm install @voyspark/sdk

@voyspark/cli

voysparkターミナルバイナリ。シェルからフライト、ホテル、コミュニティを検索し、旅プランを生成。

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

@voyspark/mcp

Claude Desktop、Cursor、Cline、Zed、任意のModel Context Protocolクライアント向けMCPサーバー。4ツール、2リソース。

npx @voyspark/mcp

クイックスタート

SDK（コード）

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

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

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

MCP経由で公開されるツール

voyspark_search

ユーザー、投稿、ハッシュタグ、コミュニティ、記事、目的地を横断する統合検索。

voyspark_search_flights

Travelpayouts（Aviasales）経由のフライトオファー、アフィリエイト追跡付き予約URL。

voyspark_search_hotels

Hotellook経由のホテルオファー、アフィリエイト追跡付き予約URL。

voyspark_build_trip_plan

旅プランの下書き — フライト＋ホテル＋旅程の組み合わせ、コスト内訳付き。

パブリックエンドポイント

OpenAPI 3.1でドキュメント化。IPレート制限（10/分、60/時）。APIキー階層は2026年に提供開始。

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

openapi.json

AIによる発見性

AIエージェントがVoysparkを自動的に発見します。

llms.txt

llms-full.txt

openapi.json

ai-plugin.json

Pricing

Free

$0

IPレート制限、10リクエスト／分。アフィリエイト追跡付き予約URL。

Pro

近日公開

APIキー、100リクエスト／分、優先サポート、Webhook。

構築の準備はできましたか？

1回のnpm installで、フライト、ホテル、Voysparkコミュニティをあなたのアプリに。

GitHubで見る今すぐインストール

コミュニティとサポート

Issuesとディスカッションチームに連絡
Minha viagem
Voyspark AI