<!-- GENERATED FILE — DO NOT EDIT. This file is a verbatim mirror of library/travel/flight-goat/SKILL.md, regenerated post-merge by tools/generate-skills/. Hand-edits here are silently overwritten on the next regen. Edit the library/ source instead. See AGENTS.md "Generated artifacts: registry.json, cli-skills/". -->

Flight Goat — Printing Press CLI

前提条件: CLI のインストール

このスキルは flight-goat-pp-cli バイナリを使用します。このスキルからコマンドを呼び出す前に、CLI がインストールされていることを確認する必要があります。 インストールされていない場合は、まずインストールしてください:

1. Printing Press インストーラー経由でインストール:

   npx -y @mvanhorn/printing-press install flight-goat --cli-only
   

2. 確認: flight-goat-pp-cli --version
3. $GOPATH/bin (または $HOME/go/bin) が $PATH 上にあることを確認

npx インストールに失敗した場合 (Node がない、オフラインなど) は、直接 Go インストールにフォールバック (Go 1.26.3 以降が必要):

go install github.com/mvanhorn/printing-press-library/library/travel/flight-goat/cmd/flight-goat-pp-cli@latest

インストール後に --version で "command not found" が表示される場合、インストール手順がバイナリを $PATH に配置できなかったことを意味します。検証に成功するまでスキルコマンドに進まないでください。

カテゴリー

AeroAPI は発見しやすくするために、いくつかのカテゴリーに分かれています。

• Flights: サマリー情報、予定ルート、位置情報など
• Foresight: FlightAware Foresight™で拡張されたフライト位置
• Airports: 空港情報と FIDS スタイルのリソース
• Operators: オペレーター情報とフリート活動リソース
• Alerts: フライトアラートと配信先の設定
• History: 様々なエンドポイントへの過去のフライトアクセス
• Miscellaneous: フライト運用障害、今後のスケジュール情報、航空機所有者情報

Google Flights 通貨

ユーザーが特定の通貨で Google Flights の価格を希望する場合、--currency <ISO-4217-code> を使用します。デフォルト USD の動作の場合は省略します。

flight-goat-pp-cli flights MAN AGP 2026-05-10 --currency GBP --sort cheapest --agent
flight-goat-pp-cli dates JFK CDG --from 2026-07-01 --to 2026-07-31 --currency EUR --sort --agent
flight-goat-pp-cli compare SEA LHR 2026-06-15 --currency GBP --agent

このフラグは Google Flights 価格コマンド flights、dates、compare、gf-search、cheapest-longhaul にのみ有効です。AeroAPI または Kayak のみのコマンドには追加しないでください。

開発ツール

AeroAPI は OpenAPI Spec 3.0 を使用して定義されています。つまり、Postman などのツールに簡単にインポートできます。まず Postman の手順 を使用して API 仕様をインポートしてみてください。コレクションとしてインポートされたら、コレクションの Authorization タブの「Value」フィールドに入力して保存してから呼び出しを行う必要があります。

AeroAPI OpenAPI 仕様の場所:
https://flightaware.com/commercial/aeroapi/resources/aeroapi-openapi.yml

オープンソース AeroApps プロジェクト では、開始するのに役立つ小さなサービスとサンプルアプリケーションのコレクションを提供しています。

Flight Information Display System (FIDS) AeroApp は、複数の言語と Docker コンテナーを使用するマルチティアアプリケーションの例です。接続、データキャッシング、フライト表示、フライトマップの活用を実証しています。

Alerts AeroApp は、AeroAPI を使用して、Dockerized Python バックエンドと React フロントエンドを備えたサンプルアプリケーションでアラートを設定、編集、受信する方法を示しています。

AeroAPI プッシュ通知 テストインターフェース では、AeroAPI プッシュ経由でカスタマイズされたアラートの配信をテストする簡単で簡単な方法が提供されます。

コマンドリファレンス

aircraft — 航空機を管理

• flight-goat-pp-cli aircraft <type> — ICAO 航空機タイプ指定子文字列で指定された航空機タイプに関する情報を返します。返されるデータには以下が含まれます...

airports — 空港を管理

• flight-goat-pp-cli airports get — KLAX、KIAH、O07 などの ICAO またはLID 空港コードで指定された空港に関する情報を返します。返されるデータ...
• flight-goat-pp-cli airports get-all — 既知のすべての空港の ICAO 識別子を返します。ICAO 識別子を持たない空港の場合は FAA LID...
• flight-goat-pp-cli airports get-delays-for-all — 遅延がある空港のリストを返します。複数の理由がある場合、空港ごとに複数の理由が返される可能性があります...
• flight-goat-pp-cli airports get-nearby — 特定の位置から指定された距離内にある空港のリストを返します。

alerts — AeroAPI アラート機能は、主要なフライトイベントに関するリアルタイムアラートを設定および受信するために使用できます。アラートエンドポイントで提供されるカスタマイズ可能なアラート機能により、AeroAPI はユーザーが様々なタイプのイベント/フィルターをアラート対象として選択的に選択できるようにします。これにより、フライトプラン申請、フライト出発 (Out and Off)、フライト到着 (On and In) など、特にカスタマイズされたアラートを受け取ることができます!

アラート機能を開始するには、PUT /alerts/endpoint エンドポイントを最初に使用して、アラートが配信されるアカウント全体のデフォルト URL を設定する必要があります。このステップは、アラートを設定する前に実行される必要があり、特定の配信 URL が特定のアラートで指定されていない場合、すべてのアラートが送信されるフォールバック URL として機能します。これが POST /alerts エンドポイントとのインタラクション前に実行されない場合、400 エラーとエラーメッセージが表示されます。PUT /alerts/endpoint エンドポイント経由で URL が設定されたら、POST /alerts エンドポイントを使用してアラートを設定できます。GET /alerts エンドポイントを使用して、AeroAPI キーに関連付けられているすべて現在設定されているアラートを取得することもできます。 GET /alerts エンドポイントでは、関心のある特定のアラートの ID を簡単に取得でき、GET、PUT、DELETE /alerts/{id} エンドポイントを使用して特定のアラートを取得、更新、削除できます。

個別のアラートを設定する場合、target_url フィールドを PUT /alerts/endpoint 経由で設定されたアカウント全体のターゲットエンドポイントと異なる URL に設定できます。アラートで target_url フィールドが設定されている場合、その特定のアラートは、アカウント全体のデフォルトではなく、指定された target_url に配信されます。このフィールドがアラートに設定されていない場合、アラートはデフォルトのアカウント全体エンドポイントに配信されます。このフィールドを設定すると、異なるアラートが異なるエンドポイントで受け取られるように簡単にターゲット設定でき、アプリケーションごとのアラートを設定するか、運本環境のアラート設定を調整する必要なく代替開発環境にアラートを送信するのに役立ちます。

設定されたアラートごとに、アラート配信用に 1 対多の「イベント」を設定できます。ほとんどのイベントは 1 つのアラート配信となりますが、arrival と departure イベントの両方は複数のアラート配信 (バンドル化と呼ばれる) が発生する可能性があります。departure イベントは、出発 (実際に地上から離陸) アラート、フライトプラン申請アラート、および出発の変更 (30 分以上の重大な出発遅延、ゲート変更、空港遅延を含む可能性のある最大 5 つ) をバンドルします。FlightAware Global カスタマーは、出発バンドルの一部として Power on および Ready to taxi アラートも受け取ります。arrival イベントは、到着 (実際に地上に着陸) アラートと、識別された最大 5 つの経路中の変更 (30 分以上の遅延を含むが、迂回を除く) をバンドルします。FlightAware Global カスタマーは、arrival バンドルの一部として taxi stop 時刻も受け取ります。バンドル化されたタイプとバンドル化されていないタイプを On/Off に設定すると、イベントが重複する場合は単一のアラートのみになります。

アラート設定を変更する必要がある場合、一意のアラート識別子 (id) を使用して PUT /alerts/{id} エンドポイントでアラートを更新することは、追加のアラートを作成するよりも推奨されます。これにより、配信される重複アラートを回避でき、重複アラートが不要になった場合に不要なノイズが生じるのを防ぎます。

アラートを削除する必要がある場合、DELETE alerts/{id} エンドポイントを利用して、アラートが配信されないようにアラートを削除できます。リマインダーとして、特定のアラート ID は GET /alerts エンドポイントから取得できます。

• flight-goat-pp-cli alerts create — 新しい AeroAPI フライトアラートを作成します。アラートがトリガーされると、コールバック機構が使用され、通知が行われます...
• flight-goat-pp-cli alerts delete — 指定した ID の特定のアラートを削除
• flight-goat-pp-cli alerts delete-endpoint — 特定の URL で設定されていないアラートが POST される デフォルトのアカウント全体の URL を削除...
• flight-goat-pp-cli alerts get — 指定した ID のアラートの設定データを返します。
• flight-goat-pp-cli alerts get-all — FlightAware アカウント向けにすべての設定済みアラートを返します (これには他の手段で設定されたアラートが含まれます...
• flight-goat-pp-cli alerts get-endpoint — AeroAPI 経由で配信されるアラートに POST される URL を返します。
• flight-goat-pp-cli alerts set-endpoint — AeroAPI 経由で配信されるアラートに POST される デフォルト URL を更新します。これはアカウント全体を設定...
• flight-goat-pp-cli alerts update — 指定した ID のアラート設定を変更します。ターゲット URL アドレスが提供される場合、そのアラート...

disruption-counts — 運用障害カウントを管理

• flight-goat-pp-cli disruption-counts get — 特定の期間における特定の航空会社または空港のフライト欠航/遅延カウントを返します。
• flight-goat-pp-cli disruption-counts get-all — 特定の期間における全航空会社または全空港の全体的なフライト欠航/遅延カウントを返します。

flights — フライトを管理

• flight-goat-pp-cli flights get — 登録、識別、または fa_flight_id のフライト情報ステータスサマリーを返します。fa_flight_id が指定されている場合...
• flight-goat-pp-cli flights get-by-advanced-search — 地理空間検索パラメーターに基づいて、現在または最近飛行中のフライトを返します。クエリパラメーターには、...
• flight-goat-pp-cli flights get-by-position-search — 地理空間検索パラメーターに基づいてフライト位置を返します。これにより、これまでに存在したフライトを見つけることができます...
• flight-goat-pp-cli flights get-by-search — 地理空間データを含む様々なパラメーターと照合することにより、飛行中のフライトを検索します。簡略化された...を使用
• flight-goat-pp-cli flights get-count-by-search — 完全な検索クエリドキュメントは /flights/search エンドポイントで利用可能です。

foresight — Foresight エンドポイントは、FlightAware の Foresight 予測モデルと主要なイベントの予測へのアクセスを提供します。高度な機械学習 (ML) モデルは、フライトの主要な影響要因を特定し、将来のイベントをリアルタイムで予測し、前例のない洞察を提供して、運用効率を改善し、上空および地上での意思決定を容易にします。Foresight の力の詳細については、https://www.flightaware.com/commercial/foresight/ をご覧ください

これらのエンドポイントは各々、類似の機能を持つ非 Foresight 相当エンドポイントを反映していますが、すべての ML「予測」値が Foresight 応答に含まれるという追加があります。それぞれの非 Foresight エンドポイント応答には、「foresight_predictions_available」フラグが含まれており、必要に応じて Foresight 予測を取得して利用し、コストを管理するためのトリガーとして使用できます。Foresight は Premium ティアカスタマーのみが利用できます。 詳細情報、価格設定、アカウントの Foresight 有効化については、integrationsales@flightaware.com までお問い合わせください。

• flight-goat-pp-cli foresight get-flight-position-with — Foresight データを含む、フライトの現在位置を取得
• flight-goat-pp-cli foresight get-flight-with — 登録、識別、または fa_flight_id のフライト情報ステータスサマリーを返します (利用可能なすべての予測を含む...
• flight-goat-pp-cli foresight get-flights-by-advanced-search-with — 地理空間検索パラメーターに基づいて、現在または最近飛行中のフライトを返します。利用可能な場合、フライトの...

history — 過去を管理

• flight-goat-pp-cli history get-aircraft-last-flight — 登録で指定された航空機の最後の既知のフライトに対するフライト情報ステータスサマリーを返します。検索の上限...
• flight-goat-pp-cli history get-flight — 登録、識別、または fa_flight_id の過去のフライト情報ステータスサマリーを返します。fa_flight_id が...
• flight-goat-pp-cli history get-flight-map — 過去のフライトのトラックを Base64 エンコード画像として返します。画像には様々な追加データレイヤーが含まれる可能性があります...
• flight-goat-pp-cli history get-flight-route — 座標、名前、過去のフライトの経路に沿った修正の種類を含む情報を返します...
• flight-goat-pp-cli history get-flight-track — 過去のフライトのトラックを位置の配列として返します。データは現在から...

operators — オペレーターを管理

• flight-goat-pp-cli operators get — 名前、ICAO/IATA コード、本部所在地など、オペレーターの情報を返します。
• flight-goat-pp-cli operators get-all — オペレーター参照リスト (ICAO/IATA コードと詳細情報へのアクセス用 URL) を返します。

schedules — スケジュールを管理

• flight-goat-pp-cli schedules — 航空会社によって公開されたスケジュール済みフライトを返します。これらのスケジュールは最大 3 か月間利用可能...

適切なコマンドを見つける

何をしたいかはわかるが、どのコマンドがそれを実行するかわからない場合は、CLI に直接質問します:

flight-goat-pp-cli which "<あなた自身の言葉での機能>"

which は自然言語機能クエリをこの CLI のキュレーションされた機能インデックスからの最も一致するコマンドに解決します。終了コード 0 は少なくとも 1 つの一致を意味します。終了コード 2 は確信度の高い一致がないことを意味します — --help にフォールバックするか、より狭いクエリを使用します。

認証設定

環境変数経由で API キーを設定:

export FLIGHT_GOAT_API_KEY_AUTH="<your-key>"

または ~/.config/flight-goat-pp-cli/config.toml に保存します。

flight-goat-pp-cli doctor を実行してセットアップを確認します。

エージェントモード

任意のコマンドに --agent を追加します。以下に展開: --json --compact --no-input --no-color --yes

• パイプ可能 — JSON が stdout に、エラーが stderr に

• フィルター可能 — --select はフィールドのサブセットを保持します。ドット区切りパスはネストされた構造に下降します。配列は要素ごとにトラバース。詳細な API でコンテキストを小さく保つのに重要:

  flight-goat-pp-cli airports get mock-value --agent --select id,name,status
  

• プレビュー可能 — --dry-run は送信せずにリクエストを表示

• オフラインに対応 — 同期/検索コマンドは利用可能な場合、ローカル SQLite ストアを使用可能

• 非インタラクティブ — プロンプトを表示しない、すべての入力はフラグ

レスポンスエンベロープ

ローカルストアまたは API から読み込むコマンドは、provenance エンベロープに出力をラップします:

{
  "meta": {"source": "live" | "local", "synced_at": "...", "reason": "..."},
  "results": <data>
}

データの .results を解析し、.meta.source を解析して、ライブまたはローカルかを判定します。人間が読める N results (live) サマリーは、stdout がターミナルの場合のみ stderr に出力されます — パイプ/エージェントコンシューマーは stdout で純粋な JSON を取得します。

フライト予約 URL

flights からの各結果には、ワンタップ予約ハンドオフ用の booking_urls が含まれます:

{
  "booking_urls": {
    "primary": "https://www.delta.com/flightsearch/book-a-flight?...",
    "primary_kind": "prefill",
    "airline_url": "https://www.delta.com/flightsearch/book-a-flight?...",
    "airline_kind": "prefill",
    "google_url": "https://www.google.com/travel/flights/search?tfs=..."
  }
}

• primary は推奨される単一の URL です。1 回クリックすると、予約画面に移動します。
• primary_kind は、呼び出す内容を示します:
  • prefill — ルートと日付が事前に入力された航空会社フォーム。「<航空会社> で予約」としてレンダリング。
  • landing — 航空会社の予約ページ。ユーザーは日付を再入力する必要があるかもしれません。「<航空会社> 予約を開く」としてレンダリング。
  • search — ユーザーのクエリで実行された Google Flights 検索。「Google Flights で表示」としてレンダリング。
• airline_url と airline_kind は、行程が キュレーション テーブル (~35 のキャリア、internal/gflights/testdata/airline_url_captures.md を参照) の単一キャリアによって端から端まで操作される場合にのみ存在します。コードシェア行程と不明なキャリアはこれらを省略します。
• google_url は常に入力されます。

URL を 1 つだけレンダリングする場合は、primary をレンダリングし、primary_kind を使用して行動喚起のテキストを選択します。

エージェントフィードバック

この CLI について何か問題に気づいたとき (またはエージェントが気づいたとき)、記録します:

flight-goat-pp-cli feedback "the --since flag is inclusive but docs say exclusive"
flight-goat-pp-cli feedback --stdin < notes.txt
flight-goat-pp-cli feedback list --json --limit 10

エントリは ~/.flight-goat-pp-cli/feedback.jsonl に局所的に保存されます。FLIGHT_GOAT_FEEDBACK_ENDPOINT が設定されている場合 AND --send が渡されるか FLIGHT_GOAT_FEEDBACK_AUTO_SEND=true である場合を除き、POST されません。デフォルトの動作はローカルのみです。

バグレポートではなく、驚いた ことを書いてください。短く、具体的に、1 行: それが複合的な部分です。

出力配信

すべてのコマンドは --deliver <sink> を受け入れます。出力は stdout に加えて (または stdout の代わりに) 名前付きシンクに移動し、エージェントがハンド パイピングなしでコマンド結果をルーティングできます。3 つのシンクがサポートされます:

シンク	効果
stdout	デフォルト。stdout のみに書き込み
file:<path>	<path> に出力をアトミックに書き込み (tmp + 名前変更)
webhook:<url>	URL に出力本文を POST (application/json または --compact の場合 application/x-ndjson)

未知のスキームは、サポートされているセットに名前を付ける構造化エラーで拒否されます。Webhook エラーはゼロ以外を返し、URL + HTTP ステータスを stderr にログします。

名前付きプロファイル

プロファイルは、保存されたフラグ値のセットで、呼び出し全体で再利用されます。スケジュール済みエージェントが同じコマンドを同じ設定で毎回実行する場合に使用します - HeyGen の「Beacon」パターン。

flight-goat-pp-cli profile save briefing --json
flight-goat-pp-cli --profile briefing airports get mock-value
flight-goat-pp-cli profile list --json
flight-goat-pp-cli profile show briefing
flight-goat-pp-cli profile delete briefing --yes

明示的なフラグは常にプロファイル値より優先されます。プロファイル値がデフォルトより優先されます。agent-context は available_profiles の下にすべての利用可能なプロファイルをリストするため、内観エージェントは実行時にそれらを発見します。

終了コード

コード	意味
0	成功
2	使用方法エラー (不正な引数)
3	リソースが見つかりません
4	認証が必要
5	API エラー (上流の問題)
7	レート制限 (待機して再試行)
10	設定エラー

引数解析

$ARGUMENTS を解析:

1. 空、help、または --help → flight-goat-pp-cli --help 出力を表示
2. install で始まる → mcp で終わる → MCP インストール。それ以外の場合 → 上記の前提条件を参照
3. その他 → 直接使用 (CLI コマンドを --agent で実行)

MCP サーバーインストール

1. MCP サーバーをインストール:

   go install github.com/mvanhorn/printing-press-library/library/travel/flight-goat/cmd/flight-goat-pp-mcp@latest
   

2. Claude Code に登録:

   claude mcp add flight-goat-pp-mcp -- flight-goat-pp-mcp
   

3. 確認: claude mcp list

直接使用

1. インストール確認: which flight-goat-pp-cli 見つからない場合は、インストールの提供を検討 (このスキルの先頭の前提条件を参照)。
2. ユーザークエリを上記の一意の機能とコマンドリファレンスから最適なコマンドにマッチ。
3. --agent フラグで実行:

   flight-goat-pp-cli <command> [subcommand] [args] --agent
   

4. 曖昧な場合は、サブコマンドヘルプにドリルイン: flight-goat-pp-cli <command> --help。