flights

What This Skill Does

The flights skill provides a powerful command-line interface for searching real-time flight schedules and pricing using Google Flights data. It acts as an automated agent bridge, allowing you to bypass the manual process of querying airline websites. The skill intelligently handles both specific IATA airport codes (e.g., JFK, LHR) and broad metropolitan city names (e.g., NYC, Tokyo). When a city name is provided, the tool automatically executes a multi-airport search, aggregating data from all relevant terminals in that metro region. It requires no API keys, utilizing the fast-flights library to parse flight data directly.

Installation

To integrate this skill, use the ClawHub installation command: clawhub install openclaw/skills/skills/brennerspear/flights-search. Ensure your environment has Python 3.9+ installed. The tool leverages uv for dependency management, ensuring a fast and isolated execution environment. Upon the first execution, the fast-flights dependency is automatically handled, though it can be manually installed via pip install fast-flights if preferred. The CLI script resides at scripts/flights-search within your local skill directory.

Use Cases

This skill is perfect for developers building travel-related AI agents, frequent travelers needing to automate price comparison, or administrative assistants scheduling group trips. You can use it to filter flights by specific time windows—useful for early arrivals or avoiding late-night flights—or to switch between travel classes (economy, premium, business, or first). It is particularly useful for agents that need to provide direct booking URLs to users, significantly reducing the friction in the travel planning workflow.

Example Prompts

1. "Find me the cheapest business class flights from London to Tokyo for April 1st, 2026, and provide the booking links."
2. "Search for nonstop flights departing from NYC to Berlin on March 15th, 2026. Only show me flights that depart after 5 PM."
3. "I need a flight for 2 passengers from San Francisco to Tokyo on April 1st. Show me all available options, including those with stops."

Tips & Limitations

The tool defaults to showing the minimum number of stops available; if you are looking for more flight options, always use the --all-stops flag. Be aware that while the tool supports over 60 global metro areas, specific regional airports not covered by the metro definitions require manual IATA code entry. The tool is designed for search and retrieval; it does not handle ticketing or payment processing. Ensure your system time is correctly synced to get accurate real-time data from the provider.