{ "schemaVersion": "1.0", "item": { "slug": "flightclaw", "name": "FlightClaw", "source": "tencent", "type": "skill", "category": "开发工具", "sourceUrl": "https://clawhub.ai/jackculpan/flightclaw", "canonicalUrl": "https://clawhub.ai/jackculpan/flightclaw", "targetPlatform": "OpenClaw" }, "install": { "downloadMode": "redirect", "downloadUrl": "/downloads/flightclaw", "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=flightclaw", "sourcePlatform": "tencent", "targetPlatform": "OpenClaw", "installMethod": "Manual import", "extraction": "Extract archive", "prerequisites": [ "OpenClaw" ], "packageFormat": "ZIP package", "includedAssets": [ "setup.sh", "server.py", "SKILL.md", "scripts/search-flights.py", "scripts/check-prices.py", "scripts/track-flight.py" ], "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/flightclaw" }, "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/flightclaw", "agentPageUrl": "https://openagent3.xyz/skills/flightclaw/agent", "manifestUrl": "https://openagent3.xyz/skills/flightclaw/agent.json", "briefUrl": "https://openagent3.xyz/skills/flightclaw/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": "flightclaw", "body": "Track flight prices from Google Flights. Search routes, monitor prices over time, and get alerts when prices drop." }, { "title": "Install", "body": "npx skills add jackculpan/flightclaw\n\nOr manually:\n\nbash skills/flightclaw/setup.sh" }, { "title": "Search Flights", "body": "Find flights for a specific route and date. Supports multiple airports and date ranges.\n\npython skills/flightclaw/scripts/search-flights.py LHR JFK 2025-07-01\npython skills/flightclaw/scripts/search-flights.py LHR JFK 2025-07-01 --cabin BUSINESS\npython skills/flightclaw/scripts/search-flights.py LHR JFK 2025-07-01 --return-date 2025-07-08\npython skills/flightclaw/scripts/search-flights.py LHR JFK 2025-07-01 --stops NON_STOP --results 10\n# Multiple airports (searches all combinations)\npython skills/flightclaw/scripts/search-flights.py LHR,MAN JFK,EWR 2025-07-01\n# Date range (searches each day)\npython skills/flightclaw/scripts/search-flights.py LHR JFK 2025-07-01 --date-to 2025-07-05\n# Both\npython skills/flightclaw/scripts/search-flights.py LHR,MAN JFK,EWR 2025-07-01 --date-to 2025-07-03\n\nArguments:\n\norigin - IATA airport code(s), comma-separated (e.g. LHR or LHR,MAN)\ndestination - IATA airport code(s), comma-separated (e.g. JFK or JFK,EWR)\ndate - Departure date (YYYY-MM-DD)\n--date-to - End of date range (YYYY-MM-DD). Searches each day from date to date-to inclusive.\n--return-date - Return date for round trips (YYYY-MM-DD)\n--cabin - ECONOMY (default), PREMIUM_ECONOMY, BUSINESS, FIRST\n--stops - ANY (default), NON_STOP, ONE_STOP, TWO_STOPS\n--results - Number of results (default: 5)" }, { "title": "Track a Flight", "body": "Add a route to the price tracking list and record the current price. Supports multiple airports and date ranges (creates a separate tracking entry for each combination).\n\npython skills/flightclaw/scripts/track-flight.py LHR JFK 2025-07-01\npython skills/flightclaw/scripts/track-flight.py LHR JFK 2025-07-01 --target-price 400\npython skills/flightclaw/scripts/track-flight.py LHR JFK 2025-07-01 --return-date 2025-07-08 --cabin BUSINESS\n# Track multiple airports and dates\npython skills/flightclaw/scripts/track-flight.py LHR,MAN JFK,EWR 2025-07-01 --date-to 2025-07-03 --target-price 400\n\nArguments:\n\nSame as search-flights, plus:\n--target-price - Alert when price drops below this amount" }, { "title": "Check Prices", "body": "Check all tracked flights for price changes. Designed to run on a schedule (cron).\n\npython skills/flightclaw/scripts/check-prices.py\npython skills/flightclaw/scripts/check-prices.py --threshold 5\n\nArguments:\n\n--threshold - Percentage drop to trigger alert (default: 10)\n\nOutput: Reports price changes for tracked flights. Highlights drops and alerts when target prices are reached." }, { "title": "List Tracked Flights", "body": "Show all flights being tracked with current vs original prices.\n\npython skills/flightclaw/scripts/list-tracked.py" }, { "title": "MCP Server", "body": "FlightClaw also runs as an MCP server with extended search capabilities:\n\npip install flights \"mcp[cli]\"\nclaude mcp add flightclaw -- python3 server.py\n\nMCP tools: search_flights, search_dates, track_flight, check_prices, list_tracked, remove_tracked\n\nAdditional MCP filters: passengers (adults/children/infants), airline filter, price limit, max flight duration, departure/arrival time restrictions, layover duration, sort order, and cheapest-date calendar search." }, { "title": "Currency", "body": "Prices are returned in the user's local currency based on their IP location. The currency is auto-detected from the Google Flights API response and displayed with the correct symbol (e.g. $, £, ฿, €). Tracked flights store the currency code in tracked.json." }, { "title": "Data", "body": "Price history is stored in skills/flightclaw/data/tracked.json and persists via R2 backup." } ], "body": "flightclaw\n\nTrack flight prices from Google Flights. Search routes, monitor prices over time, and get alerts when prices drop.\n\nInstall\nnpx skills add jackculpan/flightclaw\n\n\nOr manually:\n\nbash skills/flightclaw/setup.sh\n\nScripts\nSearch Flights\n\nFind flights for a specific route and date. Supports multiple airports and date ranges.\n\npython skills/flightclaw/scripts/search-flights.py LHR JFK 2025-07-01\npython skills/flightclaw/scripts/search-flights.py LHR JFK 2025-07-01 --cabin BUSINESS\npython skills/flightclaw/scripts/search-flights.py LHR JFK 2025-07-01 --return-date 2025-07-08\npython skills/flightclaw/scripts/search-flights.py LHR JFK 2025-07-01 --stops NON_STOP --results 10\n# Multiple airports (searches all combinations)\npython skills/flightclaw/scripts/search-flights.py LHR,MAN JFK,EWR 2025-07-01\n# Date range (searches each day)\npython skills/flightclaw/scripts/search-flights.py LHR JFK 2025-07-01 --date-to 2025-07-05\n# Both\npython skills/flightclaw/scripts/search-flights.py LHR,MAN JFK,EWR 2025-07-01 --date-to 2025-07-03\n\n\nArguments:\n\norigin - IATA airport code(s), comma-separated (e.g. LHR or LHR,MAN)\ndestination - IATA airport code(s), comma-separated (e.g. JFK or JFK,EWR)\ndate - Departure date (YYYY-MM-DD)\n--date-to - End of date range (YYYY-MM-DD). Searches each day from date to date-to inclusive.\n--return-date - Return date for round trips (YYYY-MM-DD)\n--cabin - ECONOMY (default), PREMIUM_ECONOMY, BUSINESS, FIRST\n--stops - ANY (default), NON_STOP, ONE_STOP, TWO_STOPS\n--results - Number of results (default: 5)\nTrack a Flight\n\nAdd a route to the price tracking list and record the current price. Supports multiple airports and date ranges (creates a separate tracking entry for each combination).\n\npython skills/flightclaw/scripts/track-flight.py LHR JFK 2025-07-01\npython skills/flightclaw/scripts/track-flight.py LHR JFK 2025-07-01 --target-price 400\npython skills/flightclaw/scripts/track-flight.py LHR JFK 2025-07-01 --return-date 2025-07-08 --cabin BUSINESS\n# Track multiple airports and dates\npython skills/flightclaw/scripts/track-flight.py LHR,MAN JFK,EWR 2025-07-01 --date-to 2025-07-03 --target-price 400\n\n\nArguments:\n\nSame as search-flights, plus:\n--target-price - Alert when price drops below this amount\nCheck Prices\n\nCheck all tracked flights for price changes. Designed to run on a schedule (cron).\n\npython skills/flightclaw/scripts/check-prices.py\npython skills/flightclaw/scripts/check-prices.py --threshold 5\n\n\nArguments:\n\n--threshold - Percentage drop to trigger alert (default: 10)\n\nOutput: Reports price changes for tracked flights. Highlights drops and alerts when target prices are reached.\n\nList Tracked Flights\n\nShow all flights being tracked with current vs original prices.\n\npython skills/flightclaw/scripts/list-tracked.py\n\nMCP Server\n\nFlightClaw also runs as an MCP server with extended search capabilities:\n\npip install flights \"mcp[cli]\"\nclaude mcp add flightclaw -- python3 server.py\n\n\nMCP tools: search_flights, search_dates, track_flight, check_prices, list_tracked, remove_tracked\n\nAdditional MCP filters: passengers (adults/children/infants), airline filter, price limit, max flight duration, departure/arrival time restrictions, layover duration, sort order, and cheapest-date calendar search.\n\nCurrency\n\nPrices are returned in the user's local currency based on their IP location. The currency is auto-detected from the Google Flights API response and displayed with the correct symbol (e.g. $, £, ฿, €). Tracked flights store the currency code in tracked.json.\n\nData\n\nPrice history is stored in skills/flightclaw/data/tracked.json and persists via R2 backup." }, "trust": { "sourceLabel": "tencent", "provenanceUrl": "https://clawhub.ai/jackculpan/flightclaw", "publisherUrl": "https://clawhub.ai/jackculpan/flightclaw", "owner": "jackculpan", "version": "1.0.1", "license": null, "verificationStatus": "Indexed source record" }, "links": { "detailUrl": "https://openagent3.xyz/skills/flightclaw", "downloadUrl": "https://openagent3.xyz/downloads/flightclaw", "agentUrl": "https://openagent3.xyz/skills/flightclaw/agent", "manifestUrl": "https://openagent3.xyz/skills/flightclaw/agent.json", "briefUrl": "https://openagent3.xyz/skills/flightclaw/agent.md" } }