AI Travel Planner Agent Skill — Generate Trip Itineraries via API

This skill enables AI agents to generate complete, day-by-day travel itineraries using the AI Pass API.

Setup

1. Create an AI Pass account: aipass.one — $1 free credit on signup
2. Get your API key: Developer Dashboard → API Keys
3. Set environment variable: export AIPASS_API_KEY="your-key-here"

Python Implementation

import os, requests

AIPASS_API_KEY = os.environ["AIPASS_API_KEY"]

def plan_trip(
    destination: str,
    duration: str = "7 days",
    style: str = "cultural & historical",
    budget: str = "mid-range",
    notes: str = ""
) -> str:
    """
    Generate a complete travel itinerary.
    
    Args:
        destination: City/country to visit
        duration: Trip length (e.g., "5 days", "2 weeks")
        style: cultural|food|adventure|relaxation|family|budget|luxury
        budget: budget|mid-range|luxury
        notes: Special requests or preferences
    
    Returns:
        Full itinerary as formatted text
    """
    notes_line = f"\nSpecial requests: {notes}" if notes else ""
    
    prompt = f"""Create a complete {duration} travel itinerary for {destination}.
Travel style: {style}
Budget: {budget}{notes_line}

Include:
1. Day-by-day schedule (morning/afternoon/evening)
2. Top 3 must-see highlights
3. Hidden local gems
4. Best neighborhoods to stay in
5. Food recommendations
6. Transportation tips
7. Practical tips & budget breakdown"""

    response = requests.post(
        "https://aipass.one/apikey/v1/chat/completions",
        headers={
            "Authorization": f"Bearer {AIPASS_API_KEY}",
            "Content-Type": "application/json"
        },
        json={
            "model": "gpt-5-mini",
            "temperature": 1,
            "max_tokens": 4000,
            "messages": [
                {
                    "role": "system",
                    "content": "You are an expert travel planner with deep knowledge of destinations worldwide."
                },
                {"role": "user", "content": prompt}
            ]
        },
        timeout=60
    )
    
    return response.json()["choices"][0]["message"]["content"]


# Example
if __name__ == "__main__":
    itinerary = plan_trip(
        destination="Porto, Portugal",
        duration="5 days",
        style="food & culture",
        budget="mid-range",
        notes="First time, love wine and local markets"
    )
    print(itinerary)

curl Example

curl -s -X POST https://aipass.one/apikey/v1/chat/completions \
  -H "Authorization: Bearer $AIPASS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5-mini",
    "temperature": 1,
    "max_tokens": 4000,
    "messages": [
      {"role": "system", "content": "You are an expert travel planner."},
      {"role": "user", "content": "Plan a 5-day trip to Lisbon, Portugal. Mid-range budget. Focus on food and culture."}
    ]
  }' | python3 -c "import json,sys; print(json.load(sys.stdin)['choices'][0]['message']['content'])"

Related Resources

• Live App: AI Travel Planner
• Build Your Own Travel Planner App
• Developer Dashboard