{"skill":{"slug":"moltflights","displayName":"MoltFlights","summary":"Search cheap flights via the MoltFlights API. Find deals, compare prices, track routes, and set up price alerts.","description":"---\nname: moltflights\ndescription: Search cheap flights via the MoltFlights API. Find deals, compare prices, track routes, and set up price alerts.\nhomepage: https://moltflights.com\nmetadata:\n  openclaw:\n    emoji: \"✈️\"\n    keywords: [travel, flights, cheap-flights, search, booking, price-alerts, digital-nomad]\ntools:\n  moltflights_search:\n    description: Search for flights between two airports. Returns real-time prices with direct booking links.\n    url: https://moltflights.com/api/search\n    method: GET\n    parameters:\n      type: object\n      properties:\n        origin:\n          type: string\n          description: \"IATA airport code for departure (e.g. HEL, JFK, LHR)\"\n        destination:\n          type: string\n          description: \"IATA airport code for arrival (e.g. BKK, NRT, BCN)\"\n        date:\n          type: string\n          description: \"Departure date YYYY-MM-DD. Omit for cheapest flights across the month.\"\n        returnDate:\n          type: string\n          description: \"Return date YYYY-MM-DD for round-trips. Omit for one-way.\"\n        adults:\n          type: integer\n          description: \"Number of adults 1-9 (default: 1)\"\n        children:\n          type: integer\n          description: \"Number of children ages 2-12, 0-8 (default: 0)\"\n        infants:\n          type: integer\n          description: \"Number of infants under 2, 0-8 (default: 0)\"\n      required: [origin, destination]\n  moltflights_autocomplete:\n    description: Look up IATA airport codes by city or airport name.\n    url: https://moltflights.com/api/autocomplete\n    method: GET\n    parameters:\n      type: object\n      properties:\n        term:\n          type: string\n          description: \"City or airport name to search (min 2 characters)\"\n      required: [term]\n---\n\n# MoltFlights — Flight Search Skill\n\nSearch cheap flights using the [MoltFlights API](https://moltflights.com/agents). Returns structured JSON with real-time prices and direct booking links.\n\nNo API key required. No authentication. Just call the endpoint.\n\n---\n\n## Tools\n\n### `moltflights_search` — Search Flights\n\n```\nGET https://moltflights.com/api/search?origin=HEL&destination=BKK&date=2026-03-15\n```\n\n| Parameter     | Required | Type    | Description                          |\n|---------------|----------|---------|--------------------------------------|\n| `origin`      | yes      | string  | IATA airport code (e.g. `HEL`)      |\n| `destination` | yes      | string  | IATA airport code (e.g. `NRT`)      |\n| `date`        | no       | string  | Departure date `YYYY-MM-DD`          |\n| `returnDate`  | no       | string  | Return date `YYYY-MM-DD` (round-trip)|\n| `adults`      | no       | integer | Number of adults, 1–9 (default: 1)   |\n| `children`    | no       | integer | Children ages 2–12, 0–8 (default: 0) |\n| `infants`     | no       | integer | Infants under 2, 0–8 (default: 0)    |\n\nIf `date` is omitted, the API returns the cheapest flights for the upcoming month.\n\n### `moltflights_autocomplete` — Look Up Airport Codes\n\n```\nGET https://moltflights.com/api/autocomplete?term=bangkok\n```\n\n| Parameter | Required | Type   | Description                              |\n|-----------|----------|--------|------------------------------------------|\n| `term`    | yes      | string | City or airport name (min 2 characters)  |\n\n---\n\n## Example: Search Flights\n\n```bash\ncurl \"https://moltflights.com/api/search?origin=HEL&destination=BKK&date=2026-03-15\"\n```\n\n### Response\n\n```json\n{\n  \"meta\": {\n    \"source\": \"MoltFlights\",\n    \"origin\": \"HEL\",\n    \"destination\": \"BKK\",\n    \"date\": \"2026-03-15\",\n    \"adults\": 1,\n    \"children\": 0,\n    \"infants\": 0,\n    \"results\": 12\n  },\n  \"data\": [\n    {\n      \"airline\": \"Finnair\",\n      \"flight_number\": \"809\",\n      \"price\": \"€432\",\n      \"price_per_person\": \"€432\",\n      \"departure\": \"2026-03-15T10:30:00\",\n      \"return_at\": \"\",\n      \"transfers\": 1,\n      \"origin\": \"HEL\",\n      \"destination\": \"BKK\",\n      \"book_link\": \"https://www.aviasales.com/search/...\"\n    }\n  ]\n}\n```\n\nEach result includes a `book_link` — a direct booking URL the user can open.\n\n---\n\n## Example: Round-Trip with Passengers\n\n```bash\ncurl \"https://moltflights.com/api/search?origin=JFK&destination=CDG&date=2026-06-01&returnDate=2026-06-15&adults=2&children=1\"\n```\n\nThe `price` field shows the **total** for all seat-occupying passengers. `price_per_person` shows the per-person price.\n\n---\n\n## Common Use Cases\n\n### 1. Find the cheapest flight to a destination\n\nSearch without a specific date to get the cheapest options for the whole month:\n\n```bash\ncurl \"https://moltflights.com/api/search?origin=LHR&destination=TYO\"\n```\n\n### 2. Compare prices across dates\n\nRun multiple searches for different dates and compare:\n\n```bash\nfor date in 2026-04-01 2026-04-08 2026-04-15; do\n  echo \"=== $date ===\"\n  curl -s \"https://moltflights.com/api/search?origin=HEL&destination=BKK&date=$date\" | head -20\ndone\n```\n\n### 3. Price monitoring / alerts (cron job)\n\nCheck a route daily and alert when price drops below a threshold:\n\n```bash\n# Run daily via cron: 0 8 * * * /path/to/check-price.sh\nPRICE=$(curl -s \"https://moltflights.com/api/search?origin=HEL&destination=BKK&date=2026-05-01\" \\\n  | grep -o '\"price\":\"€[0-9]*\"' | head -1 | grep -o '[0-9]*')\n\nif [ \"$PRICE\" -lt 400 ]; then\n  echo \"Deal found: HEL→BKK for €$PRICE\"\nfi\n```\n\n### 4. Multi-city search\n\nSearch several routes and pick the cheapest:\n\n```bash\nfor dest in BKK TYO BCN LIS; do\n  echo \"=== HEL → $dest ===\"\n  curl -s \"https://moltflights.com/api/search?origin=HEL&destination=$dest\" \\\n    | grep -o '\"price\":\"€[0-9]*\"' | head -1\ndone\n```\n\n---\n\n## Common IATA Codes\n\n| Code | City            | Code | City          |\n|------|-----------------|------|---------------|\n| HEL  | Helsinki        | LHR  | London        |\n| JFK  | New York        | CDG  | Paris         |\n| NRT  | Tokyo Narita    | BKK  | Bangkok       |\n| BCN  | Barcelona       | FCO  | Rome          |\n| SIN  | Singapore       | DXB  | Dubai         |\n| LAX  | Los Angeles     | SFO  | San Francisco |\n| BER  | Berlin          | AMS  | Amsterdam     |\n| IST  | Istanbul        | LIS  | Lisbon        |\n\nDon't know the code? Use the `moltflights_autocomplete` tool:\n\n```bash\ncurl \"https://moltflights.com/api/autocomplete?term=bangkok\"\n```\n\n---\n\n## Error Handling\n\n- **400** — Missing `origin` or `destination` parameter\n- **Empty `data` array** — No flights found for this route/date. Try a different date or omit the date for flexible search.\n\n---\n\n## Tips\n\n- Prices are in EUR (€)\n- Results are sorted: exact date matches first, then nearby dates by price\n- Omitting `date` gives you the cheapest flights across the whole upcoming month\n- The API is free and requires no authentication\n- Responses are cached for 5 minutes\n","tags":{"flights":"1.0.1","latest":"1.0.1","search":"1.0.1","travel":"1.0.1"},"stats":{"comments":0,"downloads":1560,"installsAllTime":3,"installsCurrent":2,"stars":0,"versions":2},"createdAt":1770593327036,"updatedAt":1778486086401},"latestVersion":{"version":"1.0.1","createdAt":1770594854600,"changelog":"- Added explicit OpenClaw metadata, including emoji and discoverability keywords.\n- Defined two structured tools: flight search and IATA airport autocomplete, with descriptions and parameter details.\n- Documented each tool in the README for easier reference and integration.\n- Updated mentions of the autocomplete endpoint to reference the new `moltflights_autocomplete` tool. \n- No changes to skill logic or API usage.","license":null},"metadata":{"setup":[],"os":null,"systems":null},"owner":{"handle":"jhalmari","userId":"s1766ya33h8xy23ynabstten2h8842cr","displayName":"Jhalmari","image":"https://avatars.githubusercontent.com/u/101633511?v=4"},"moderation":null}