# Send FlightClaw to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- 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.
## Suggested prompts
### New install

```text
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.
```
### Upgrade existing

```text
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.
```
## Machine-readable fields
```json
{
  "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": {
    "downloadUrl": "/downloads/flightclaw",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=flightclaw",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "setup.sh",
      "server.py",
      "SKILL.md",
      "scripts/search-flights.py",
      "scripts/check-prices.py",
      "scripts/track-flight.py"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "flightclaw",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-05-03T07:43:56.337Z",
      "expiresAt": "2026-05-10T07:43:56.337Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=flightclaw",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=flightclaw",
        "contentDisposition": "attachment; filename=\"flightclaw-1.0.1.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "flightclaw"
      },
      "scope": "item",
      "summary": "Item download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this item.",
      "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."
      ]
    }
  },
  "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"
  }
}
```
## Documentation

### flightclaw

Track flight prices from Google Flights. Search routes, monitor prices over time, and get alerts when prices drop.

### Install

npx skills add jackculpan/flightclaw

Or manually:

bash skills/flightclaw/setup.sh

### Search Flights

Find flights for a specific route and date. Supports multiple airports and date ranges.

python skills/flightclaw/scripts/search-flights.py LHR JFK 2025-07-01
python skills/flightclaw/scripts/search-flights.py LHR JFK 2025-07-01 --cabin BUSINESS
python skills/flightclaw/scripts/search-flights.py LHR JFK 2025-07-01 --return-date 2025-07-08
python skills/flightclaw/scripts/search-flights.py LHR JFK 2025-07-01 --stops NON_STOP --results 10
# Multiple airports (searches all combinations)
python skills/flightclaw/scripts/search-flights.py LHR,MAN JFK,EWR 2025-07-01
# Date range (searches each day)
python skills/flightclaw/scripts/search-flights.py LHR JFK 2025-07-01 --date-to 2025-07-05
# Both
python skills/flightclaw/scripts/search-flights.py LHR,MAN JFK,EWR 2025-07-01 --date-to 2025-07-03

Arguments:

origin - IATA airport code(s), comma-separated (e.g. LHR or LHR,MAN)
destination - IATA airport code(s), comma-separated (e.g. JFK or JFK,EWR)
date - Departure date (YYYY-MM-DD)
--date-to - End of date range (YYYY-MM-DD). Searches each day from date to date-to inclusive.
--return-date - Return date for round trips (YYYY-MM-DD)
--cabin - ECONOMY (default), PREMIUM_ECONOMY, BUSINESS, FIRST
--stops - ANY (default), NON_STOP, ONE_STOP, TWO_STOPS
--results - Number of results (default: 5)

### Track a Flight

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).

python skills/flightclaw/scripts/track-flight.py LHR JFK 2025-07-01
python skills/flightclaw/scripts/track-flight.py LHR JFK 2025-07-01 --target-price 400
python skills/flightclaw/scripts/track-flight.py LHR JFK 2025-07-01 --return-date 2025-07-08 --cabin BUSINESS
# Track multiple airports and dates
python skills/flightclaw/scripts/track-flight.py LHR,MAN JFK,EWR 2025-07-01 --date-to 2025-07-03 --target-price 400

Arguments:

Same as search-flights, plus:
--target-price - Alert when price drops below this amount

### Check Prices

Check all tracked flights for price changes. Designed to run on a schedule (cron).

python skills/flightclaw/scripts/check-prices.py
python skills/flightclaw/scripts/check-prices.py --threshold 5

Arguments:

--threshold - Percentage drop to trigger alert (default: 10)

Output: Reports price changes for tracked flights. Highlights drops and alerts when target prices are reached.

### List Tracked Flights

Show all flights being tracked with current vs original prices.

python skills/flightclaw/scripts/list-tracked.py

### MCP Server

FlightClaw also runs as an MCP server with extended search capabilities:

pip install flights "mcp[cli]"
claude mcp add flightclaw -- python3 server.py

MCP tools: search_flights, search_dates, track_flight, check_prices, list_tracked, remove_tracked

Additional 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.

### Currency

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.

### Data

Price history is stored in skills/flightclaw/data/tracked.json and persists via R2 backup.
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: jackculpan
- Version: 1.0.1
## Source health
- Status: healthy
- Item download looks usable.
- Yavira can redirect you to the upstream package for this item.
- Health scope: item
- Reason: direct_download_ok
- Checked at: 2026-05-03T07:43:56.337Z
- Expires at: 2026-05-10T07:43:56.337Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/flightclaw)
- [Send to Agent page](https://openagent3.xyz/skills/flightclaw/agent)
- [JSON manifest](https://openagent3.xyz/skills/flightclaw/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/flightclaw/agent.md)
- [Download page](https://openagent3.xyz/downloads/flightclaw)