ClawKit Logo
ClawKitReliability Toolkit
Back to Registry
Official Verified utilities Safety 4/5

flight-search

Search one-way flight lists from the Variflight ticket API by departure IATA city code, arrival IATA city code, and departure date.

skill-install — Terminal

Install via CLI (Recommended)

clawhub install openclaw/skills/skills/arisefx/variflight-flight-search
Or

What This Skill Does

The flight-search skill enables OpenClaw AI agents to query the Variflight ticket API for real-time one-way flight information. By leveraging a dedicated internal script, the agent can retrieve comprehensive flight data based on IATA city codes and specific calendar dates. This skill handles the complexity of API interaction, automatically parsing JSON responses to present a human-readable summary that includes departure/arrival airports, scheduled flight times, total duration, pricing, and transfer status. It acts as an automated flight clerk, allowing users to obtain travel options without navigating manual booking interfaces.

Installation

To integrate this skill into your OpenClaw environment, execute the following command in your terminal:

clawhub install openclaw/skills/skills/arisefx/variflight-flight-search

Once installed, the agent will have access to the scripts/query_flights.py utility, which manages the authenticated communication with the Variflight backend.

Use Cases

This skill is ideal for travel planning and itinerary management. Common use cases include:

  • Comparing multiple flight options between major cities for business travel.
  • Quickly checking if direct flights are available for a specific date.
  • Identifying budget-friendly travel alternatives by summarizing pricing and transfer details.
  • Rapidly retrieving travel data for large-scale itinerary organization.

Example Prompts

  1. "Find me one-way flights from Beijing to Shanghai for April 21, 2026."
  2. "Search for the 5 cheapest flights from LAX to JFK on December 15th, 2026."
  3. "Are there any direct flights from NRT to HND on June 10, 2026? Give me the details in raw JSON format."

Tips & Limitations

  • IATA Codes: Always use three-letter IATA codes (e.g., BJS, SHA, JFK) for the best results. The agent can infer some common names, but explicit codes prevent errors.
  • Date Format: Ensure all dates are formatted strictly as YYYY-MM-DD to match API requirements.
  • Error Handling: If the API returns a status code other than 0, the agent will relay the specific error message provided by the service to help you troubleshoot.
  • Limitations: This skill is restricted to one-way searches and supports up to 10 flight entries per query, though you can use the --limit flag to further filter results for better readability. It does not handle multi-city or round-trip bookings in a single request.

Metadata

Author@arisefx
Stars4473
Views0
Updated2026-05-01
View Author Profile
AI Skill Finder

Not sure this is the right skill?

Describe what you want to build — we'll match you to the best skill from 16,000+ options.

Find the right skill
Add to Configuration

Paste this into your clawhub.json to enable this plugin.

{
  "plugins": {
    "official-arisefx-variflight-flight-search": {
      "enabled": true,
      "auto_update": true
    }
  }
}

Tags(AI)

#travel#aviation#flights#api#logistics
Safety Score: 4/5

Flags: external-api, code-execution