{
  "schemaVersion": "1.0",
  "item": {
    "slug": "flights-search",
    "name": "Flights",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/BrennerSpear/flights-search",
    "canonicalUrl": "https://clawhub.ai/BrennerSpear/flights-search",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/flights-search",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=flights-search",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "SKILL.md"
    ],
    "primaryDoc": "SKILL.md",
    "quickSetup": [
      "Download the package from Yavira.",
      "Extract the archive and review SKILL.md first.",
      "Import or place the package into your OpenClaw setup."
    ],
    "agentAssist": {
      "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
      "steps": [
        "Download the package from Yavira.",
        "Extract it into a folder your agent can access.",
        "Paste one of the prompts below and point your agent at the extracted folder."
      ],
      "prompts": [
        {
          "label": "New install",
          "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete."
        },
        {
          "label": "Upgrade existing",
          "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run."
        }
      ]
    },
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-30T16:55:25.780Z",
      "expiresAt": "2026-05-07T16:55:25.780Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
        "contentDisposition": "attachment; filename=\"network-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null
      },
      "scope": "source",
      "summary": "Source download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this source.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/flights-search"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    },
    "downloadPageUrl": "https://openagent3.xyz/downloads/flights-search",
    "agentPageUrl": "https://openagent3.xyz/skills/flights-search/agent",
    "manifestUrl": "https://openagent3.xyz/skills/flights-search/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/flights-search/agent.md"
  },
  "agentAssist": {
    "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
    "steps": [
      "Download the package from Yavira.",
      "Extract it into a folder your agent can access.",
      "Paste one of the prompts below and point your agent at the extracted folder."
    ],
    "prompts": [
      {
        "label": "New install",
        "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete."
      },
      {
        "label": "Upgrade existing",
        "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run."
      }
    ]
  },
  "documentation": {
    "source": "clawhub",
    "primaryDoc": "SKILL.md",
    "sections": [
      {
        "title": "Flight Search",
        "body": "Search real-time flight schedules and prices via Google Flights data."
      },
      {
        "title": "Prerequisites",
        "body": "Python 3.9+\nuv (recommended) — install with curl -LsSf https://astral.sh/uv/install.sh | sh\n\nThe flights-search CLI is bundled at scripts/flights-search in this skill directory.\n\nThe fast-flights library is installed automatically on first run via uvx (cached after that). Or install manually: pip install fast-flights"
      },
      {
        "title": "CLI Usage",
        "body": "uvx --with fast-flights python3 scripts/flights-search <origin> <destination> <date> [options]\n\nOrigin and destination accept IATA codes (JFK, LAX) or city names (NYC, London, Tokyo). City names automatically search all airports in that metro area."
      },
      {
        "title": "Examples",
        "body": "# Search all NYC airports to LAX\nflights-search NYC LAX 2026-03-15\n\n# Nonstop flights from NYC to Berlin\nflights-search NYC Berlin 2026-03-15 --nonstop\n\n# Evening departures only\nflights-search JFK LHR 2026-03-15 --after 17 --before 22\n\n# Business class\nflights-search NYC London 2026-03-15 --class business\n\n# Multiple passengers with booking link\nflights-search SF Tokyo 2026-04-01 --passengers 2 --link"
      },
      {
        "title": "Options",
        "body": "OptionDescription--nonstopNonstop flights only--all-stopsShow all flights regardless of stops--after HHDepart after hour (24h format)--before HHDepart before hour (24h format)--classCabin: economy, premium, business, first--passengers NNumber of travelers (default: 1)--linkPrint Google Flights URL"
      },
      {
        "title": "Supported City Names",
        "body": "When you use a city name, the CLI searches all airports in that metro area:\n\nCityAirportsNYC / New YorkJFK, EWR, LGALA / Los AngelesLAX, BUR, LGB, ONT, SNASF / San FranciscoSFO, OAK, SJCChicagoORD, MDWDC / WashingtonDCA, IAD, BWILondonLHR, LGW, STN, LTN, LCYParisCDG, ORYTokyoNRT, HNDTorontoYYZ, YTZ\n\n60+ metro areas supported. Use any IATA code directly for airports not in the list."
      },
      {
        "title": "Default Behavior",
        "body": "By default, the CLI shows only flights with the minimum stops available:\n\nIf nonstops exist → shows only nonstops\nIf no nonstops → shows only 1-stop flights\nUse --all-stops to see everything"
      },
      {
        "title": "Output",
        "body": "Searching from NYC: JFK, EWR, LGA\n\nRoute        Depart                       Arrive                       Airline          Price       Duration\n------------------------------------------------------------------------------------------------------------\nEWR→LAX      6:00 AM on Sat, Mar 7        9:07 AM on Sat, Mar 7        United           $289        6 hr 7 min\nEWR→LAX      12:00 PM on Sat, Mar 7       3:14 PM on Sat, Mar 7        United           $289        6 hr 14 min\nJFK→LAX      8:00 AM on Sat, Mar 7        11:30 AM on Sat, Mar 7       Delta            $304        5 hr 30 min\n\n3 flight(s) found."
      },
      {
        "title": "Notes",
        "body": "Date format: YYYY-MM-DD\nAirport codes: Standard IATA codes (JFK, LAX, LHR, etc.)\nPrices are in USD\nTimes shown in local airport timezone\nNo API key required — uses Google Flights data via reverse-engineered protobuf API\nSome routes may return price-only results (missing departure/arrival times) due to upstream parsing limitations"
      },
      {
        "title": "Data Source",
        "body": "Uses Google Flights data via the fast-flights Python package."
      }
    ],
    "body": "Flight Search\n\nSearch real-time flight schedules and prices via Google Flights data.\n\nPrerequisites\nPython 3.9+\nuv (recommended) — install with curl -LsSf https://astral.sh/uv/install.sh | sh\n\nThe flights-search CLI is bundled at scripts/flights-search in this skill directory.\n\nThe fast-flights library is installed automatically on first run via uvx (cached after that). Or install manually: pip install fast-flights\n\nCLI Usage\nuvx --with fast-flights python3 scripts/flights-search <origin> <destination> <date> [options]\n\n\nOrigin and destination accept IATA codes (JFK, LAX) or city names (NYC, London, Tokyo). City names automatically search all airports in that metro area.\n\nExamples\n# Search all NYC airports to LAX\nflights-search NYC LAX 2026-03-15\n\n# Nonstop flights from NYC to Berlin\nflights-search NYC Berlin 2026-03-15 --nonstop\n\n# Evening departures only\nflights-search JFK LHR 2026-03-15 --after 17 --before 22\n\n# Business class\nflights-search NYC London 2026-03-15 --class business\n\n# Multiple passengers with booking link\nflights-search SF Tokyo 2026-04-01 --passengers 2 --link\n\nOptions\nOption\tDescription\n--nonstop\tNonstop flights only\n--all-stops\tShow all flights regardless of stops\n--after HH\tDepart after hour (24h format)\n--before HH\tDepart before hour (24h format)\n--class\tCabin: economy, premium, business, first\n--passengers N\tNumber of travelers (default: 1)\n--link\tPrint Google Flights URL\nSupported City Names\n\nWhen you use a city name, the CLI searches all airports in that metro area:\n\nCity\tAirports\nNYC / New York\tJFK, EWR, LGA\nLA / Los Angeles\tLAX, BUR, LGB, ONT, SNA\nSF / San Francisco\tSFO, OAK, SJC\nChicago\tORD, MDW\nDC / Washington\tDCA, IAD, BWI\nLondon\tLHR, LGW, STN, LTN, LCY\nParis\tCDG, ORY\nTokyo\tNRT, HND\nToronto\tYYZ, YTZ\n\n60+ metro areas supported. Use any IATA code directly for airports not in the list.\n\nDefault Behavior\n\nBy default, the CLI shows only flights with the minimum stops available:\n\nIf nonstops exist → shows only nonstops\nIf no nonstops → shows only 1-stop flights\nUse --all-stops to see everything\nOutput\nSearching from NYC: JFK, EWR, LGA\n\nRoute        Depart                       Arrive                       Airline          Price       Duration\n------------------------------------------------------------------------------------------------------------\nEWR→LAX      6:00 AM on Sat, Mar 7        9:07 AM on Sat, Mar 7        United           $289        6 hr 7 min\nEWR→LAX      12:00 PM on Sat, Mar 7       3:14 PM on Sat, Mar 7        United           $289        6 hr 14 min\nJFK→LAX      8:00 AM on Sat, Mar 7        11:30 AM on Sat, Mar 7       Delta            $304        5 hr 30 min\n\n3 flight(s) found.\n\nNotes\nDate format: YYYY-MM-DD\nAirport codes: Standard IATA codes (JFK, LAX, LHR, etc.)\nPrices are in USD\nTimes shown in local airport timezone\nNo API key required — uses Google Flights data via reverse-engineered protobuf API\nSome routes may return price-only results (missing departure/arrival times) due to upstream parsing limitations\nData Source\n\nUses Google Flights data via the fast-flights Python package."
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/BrennerSpear/flights-search",
    "publisherUrl": "https://clawhub.ai/BrennerSpear/flights-search",
    "owner": "BrennerSpear",
    "version": "1.2.0",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/flights-search",
    "downloadUrl": "https://openagent3.xyz/downloads/flights-search",
    "agentUrl": "https://openagent3.xyz/skills/flights-search/agent",
    "manifestUrl": "https://openagent3.xyz/skills/flights-search/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/flights-search/agent.md"
  }
}