mcpField
T
travel-planner

travel-planner

github.com/barneyjm生産性041 回インストール24 週間前に更新
リポジトリ

travel-planner について

Camino AIの位置情報インテリジェンススイートに含まれる、日帰り旅行や徒歩ツアーなどを計画するエージェント向けスキルです。journeyエンドポイントを利用し、移動手段や時間の制約を踏まえて実現可能性を確認します。

主な機能

  1. 01複数地点の旅程を計画
  2. 02徒歩、車、自転車に対応
  3. 03所要時間の上限を設定
  4. 04旅程の実現可能性を確認
  5. 05区間別ルートと総所要時間を返却

活用シーン

  1. 01市内の徒歩ツアーを計画
  2. 02複数地点を巡る自転車や車の旅を手配
  3. 03時間の上限に沿って日程を確認
  4. 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"

パラメーター

フィールド型必須デフォルト説明
waypointsarrayはい-lat、lon、目的を含む立ち寄り先のリスト(最小2件)
constraintsobjectいいえ-旅行の制約
constraints.transportstringいいえ"walking"移動手段:「walking」、「car」、「bike」
constraints.time_budgetstringいいえ-時間制限(例:「4 hours」、「90 minutes」)
constraints.preferencesarrayいいえ[]ルートの希望
Waypoint オブジェクト
フィールド型必須説明
latfloatはい立ち寄り先の緯度
lonfloatはい立ち寄り先の経度
purposestringいいえ立ち寄り先の説明(例:「エッフェル塔」、「昼食休憩」)

レスポンス形式

{
  "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 周辺の地域について詳しく調べてください
  • 長期の旅行では、旅程を管理しやすい日ごとの区間に分けてください

コメント