Travel

Airhint

airhint-pp-cli

AirHint flight price prediction API — buy/wait recommendations for airline tickets

Printed by @jvm

Install

npx — recommended

npx -y @mvanhorn/printing-press-library install airhint

Installs the CLI binary and the agent skill (Claude Code, Codex, Cursor, Gemini CLI, Copilot, and more). Add --cli-only or --skill-only for one half. Requires Node.

Hermes

hermes skills install mvanhorn/printing-press-library/cli-skills/pp-airhint --force

From the Hermes CLI. Inside a chat session use /skills install with the same path.

OpenClaw

Install the pp-airhint skill from https://github.com/mvanhorn/printing-press-library/tree/main/cli-skills/pp-airhint. The skill defines how its required CLI can be installed.

Paste this to your OpenClaw agent — the skill describes how to install its CLI.

Claude Desktop

This CLI ships an MCPB bundle. Download the latest release .mcpb and double-click it — Claude Desktop walks you through the install.

View source on GitHub →

AirHint flight price prediction API — buy/wait recommendations for airline tickets

Learn more at Airhint.

Created by @jvm (jvm).

Quick Start

1. Install

See Install above.

2. Verify Setup

airhint-pp-cli doctor

This checks your configuration.

3. Try Your First Command

airhint-pp-cli airport-autocomplete --query example-value

Unique Features

These capabilities aren't available in any other tool for this API.

Compound query

workflow predict-sweep — Sweep buy/wait predictions across a date range for a route, fetching live prices for each date

Enables batch price intelligence for flexible travelers — find the cheapest AND safest date to buy
```
airhint-pp-cli workflow predict-sweep STN DUB --days 14 --airline FR --json
```
workflow compare-routes — Compare buy/wait predictions across multiple origin-destination pairs on the same date

One command to compare 3+ routes vs 3+ browser tabs — agent-native travel planning
```
airhint-pp-cli workflow compare-routes 2026-08-16 STN:DUB LGW:BCN MAD:LIS --json
```

Local state that compounds

workflow cheapest-window — Find the cheapest departure date in a given month using the cheapest-deal-month and cheapest-airline-deal-month endpoints

Answers 'what date in August is cheapest for STN→DUB?' without opening the browser
```
airhint-pp-cli workflow cheapest-window STN DUB 8 --airline FR
```

Usage

Run airhint-pp-cli --help for the full command reference and flag list.

Commands

airport-autocomplete

Airport and city search autocomplete

airhint-pp-cli airport-autocomplete - Search airports and cities by name or IATA code

airport-names

Bulk airport name lookup

airhint-pp-cli airport-names - Get airport names for a list of IATA codes

cheapest-airline-deal-month

Find the cheapest deal for a specific airline in a month

airhint-pp-cli cheapest-airline-deal-month <airline> <origin> <destination> <date> <currency> - Get cheapest fare for a specific airline on a route near a date

cheapest-deal-month

Find the cheapest flight deal in a given month

airhint-pp-cli cheapest-deal-month <origin> <destination> <month> - Get the cheapest one-way fare for a route in a given month

flights

Flight search — find available flights and current prices

airhint-pp-cli flights create-search - Initiate a flight search, returns a search_id for polling
airhint-pp-cli flights get-search - Poll for search results using the search_id from create_search

predict

Flight price prediction — buy or wait recommendations

airhint-pp-cli predict <airline> <origin> <destination> <date> - Get buy/wait recommendation for a flight at a given price

Output Formats

# Human-readable table (default in terminal, JSON when piped)
airhint-pp-cli airport-autocomplete --query example-value

# JSON for scripting and agents
airhint-pp-cli airport-autocomplete --query example-value --json

# Filter to specific fields
airhint-pp-cli airport-autocomplete --query example-value --json --select id,name,status

# Dry run — show the request without sending
airhint-pp-cli airport-autocomplete --query example-value --dry-run

# Agent mode — JSON + compact + no prompts in one flag
airhint-pp-cli airport-autocomplete --query example-value --agent

Agent Usage

This CLI is designed for AI agent consumption:

Non-interactive - never prompts, every input is a flag
Pipeable - --json output to stdout, errors to stderr
Filterable - --select id,name returns only fields you need
Previewable - --dry-run shows the request without sending
Explicit retries - add --idempotent to create retries when a no-op success is acceptable
Confirmable - --yes for explicit confirmation of destructive actions
Piped input - write commands can accept structured input when their help lists --stdin
Offline-friendly - sync/search commands can use the local SQLite store when available
Agent-safe by default - no colors or formatting unless --human-friendly is set

Exit codes: 0 success, 2 usage error, 3 not found, 5 API error, 7 rate limited, 10 config error.

Health Check

airhint-pp-cli doctor

Verifies configuration and connectivity to the API.

Configuration

Config file: ~/.config/airhint-pp-cli/config.toml

Static request headers can be configured under headers; per-command header overrides take precedence.

Troubleshooting

Not found errors (exit code 3)

Check the resource ID is correct
Run the list command to see available items

HTTP Transport

This CLI uses Chrome-compatible HTTP transport for browser-facing endpoints. It does not require a resident browser process for normal API calls.

Discovery Signals

This CLI was generated with browser-captured traffic analysis.

Target observed: https://region1.analytics.google.com/g/collect
Capture coverage: 8 API entries from 16 total network entries
Reachability: browser_http (78% confidence)
Protocols: rest_json (75% confidence)
Protection signals: cloudflare (90% confidence)
Generation hints: browser_http_transport, requires_protected_client, weak_schema_confidence
Candidate command ideas: create_airport_names — Derived from observed POST /airport-names traffic.; get_DUB — Derived from observed GET /cheapest-deal-month/one-way/STN/DUB/{dub_id} traffic.; get_search — Derived from observed GET /search/{search_id} traffic.; list_2026_08_16 — Derived from observed GET /predict/FR/STN/DUB/2026-08-16 traffic.; list_airport_autocomplete — Derived from observed GET /airport-autocomplete traffic.; list_inline_ads — Derived from observed GET /inline-ads traffic.; list_kayak_location_lookup — Derived from observed GET /kayak-location-lookup traffic.

Warnings from discovery:

weak_schema_evidence: Binary or protobuf response cannot provide reliable JSON schema evidence.

Generated by CLI Printing Press