Sorted Travel Docs

sorted-travel

Sorted Travel REST API 用の公式 Python、JavaScript、Go、Ruby SDK および CLI です。

このリポジトリでは、以下を公開しています。

• Python：PyPI の sorted-travel（pip install sorted-travel）
• JavaScript：npm の sorted-travel（npm install sorted-travel、ソースは js/）
• Go：github.com/a-l-e-x-k/sorted-travel-sdk/go（go get github.com/a-l-e-x-k/sorted-travel-sdk/go、ソースは go/）
• Ruby：RubyGems の sorted-travel（gem install sorted-travel、ソースは ruby/）
• skills.sh のエージェントスキル：sorted-travel、sorted-travel-destinations、sorted-travel-weather、sorted-travel-visa
• エージェントプラグイン：plugin.json、skills/、mcp.json（Agent Plugins v1）

これは標準ライブラリのみを使用する Python クライアントと、依存関係のない JavaScript クライアントで、https://sorted.travel の公開エンドポイントに対応しています。目的地のランキング、情報、天気、ビザのツールは、認証不要で利用できる無料プランです。API キーは任意です。

• ホームページ：https://sorted.travel
• 開発者ポータル：https://sorted.travel/developers
• SDK ガイド：https://sorted.travel/sdks.md
• OpenAPI：https://sorted.travel/openapi.json
• MCP：https://sorted.travel/mcp
• Docs MCP：https://sorted.travel/docs/mcp
• Smithery：sorted-travel/destinations
• PyPI：https://pypi.org/project/sorted-travel/
• npm：https://www.npmjs.com/package/sorted-travel/
• Go モジュール：https://pkg.go.dev/github.com/a-l-e-x-k/sorted-travel-sdk/go
• RubyGems：https://rubygems.org/gems/sorted-travel

エージェントスキル（skills.sh）

Cursor、Claude Code、Codex、その他の対応エージェント向けに Sorted Travel のエージェントスキルをインストールします。

npx skills add a-l-e-x-k/sorted-travel-sdk

Cursor 用の非対話型インストール：

npx skills add a-l-e-x-k/sorted-travel-sdk -y -a cursor

機能領域を 1 つインストールする場合：

npx skills add a-l-e-x-k/sorted-travel-sdk --skill sorted-travel-weather

スキル	使用する場面
sorted-travel	行き先を決める／おすすめのランキング
sorted-travel-destinations	特定の目的地に関する情報
sorted-travel-weather	予報、気候、旅行に適した月
sorted-travel-visa	パスポートのビザ手続きの煩雑さ

エージェントが Sorted Travel をいつ使うべきか、製品 MCP の https://sorted.travel/mcp とドキュメント MCP の https://sorted.travel/docs/mcp に接続する方法、呼び出すツールを説明します。グループ分けについては、skills.sh.json を参照してください。

mcp.json または Smithery を使って、MCP に直接接続できます。

npx -y smithery mcp add sorted-travel/destinations

SDK のインストール

Python：

pip install sorted-travel

JavaScript：

npm install sorted-travel

Go：

go get github.com/a-l-e-x-k/sorted-travel-sdk/[email protected]

Ruby：

gem install sorted-travel

クイックスタート（Python）

from sorted_travel import Client

client = Client()
print(client.status())
page = client.list_destinations(limit=20)
print(page["data"][0]["handle"], page["has_more"])

目的地ツールにキーは不要です。ホスト側で引き続きキーが必要な場合：

client = Client(api_key="st_sandbox_...")  # or set SORTED_TRAVEL_API_KEY

セルフサービスのサンドボックスキー：

payload = client.create_api_key()

クイックスタート（JavaScript）

import { Client } from "sorted-travel"

const client = new Client()
await client.status()
await client.listDestinations({ limit: 20 })

クイックスタート（Go）

import (
	"context"

	"github.com/a-l-e-x-k/sorted-travel-sdk/go/sortedtravel"
)

client := sortedtravel.NewClient()
client.Status(context.Background())
limit := 20
client.ListDestinations(context.Background(), nil, &limit)

クイックスタート（Ruby）

require "sorted_travel"

client = SortedTravel::Client.new
client.status
client.list_destinations(limit: 20)

CLI

sorted-travel status
sorted-travel destinations --limit 5
sorted-travel sandbox
sorted-travel api-key

npm 経由の JavaScript CLI：

npx sorted-travel status

Go CLI：

go run ./go/cmd/sorted-travel status

Ruby CLI：

sorted-travel status

設定

コンストラクター引数	環境変数	デフォルト
api_key	SORTED_TRAVEL_API_KEY	—
base_url	SORTED_TRAVEL_BASE_URL	https://sorted.travel
timeout	—	30.0 秒

提供機能

• status() — GET /api/v1/status
• list_destinations(cursor=, limit=) — GET /api/v1/destinations
• create_api_key() — POST /api/v1/api-keys
• sandbox() — GET /sandbox
• create_job(operation, **body) — POST /api/v1/jobs
• get_job(job_id) — GET /api/v1/jobs/{job_id}
• get(path, params=) / post(path, body=) — REST を直接呼び出すための手段

インタラクティブなランキング、天気、ビザの機能は、引き続き https://sorted.travel/mcp の MCP を経由します。これらの SDK パッケージは JSON-RPC をラップしません。

ライセンス

MIT。Sorted Travel 製品には、https://sorted.travel/terms に記載された独自の利用規約が適用されます。