travel-planner について
Camino AIの位置情報インテリジェンススイートに含まれる、日帰り旅行や徒歩ツアーなどを計画するエージェント向けスキルです。journeyエンドポイントを利用し、移動手段や時間の制約を踏まえて実現可能性を確認します。
主な機能
- 01複数地点の旅程を計画
- 02徒歩、車、自転車に対応
- 03所要時間の上限を設定
- 04旅程の実現可能性を確認
- 05区間別ルートと総所要時間を返却
活用シーン
- 01市内の徒歩ツアーを計画
- 02複数地点を巡る自転車や車の旅を手配
- 03時間の上限に沿って日程を確認
- 04会議や食事を含む複数地点の行程を計画
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ barneyjm/ camino-skills --skill travel-plannerインストール後、Claude Code で/travel-plannerを入力して読み込まれたか確認します。
同梱ファイルscripts/travel-planner.sh
詳細
インストール
関連スキル:これは Camino AI のロケーションインテリジェンススイートの一部です。包括的に利用するには、利用可能なすべてのスキル(query、places、relationship、context、route、journey、real-estate、hotel-finder、ev-charger、school-finder、parking-finder、fitness-finder、safety-checker、travel-planner)をインストールしてください。
# Install all skills from repo
npx skills add https://github.com/barneyjm/camino-skills
# Or install specific skills
npx skills add https://github.com/barneyjm/camino-skills --skill travel-planner
clawhub 経由:
npx clawhub@latest install travel-planner
# or: pnpm dlx clawhub@latest install travel-planner
# or: bunx clawhub@latest install travel-planner
Travel Planner
時間の予算を考慮して、丸一日の日帰り旅行、徒歩ツアー、複数の立ち寄り先を含む旅程を計画します。旅行計画向けに、Camino AI の journey エンドポイントを独自のデフォルト設定でラップしています。
セットアップ
これらのスキルは curl を実行し、CAMINO_API_KEY 環境変数を使って認証します。https://app.getcamino.ai/skills/activate で登録すると、毎月100回まで無料で呼び出せる API キーを取得できます。
Claude Code にキーを追加する:
~/.claude/settings.json に追加します。
{
"env": {
"CAMINO_API_KEY": "your-api-key-here"
}
}
Claude Code を再起動します。
代替手段 — x402 によるリクエストごとの支払い: Camino の有料エンドポイントは、登録や API キーなしで、x402 に対応した任意のクライアントから Base 上の USDC による HTTP 402 支払い(1リクエストあたり $0.001)も受け付けます。これらのスキルではこの方法は使用しません。x402 にネイティブ対応したエージェントやクライアント向けです。
使用方法
シェルスクリプト経由
# Plan a walking tour in Paris
./scripts/travel-planner.sh '{
"waypoints": [
{"lat": 48.8584, "lon": 2.2945, "purpose": "Eiffel Tower"},
{"lat": 48.8606, "lon": 2.3376, "purpose": "Louvre Museum"}
],
"constraints": {"transport": "foot", "time_budget": "4 hours"}
}'
# Plan a driving day trip
./scripts/travel-planner.sh '{
"waypoints": [
{"lat": 34.0195, "lon": -118.4912, "purpose": "Santa Monica Pier"},
{"lat": 34.0259, "lon": -118.7798, "purpose": "Malibu Beach"},
{"lat": 34.0922, "lon": -118.3287, "purpose": "Hollywood Sign viewpoint"}
],
"constraints": {"transport": "car", "time_budget": "6 hours"}
}'
# Simple two-stop trip
./scripts/travel-planner.sh '{
"waypoints": [
{"lat": 40.7484, "lon": -73.9857, "purpose": "Empire State Building"},
{"lat": 40.7614, "lon": -73.9776, "purpose": "MoMA"}
]
}'
curl 経由
curl -X POST -H "X-API-Key: $CAMINO_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"waypoints": [
{"lat": 48.8584, "lon": 2.2945, "purpose": "Eiffel Tower"},
{"lat": 48.8606, "lon": 2.3376, "purpose": "Louvre"}
],
"constraints": {"transport": "foot", "time_budget": "4 hours"}
}' \
"https://api.getcamino.ai/journey"
パラメーター
| フィールド | 型 | 必須 | デフォルト | 説明 |
|---|---|---|---|---|
| waypoints | array | はい | - | lat、lon、目的を含む立ち寄り先のリスト(最小2件) |
| constraints | object | いいえ | - | 旅行の制約 |
| constraints.transport | string | いいえ | "walking" | 移動手段:「walking」、「car」、「bike」 |
| constraints.time_budget | string | いいえ | - | 時間制限(例:「4 hours」、「90 minutes」) |
| constraints.preferences | array | いいえ | [] | ルートの希望 |
Waypoint オブジェクト
| フィールド | 型 | 必須 | 説明 |
|---|---|---|---|
| lat | float | はい | 立ち寄り先の緯度 |
| lon | float | はい | 立ち寄り先の経度 |
| purpose | string | いいえ | 立ち寄り先の説明(例:「エッフェル塔」、「昼食休憩」) |
レスポンス形式
{
"feasible": true,
"total_distance_km": 6.8,
"total_time_minutes": 85,
"total_time_formatted": "1 hour 25 minutes",
"transport_mode": "foot",
"route_segments": [
{
"from": "Eiffel Tower",
"to": "Louvre Museum",
"distance_km": 3.4,
"duration_minutes": 42
},
{
"from": "Louvre Museum",
"to": "Notre-Dame",
"distance_km": 3.4,
"duration_minutes": 43
}
],
"analysis": {
"summary": "This walking tour is feasible within your 4-hour time budget...",
"optimization_opportunities": ["Consider starting at the Louvre to reduce backtracking"]
}
}
例
パリの徒歩ツアー
./scripts/travel-planner.sh '{
"waypoints": [
{"lat": 48.8584, "lon": 2.2945, "purpose": "Eiffel Tower"},
{"lat": 48.8606, "lon": 2.3376, "purpose": "Louvre Museum"},
{"lat": 48.8530, "lon": 2.3499, "purpose": "Notre-Dame Cathedral"},
{"lat": 48.8867, "lon": 2.3431, "purpose": "Sacre-Coeur"}
],
"constraints": {
"transport": "foot",
"time_budget": "6 hours"
}
}'
ニューヨークのサイクリングツアー
./scripts/travel-planner.sh '{
"waypoints": [
{"lat": 40.7128, "lon": -74.0060, "purpose": "Start at Battery Park"},
{"lat": 40.6892, "lon": -74.0445, "purpose": "Statue of Liberty viewpoint"},
{"lat": 40.7061, "lon": -73.9969, "purpose": "Brooklyn Bridge"},
{"lat": 40.7580, "lon": -73.9855, "purpose": "Times Square"}
],
"constraints": {
"transport": "bike",
"time_budget": "3 hours"
}
}'
ビジネスミーティング巡回ルート
./scripts/travel-planner.sh '{
"waypoints": [
{"lat": 37.7749, "lon": -122.4194, "purpose": "Office downtown"},
{"lat": 37.7849, "lon": -122.4094, "purpose": "Client meeting"},
{"lat": 37.7900, "lon": -122.4000, "purpose": "Lunch"},
{"lat": 37.7749, "lon": -122.4194, "purpose": "Return to office"}
],
"constraints": {
"transport": "car",
"time_budget": "2 hours"
}
}'
ベストプラクティス
- より詳細なルート分析を得るため、各 waypoint に必ず
purposeを指定してください - 実現可能性の確認と最適化の提案を得るため、
time_budgetを設定してください - 市内の徒歩ツアーには「foot」、サイクリングツアーには「bike」、車での旅行には「car」を指定してください
- 希望する訪問順に waypoint を並べてください。API が実現可能性を確認します
queryスキルと組み合わせて、waypoint に追加する見どころを探してくださいhotel-finderスキルと組み合わせて、最初または最後の waypoint の近くにある宿泊施設を探してくださいcontextスキルと組み合わせて、各 waypoint 周辺の地域について詳しく調べてください- 長期の旅行では、旅程を管理しやすい日ごとの区間に分けてください