Skip to content

skywain/trip-planner-skill

trip-planner

Unverified

End-to-end international trip planning: turns "I want to go to X for N days" into a verified, bookable plan — route skeleton across cities, flight price scans (international + domestic legs), train-vs-fly decisions, hour-by-hour daily timelines with opening hours, dwell times, holiday collisions and tappable turn-by-turn map links (小时级行程+地图导航+离线KML), hotel shortlists by neighborhood, budget rollup, and a booking checklist with deep links. Use this whenever the user asks to plan a trip, vacation, itinerary or honeymoon, compare flight dates/prices, pick between cities or routes, schedule a travel day hour by hour, fill a spare block of time ("I'm near X with 2 free hours"), turn a finished plan into a designed page (eight themed renders: illustrated / clay / noir / glass / journal / zine / splash / portal — 插画/黏土/夜航/玻璃/手账/Zine/闪屏/穿越版), or asks 旅行规划/行程安排/机票比价/去某国玩N天怎么安排/现在有空档干嘛/把行程做成好看的网页 — even if they only mention one piece (just flights, just hotels, or just navigation), the playbook and verification rules here still apply.

FileKindSize
SKILL.mdskill md32.9 KB
assets/plan.example.jsonconfig12.1 KB
examples/README.mdmarkdown13.0 KB
examples/china-2026/china-splash.htmlother937.1 KB
examples/china-2026/china.art.jsonconfig6.4 KB
examples/china-2026/china.geo.jsonconfig58.3 KB
examples/fixtures/bad/bracketed-note.geo.jsonconfig7.8 KB
examples/fixtures/bad/brief-card-not-text.geo.jsonconfig943 B
examples/fixtures/bad/decision-point-date-two-days-before.geo.jsonconfig848 B
examples/fixtures/bad/decision-point-day-date-not-iso.geo.jsonconfig7.8 KB
examples/fixtures/bad/decision-point-no-if-no.geo.jsonconfig715 B
examples/fixtures/bad/decision-point-same-what.geo.jsonconfig8.2 KB
examples/fixtures/bad/decision-point-src-not-http.geo.jsonconfig803 B
examples/fixtures/bad/decision-point-t-not-hhmm.geo.jsonconfig764 B
examples/fixtures/bad/decision-points-null.geo.jsonconfig594 B
examples/fixtures/bad/driver-enum.geo.jsonconfig711 B
examples/fixtures/bad/driver-self-no-driving-card.geo.jsonconfig736 B
examples/fixtures/bad/driving-card-no-as-of.geo.jsonconfig861 B
examples/fixtures/bad/driving-card-no-desk.geo.jsonconfig800 B
examples/fixtures/bad/driving-card-no-legality-line.geo.jsonconfig811 B
examples/fixtures/bad/driving-card-no-verdict.geo.jsonconfig939 B
examples/fixtures/bad/driving-card-zh-verdict-trailing.geo.jsonconfig967 B
examples/fixtures/bad/hotel-checkout-null.geo.jsonconfig786 B
examples/fixtures/bad/hours-as-of-not-date.geo.jsonconfig674 B
examples/fixtures/bad/hours-bare-string.geo.jsonconfig655 B
examples/fixtures/bad/hours-src-not-http.geo.jsonconfig662 B
examples/fixtures/bad/hours-text-empty.geo.jsonconfig647 B
examples/fixtures/bad/kind-enum.geo.jsonconfig7.9 KB
examples/fixtures/bad/must-false.geo.jsonconfig914 B
examples/fixtures/bad/must-no-stand.geo.jsonconfig755 B
examples/fixtures/bad/must-no-view.geo.jsonconfig758 B
examples/fixtures/bad/must-not-boolean.geo.jsonconfig798 B
examples/fixtures/bad/must-see-unmatched.geo.jsonconfig963 B
examples/fixtures/bad/must-see-view-empty.geo.jsonconfig910 B
examples/fixtures/bad/pending-no-checklist-row.geo.jsonconfig1021 B
examples/fixtures/bad/refundable-not-boolean.geo.jsonconfig686 B
examples/fixtures/bad/rental-leg-no-driving-card.geo.jsonconfig829 B
examples/fixtures/bad/review-counts-disagree.geo.jsonconfig1.0 KB
examples/fixtures/bad/review-lens-enum.geo.jsonconfig1.1 KB
examples/fixtures/bad/review-no-driving-lens.geo.jsonconfig1.3 KB
examples/fixtures/bad/review-not-object.geo.jsonconfig611 B
examples/fixtures/bad/review-single-pass-with-counts.geo.jsonconfig1.0 KB
examples/fixtures/bad/review-two-lenses.geo.jsonconfig959 B
examples/fixtures/bad/self-drive-no-driving-card.geo.jsonconfig635 B
examples/fixtures/bad/sub-stop-no-name.geo.jsonconfig763 B
examples/fixtures/bad/sub-stop-no-query.geo.jsonconfig763 B
examples/fixtures/bad/sub-stops-null.geo.jsonconfig578 B
examples/fixtures/bad/tour-confirmed-prefix.geo.jsonconfig902 B
examples/fixtures/bad/tour-not-boolean.geo.jsonconfig562 B
examples/fixtures/bad/tour-on-day-object.geo.jsonconfig7.8 KB
examples/fixtures/bad/tour-unconfirmed.geo.jsonconfig837 B
examples/fixtures/strict/clean.plan.geo.jsonconfig4.5 KB
examples/fixtures/strict/hours-as-of-after-asof.geo.jsonconfig4.1 KB
examples/fixtures/strict/hours-missing-in-window.geo.jsonconfig4.0 KB
examples/fixtures/strict/hours-stale-as-of.geo.jsonconfig4.1 KB
examples/fixtures/strict/no-generated.geo.jsonconfig3.8 KB
examples/fixtures/strict/refundable-no-clause.geo.jsonconfig3.8 KB
examples/fixtures/strict/rows-without-clock-or-kind.geo.jsonconfig3.7 KB
examples/fixtures/strict/self-drive-not-legal-no-decision.geo.jsonconfig4.4 KB
examples/fixtures/strict/t-n-date-mismatch.geo.jsonconfig3.8 KB
examples/fixtures/strict/tour-no-review.geo.jsonconfig3.4 KB
examples/fixtures/substops.plan.geo.jsonconfig9.1 KB
examples/gates-sample.icsother11.5 KB
examples/japan-2026/japan-illustrated.htmlother1.4 MB
examples/japan-2026/japan.art.jsonconfig6.2 KB
examples/japan-2026/japan.geo.jsonconfig65.5 KB
examples/kyoto-sample.htmlother13.0 KB
examples/kyoto-sample.kmlother1012 B
examples/kyoto-sample.plan.geo.jsonconfig7.2 KB
examples/mexico-2026/mexico-journal.htmlother2.0 MB
examples/mexico-2026/mexico.art.jsonconfig9.4 KB
examples/mexico-2026/mexico.geo.jsonconfig77.1 KB
examples/morocco-2026/morocco-glass.htmlother1.3 MB
examples/morocco-2026/morocco-portal.htmlother13.8 KB
examples/morocco-2026/morocco.art.jsonconfig3.8 KB
examples/morocco-2026/morocco.geo.jsonconfig85.1 KB
examples/nordic-2026/nordic-noir.htmlother686.8 KB
examples/nordic-2026/nordic.art.jsonconfig8.7 KB
examples/nordic-2026/nordic.geo.jsonconfig58.5 KB
examples/turkey-2026/turkey-clay.htmlother1.3 MB
examples/turkey-2026/turkey.art.jsonconfig3.5 KB
examples/turkey-2026/turkey.geo.jsonconfig75.8 KB
examples/vietnam-2026/vietnam-zine.htmlother2.5 MB
examples/vietnam-2026/vietnam.art.jsonconfig10.8 KB
examples/vietnam-2026/vietnam.geo.jsonconfig85.1 KB
references/art-schema.mdmarkdown318 B
references/country-quick-notes.mdmarkdown58.6 KB
references/cover-titles.mdmarkdown10.6 KB
references/data-sources.mdmarkdown49.2 KB
references/navigation.mdmarkdown23.6 KB
references/output-template.mdmarkdown49.2 KB
references/phase-0-intake.mdmarkdown12.4 KB
references/phase-1-brief.mdmarkdown22.8 KB
references/phase-3-legs.mdmarkdown10.5 KB
references/phase-4-days.mdmarkdown13.6 KB
references/phase-6-assemble.mdmarkdown22.3 KB
references/scheduling.mdmarkdown28.8 KB
references/themes.mdmarkdown37.9 KB
scripts/build_site.pyscript47.8 KB
scripts/flight_scan.pyscript18.9 KB
scripts/plan_lint.pyscript58.4 KB
scripts/render_plan.pyscript28.2 KB
scripts/route_tools.pyscript90.0 KB

scripts/flight_scan.py

View on GitHub
#!/usr/bin/env python3
"""Google Flights grid scanner (keyless) — part of the trip-planner skill.

Requires once:  python3 -m pip install --user fast-flights
  (externally-managed-environment / PEP 668 on Homebrew or Debian Python: add
   --break-system-packages, or install into a venv and run this script with its python)

Examples:
  # round trip, nights ranging 10-15, departure date +/- 2 days
  python3 flight_scan.py --from PVG --to NRT --depart 2026-10-01 --nights 10-15 --flex 2
  # one way (run twice for open-jaw halves)
  python3 flight_scan.py --from KIX --to PVG --depart 2026-10-14 --oneway
  # nonstop only, prices in CNY, 2 adults
  python3 flight_scan.py --from PEK --to SYD --depart 2026-10-01 --nights 7 --nonstop \\
                         --currency CNY --adults 2

What the numbers mean (verified 2026-08-15 by scanning the same date with 1 vs 2
adults: $969 -> $1938):
  * PRICE = TOTAL for all passengers (--adults N), NOT per person. Divide by N.
  * Round trip: the ROUND-TRIP total (outbound + return), shown against the OUTBOUND
    options. Google's first results page lists outbound flights only — the return
    leg is chosen on the next page — so this script never sees return-leg times.
    Need the return leg's timetable? Run the reverse route as --oneway on the return
    date (its prices are one-way fares, not the round-trip split).
  * Currency: --currency XXX (ISO code, e.g. CNY, EUR, JPY) sets Google's `curr=`
    parameter; without it Google picks by the connection's region (USD from a US
    IP). The header line prints which one applied, and each price carries the
    symbol Google returned (e.g. "CN¥6534").
  * Stops: every row shows nonstop / N stop; --nonstop (or --max-stops N) asks
    Google for that filter, so the nonstops are not buried below 80 cheaper
    multi-stop rows (--top 5 sorted by price never reached them before). Without
    the filter, each block also prints the cheapest nonstop it saw.

Prices come from Google's cached results — comparison grade only; the deep link
printed with every block is the source of truth. The script sleeps between fetches
and caps total fetches (--max-fetches, default 12) so it behaves like one polite
human; a wide grid such as "--nights 10-15 --flex 2" is 30 combos, so either raise
the cap (~5-10 s per combo) or accept the centre-out subset it scans by default.

Failures: FETCH FAILED lines name the route and date. AssertionError = Google
answered with a non-200 page (bot wall / consent) and the fallback service could
not render it either; RuntimeError "No flights found" = the page had no result
list (unserved pair, or a date too far out). Both -> use the printed link.
"""
import argparse
import re
import sys
import time
from datetime import date, timedelta
from urllib.parse import quote


def parse_nights(s):
    if "-" in s:
        a, b = s.split("-", 1)
        return list(range(int(a), int(b) + 1))
    return [int(s)]


def price_num(p):
    digits = re.sub(r"[^\d]", "", p or "")
    return int(digits) if digits else 0


def price_symbol(p):
    """The currency prefix Google put on a price string ('CN¥6534' -> 'CN¥')."""
    m = re.match(r"^\s*([^\d\s]+)", p or "")
    return m.group(1) if m else ""


def clock_min(s):
    m = re.search(r"(\d{1,2}):(\d{2})\s*(AM|PM)", s or "")
    if not m:
        return None
    h = int(m.group(1)) % 12 + (12 if m.group(3) == "PM" else 0)
    return h * 60 + int(m.group(2))


MONTHS = {m: i + 1 for i, m in enumerate(
    ["Jan", "Feb", "Mar", "Apr", "May", "Jun",
     "Jul", "Aug", "Sep", "Oct", "Nov", "Dec"])}


def month_day(s):
    m = re.search(r"([A-Z][a-z]{2})\s+(\d{1,2})", s or "")
    if not m or m.group(1) not in MONTHS:
        return None
    return (MONTHS[m.group(1)], int(m.group(2)))


def hhmm(s):
    m = re.match(r"^(\d{1,2}):(\d{2})$", s)
    if not m:
        raise argparse.ArgumentTypeError("time must be HH:MM (24h), e.g. 08:30")
    v = int(m.group(1)) * 60 + int(m.group(2))
    if not 0 <= v < 1440:
        raise argparse.ArgumentTypeError("time out of range")
    return v


def gflights_link(orig, dest, dep, ret=None, adults=1):
    if ret:
        q = "Flights from {} to {} on {} returning {} for {} adults".format(
            orig, dest, dep, ret, adults)
    else:
        q = "One way flights from {} to {} on {} for {} adults".format(
            orig, dest, dep, adults)
    return "https://www.google.com/travel/flights?q=" + quote(q)


def stops_label(stops):
    if stops == 0:
        return "nonstop"
    if isinstance(stops, int):
        return "{} stop".format(stops)
    return "? stops"


def fetch_grid_cell(legs, trip, pax, max_stops, currency):
    """One Google fetch. Prefers get_flights_from_filter (carries currency and
    max_stops); falls back to get_flights on very old fast-flights builds."""
    try:
        from fast_flights import get_flights_from_filter
        from fast_flights.flights_impl import TFSData
    except ImportError:
        get_flights_from_filter = TFSData = None
    if TFSData is not None:
        try:
            filt = TFSData.from_interface(flight_data=legs, trip=trip,
                                          seat="economy", passengers=pax,
                                          max_stops=max_stops)
        except TypeError:                     # older build: no max_stops kwarg
            if max_stops is not None:
                print("  (this fast-flights build ignores --nonstop/--max-stops)")
            filt = TFSData.from_interface(flight_data=legs, trip=trip,
                                          seat="economy", passengers=pax)
        try:
            return get_flights_from_filter(filt, currency=currency or "",
                                           mode="fallback")
        except TypeError:                     # older build: no currency kwarg
            if currency:
                print("  (this fast-flights build ignores --currency)")
            return get_flights_from_filter(filt, mode="fallback")
    from fast_flights import get_flights
    if currency or max_stops is not None:
        print("  (this fast-flights build ignores --currency/--nonstop)")
    try:
        return get_flights(flight_data=legs, trip=trip, seat="economy",
                           passengers=pax, fetch_mode="fallback")
    except TypeError:
        return get_flights(flight_data=legs, trip=trip, seat="economy",
                           passengers=pax)


def main():
    ap = argparse.ArgumentParser(
        description=__doc__, formatter_class=argparse.RawDescriptionHelpFormatter)
    ap.add_argument("--from", dest="orig", required=True,
                    help="IATA airport/city code, e.g. PVG")
    ap.add_argument("--to", dest="dest", required=True)
    ap.add_argument("--depart", required=True, help="YYYY-MM-DD")
    ap.add_argument("--nights", default=None,
                    help='round trip length, e.g. "12" or a range "10-15"')
    ap.add_argument("--oneway", action="store_true")
    ap.add_argument("--flex", type=int, default=0,
                    help="also scan departure +/- N days")
    ap.add_argument("--adults", type=int, default=1,
                    help="passengers; PRICES ARE THE TOTAL FOR ALL OF THEM")
    ap.add_argument("--top", type=int, default=5,
                    help="show N cheapest options per date combo")
    ap.add_argument("--max-fetches", type=int, default=12)
    ap.add_argument("--nonstop", action="store_true",
                    help="ask Google for nonstop flights only (= --max-stops 0)")
    ap.add_argument("--max-stops", type=int, default=None, metavar="N",
                    help="ask Google for at most N stops")
    ap.add_argument("--currency", default=None, metavar="XXX",
                    help="ISO currency for the prices (CNY, EUR, JPY, AUD ...); "
                         "default: Google's choice for this connection's region")
    # Sorting by price alone surfaces red-eyes and next-day arrivals first — the
    # cheapest rows are often exactly the flights a schedule can't use. These
    # windows make "cheapest USABLE flight" a one-command answer.
    ap.add_argument("--dep-after", type=hhmm, default=None, metavar="HH:MM",
                    help="keep departures at/after this local time (24h)")
    ap.add_argument("--dep-before", type=hhmm, default=None, metavar="HH:MM",
                    help="keep departures at/before this local time")
    ap.add_argument("--arr-before", type=hhmm, default=None, metavar="HH:MM",
                    help="keep SAME-DAY arrivals at/before this local time "
                         "(next-day arrivals are dropped)")
    args = ap.parse_args()

    if not args.oneway and not args.nights:
        ap.error("--nights is required unless --oneway")
    if args.oneway and args.nights:
        ap.error("--oneway and --nights are mutually exclusive")
    max_stops = 0 if args.nonstop else args.max_stops
    if max_stops is not None and max_stops < 0:
        ap.error("--max-stops must be >= 0")
    currency = (args.currency or "").upper() or None
    if currency and not re.fullmatch(r"[A-Z]{3}", currency):
        ap.error("--currency must be a 3-letter ISO code such as CNY")

    try:
        from fast_flights import FlightData, Passengers   # noqa: F401
    except ImportError:
        print("fast-flights is not installed. Run:\n"
              "  python3 -m pip install --user fast-flights\n"
              "  (externally-managed-environment / PEP 668 on Homebrew or Debian Python:\n"
              "   python3 -m pip install --user --break-system-packages fast-flights\n"
              "   or: python3 -m venv ~/.trip-venv && ~/.trip-venv/bin/pip install fast-flights\n"
              "       then run this script with ~/.trip-venv/bin/python3)\n"
              "If that fails too, skip this script and open the browser instead:\n  "
              + gflights_link(args.orig, args.dest, args.depart,
                              None if args.oneway else args.depart, args.adults))
        sys.exit(2)

    base = date.fromisoformat(args.depart)
    deps = [base + timedelta(days=d) for d in range(-args.flex, args.flex + 1)]
    nights_list = [None] if args.oneway else parse_nights(args.nights)

    # Say what the numbers are BEFORE any of them print (Japan F10, AU F13).
    print("PRICES: TOTAL for {} adult(s){} — Google Flights shows all-passenger "
          "totals, not per person; {}; currency: {}. Stops are per row; {}."
          .format(args.adults,
                  " (divide by {} for per person)".format(args.adults)
                  if args.adults > 1 else "",
                  "one-way fare" if args.oneway else
                  "ROUND-TRIP total incl. the return leg, listed against the "
                  "OUTBOUND options (return-leg times are not on Google's first "
                  "page — scan the reverse route --oneway on the return date "
                  "for those)",
                  ("--currency " + currency) if currency else
                  "Google's default for this connection's region (curr= not "
                  "set; the symbol on each price says which)",
                  "nonstop only (--nonstop)" if max_stops == 0 else
                  "<= {} stop(s) (--max-stops)".format(max_stops)
                  if max_stops is not None else
                  "no stop filter (cheapest nonstop also shown per block)"))

    combos = [(d, n) for d in deps for n in nights_list]
    if len(combos) > args.max_fetches:
        # Scan the grid centre-out. The requested departure date and the middle of the
        # nights range are what the traveller actually asked about, so truncation has
        # to drop the edges of the grid — never the centre they came in with.
        mid_i = (len(nights_list) - 1) / 2.0
        def rank(c):
            d_off = (c[0] - base).days
            n_off = nights_list.index(c[1]) - mid_i if c[1] is not None else 0
            return (abs(d_off) + abs(n_off), abs(d_off), d_off, n_off)
        combos.sort(key=rank)
        print("NOTE: {} of {} date combos scanned (--max-fetches); kept the ones "
              "nearest {} and the middle of the nights range. Raise --max-fetches "
              "for the full grid, ~5-10 s per combo."
              .format(args.max_fetches, len(combos), args.depart))
        combos = combos[: args.max_fetches]
        combos.sort(key=lambda c: (c[0], c[1] if c[1] is not None else 0))

    pax = Passengers(adults=args.adults, children=0,
                     infants_in_seat=0, infants_on_lap=0)
    best_rows = []
    seen_symbols = set()
    for i, (d, n) in enumerate(combos):
        dep_s = d.isoformat()
        ret_s = (d + timedelta(days=n)).isoformat() if n else None
        legs = [FlightData(date=dep_s, from_airport=args.orig, to_airport=args.dest)]
        trip = "one-way"
        if ret_s:
            legs.append(FlightData(date=ret_s, from_airport=args.dest,
                                   to_airport=args.orig))
            trip = "round-trip"
        link = gflights_link(args.orig, args.dest, dep_s, ret_s, args.adults)
        route = "{}->{} {}{}".format(args.orig, args.dest, dep_s,
                                     " / back " + ret_s if ret_s else "")
        if ret_s:
            hdr = "{} -> {} ({} nights)".format(dep_s, ret_s, n)
        else:
            hdr = "{} (one way)".format(dep_s)
        res, err, err_body = None, "", ""
        for attempt in range(2):      # transient Google throttling is common
            try:
                res = fetch_grid_cell(legs, trip, pax, max_stops, currency)
                break
            except Exception as e:
                # AU F13: "FETCH FAILED (AssertionError)" named neither the airports
                # nor the date, so three failing cells were indistinguishable.
                err_body = " ".join(str(e).split())
                detail = err_body[:90]
                err = "{}: {}{}".format(type(e).__name__, route,
                                        " — " + detail if detail else "")
                if attempt == 0:
                    time.sleep(3)
        if res is None:
            if err.startswith("AssertionError"):
                # Not every AssertionError is Google's bot wall: a 401/403 in the
                # error body means the FALLBACK service refused us (auth), and no
                # amount of browsing Google will fix that.
                if re.search(r"(?<!\d)(401|403)(?!\d)", err_body):
                    hint = ("fallback renderer refused (auth) — a browser will "
                            "not help; ship the deep link as an estimate")
                else:
                    hint = ("Google returned a non-200 page (bot wall / consent) "
                            "and the fallback renderer failed too")
            else:
                hint = ("no result list on the page (unserved pair or date too "
                        "far out)" if err.startswith("RuntimeError") else
                        "network / parser error")
            print("\n== {} ==  FETCH FAILED ({}) — {}; use the link:\n  {}".format(
                hdr, err, hint, link))
            continue

        flights = sorted(list(getattr(res, "flights", [])),
                         key=lambda f: price_num(getattr(f, "price", "")) or 10 ** 9)
        seen = set()
        deduped = []
        for f in flights:
            k = (getattr(f, "name", ""), getattr(f, "departure", ""),
                 getattr(f, "price", ""))
            if k not in seen:
                seen.add(k)
                deduped.append(f)
        flights = deduped
        for f in flights:
            sym = price_symbol(getattr(f, "price", ""))
            if sym:
                seen_symbols.add(sym)

        if args.dep_after is not None or args.dep_before is not None \
                or args.arr_before is not None:
            def in_window(f):
                dm = clock_min(getattr(f, "departure", ""))
                if args.dep_after is not None and dm is not None \
                        and dm < args.dep_after:
                    return False
                if args.dep_before is not None and dm is not None \
                        and dm > args.dep_before:
                    return False
                if args.arr_before is not None:
                    arr = getattr(f, "arrival", "")
                    md = month_day(arr)
                    if md is not None and md != (d.month, d.day):
                        return False          # next-day arrival
                    am = clock_min(arr)
                    if am is not None and am > args.arr_before:
                        return False
                return True
            kept = [f for f in flights if in_window(f)]
            if len(kept) != len(flights):
                print("  (time window kept {} of {} options)".format(
                    len(kept), len(flights)))
            flights = kept
            if not flights:
                print("  no options inside the time window — widen it or "
                      "check the link below")
        level = getattr(res, "current_price", "?")
        print("\n== {}  [price level: {}] ==".format(hdr, level))
        shown = flights[: args.top]
        def show(f, tag=""):
            print("  {:>12}  {:>8}  {:>8}  {}{}{}".format(
                getattr(f, "price", "?"), getattr(f, "duration", "?"),
                stops_label(getattr(f, "stops", None)), getattr(f, "name", "?"),
                "  [BEST]" if getattr(f, "is_best", False) else "", tag))
            print("      {} -> {}".format(
                getattr(f, "departure", "?"), getattr(f, "arrival", "?")))
        for f in shown:
            show(f)
        if max_stops != 0:
            # Japan F10 / AU F13: nonstops exist but sit below dozens of cheaper
            # connections, so --top never reached them. Surface the cheapest one.
            ns = next((f for f in flights if getattr(f, "stops", None) == 0
                       and price_num(getattr(f, "price", ""))), None)
            if ns is not None and ns not in shown:
                show(ns, "  [cheapest nonstop]")
            elif ns is None and flights:
                print("  (no nonstop in Google's list for this date — try "
                      "--nonstop to be sure, or the link)")
        print("  link: " + link)

        cheapest = next(
            (f for f in flights if price_num(getattr(f, "price", ""))), None)
        if cheapest:
            best_rows.append((price_num(cheapest.price), hdr, cheapest.price,
                              getattr(cheapest, "name", "?")))
        if i < len(combos) - 1:
            time.sleep(1.5)

    if best_rows:
        best_rows.sort()
        print("\n===== CHEAPEST PER DATE COMBO, ACROSS GRID =====")
        for _, hdr, p, name in best_rows[:5]:
            print("  {:>12}  {}  ({})".format(p, hdr, name))
        print("Prices are Google-cache comparison grade; TOTAL for {} adult(s), "
              "{}; currency as printed ({}). Book via the links above.".format(
                  args.adults, "one-way" if args.oneway else "round-trip",
                  ", ".join(sorted(seen_symbols)) or
                  ("--currency " + currency if currency else "region default")))


if __name__ == "__main__":
    main()
brainstormingobra/superpowersYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation).Stars: 322kUpdated Claude CodeCodexVerifiedInstall
brand-guidelinesanthropics/skillsApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
frontend-designanthropics/skillsGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
mcp-builderanthropics/skillsGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK).Stars: 198kUpdated Claude CodeCodexVerifiedInstall