개발자를 위한
Voyspark로 개발하세요.
SDK, CLI, MCP 서버.
항공권, 호텔, 커뮤니티, 여행 계획을 어떤 애플리케이션이나 AI 에이전트에도 통합할 수 있는 오픈소스 툴킷. TypeScript, MIT, SDK는 외부 의존성 제로.
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개 테마 커뮤니티 (슬로우 트래블, 미식가, 가족, 여성 나 홀로 여행, 엽서 밖 여행, 마일리지 해킹, 지속가능 여행)
- 생생한 여행 후기
- 트래블 지놈 (취향 프로필)
에디토리얼 콘텐츠
- 9개 언어 저널 아티클
- 엄선된 60개 이상의 여행지 가이드
- AMP 웹 스토리
- 무료 도구 (Visa Checker, Carbon Calc, Best Month 등)
개발자를 위한
- 타입 안전 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월 상파울루-리스본 항공권 찾아줘"라는 요청을 받아 제휴 예약 URL과 함께 옵션을 돌려주는 Claude 에이전트. 예약이 완료될 때마다 수익을 얻습니다.
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 터미널 바이너리. 셸에서 항공권, 호텔, 커뮤니티를 검색하고 여행 플랜을 생성하세요.
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: 'ko' });
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 2MCP (Claude/Cursor)
// ~/Library/Application Support/Claude/claude_desktop_config.json
{
"mcpServers": {
"voyspark": {
"command": "npx",
"args": ["-y", "@voyspark/mcp"],
"env": { "VOYSPARK_LOCALE": "ko" }
}
}
}MCP로 제공되는 도구
voyspark_search
사용자, 게시물, 해시태그, 커뮤니티, 아티클, 여행지를 아우르는 통합 검색.
voyspark_search_flights
제휴 추적 예약 URL이 포함된 Travelpayouts(Aviasales) 항공권 상품.
voyspark_search_hotels
제휴 추적 예약 URL이 포함된 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 |
AI 검색 가능성
AI 에이전트가 Voyspark를 자동으로 발견합니다.
요금제
무료
$0
IP 속도 제한, 분당 10회. 제휴 추적 예약 URL 포함.
Pro
출시 예정
API 키, 분당 100회, 우선 지원, 웹훅.
개발을 시작할 준비가 되셨나요?
npm install 한 번으로 항공권, 호텔, Voyspark 커뮤니티를 앱에 담으세요.