面向开发者

与Voyspark构建。
SDK、CLI和MCP服务器。

开源工具包，将航班、酒店、社区和旅行规划集成到任何应用程序或AI代理中。TypeScript，MIT，SDK中没有外部依赖。

在GitHub上查看立即安装

Voyspark工具包是什么？

一套3个开源包，将您的应用程序或AI代理连接到Voyspark平台——实时航班搜索、酒店、旅行者社区、旅行计划生成等。类型安全，MIT许可，SDK中没有外部依赖。

它是如何工作的

1. 选择一个接口

在TypeScript/JavaScript代码中使用的SDK。从终端运行的CLI。连接Claude Desktop、Cursor、Cline或任何AI代理的MCP服务器。

2. 发出请求

通过IATA代码搜索航班，通过城市搜索酒店，通过标签搜索社区帖子，从提示生成完整的旅行计划。类型化JSON响应。

3. 使用结果

每个响应都包括带有嵌入式附属跟踪的预订网址。您无需处理付款即可赚取佣金——佣金由提供商支付。

工具包的所有功能

通过3个接口完全访问Voyspark平台。

实时搜索

  • 按IATA搜索航班（Travelpayouts/Aviasales）
  • 按城市搜索酒店（Hotellook）
  • 租车（DiscoverCars）
  • 旅游和体验（GetYourGuide）
  • 火车、转机和旅行保险
  • 统一搜索（文章 + 目的地 + 用户 + 帖子 + 标签 + 社区）

旅行规划

  • 旅行计划模拟器：航班 + 酒店 + 行程组合
  • 估算总费用计算
  • AI生成的逐日行程
  • 目的地比较（气候、费用、安全）
  • 最佳旅行月份建议

社区与社交

  • 公共资料（@用户名）
  • 按标签搜索旅行者帖子
  • 7个主题社区（慢旅行、美食、家庭、单身女性、非明信片、里程黑客、可持续）
  • 真实旅行报告
  • 旅行基因组（品味档案）

编辑内容

  • 7种语言的期刊文章
  • 60多个策划的目的地指南
  • AMP网络故事
  • 免费工具（签证检查器、碳计算器、最佳月份等）

面向开发者

  • 类型安全的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速率限制
  • 每个预订网址的自动附属跟踪

真实世界的用例

Telegram/WhatsApp上的旅行机器人

一个Claude代理，接受"帮我找一趟7月去里斯本的航班"并返回带有附属预订网址的选项。您每完成一次预订就赚取佣金。

Cursor/IDE中的旅行插件

开发者询问"添加一个便宜的东京航班页面"，Cursor调用voyspark_search_flights，接收结构化数据并生成组件。

与Claude Desktop的礼宾服务

客户在Mac上与Claude聊天，Claude调用Voyspark工具并在几秒钟内构建完整的旅行计划，包括航班 + 酒店 + 行程。

Next.js上的旅行应用

将@voyspark/sdk导入您的Next.js应用，查询统一搜索、社区帖子和行程——全部类型安全。

三个包，一个代码库

相同的API。三个接口：代码、终端、AI代理。

@voyspark/sdk

公共API的TypeScript客户端。在Node 20+、Deno、Bun和现代浏览器中工作。类型安全，无依赖。

npm install @voyspark/sdk

@voyspark/cli

voyspark终端二进制文件。从您的shell中搜索航班、酒店、社区并生成旅行计划。

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

@voyspark/mcp

Claude Desktop、Cursor、Cline、Zed和任何模型上下文协议客户端的MCP服务器。4个工具，2个资源。

npx @voyspark/mcp

快速入门

SDK（代码）

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

const client = new VoysparkClient({ locale: 'zh-Hans' });

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": "zh-Hans" }
    }
  }
}

通过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

AI可发现性

AI代理自动发现Voyspark。

llms.txt

llms-full.txt

openapi.json

ai-plugin.json

定价

免费

$0

IP速率限制，10个请求/分钟。附属跟踪的预订网址。

专业版

即将推出

API密钥，100个请求/分钟，优先支持，网络钩子。

准备好构建了吗？

一次npm安装，您就可以在应用中获得航班、酒店和Voyspark社区。

在GitHub上查看立即安装

社区与支持

问题和讨论联系团队
Minha viagem
Voyspark AI