pp-ufo-goat

War.gov UFO — Printing Press CLI

前提条件：CLI をインストールする

このスキルでは ufo-goat-pp-cli バイナリを使用します。**このスキルのコマンドを実行する前に、CLI がインストールされていることを必ず確認してください。**見つからない場合は、先にインストールしてください。

1. Printing Press インストーラーを使用してインストールします。デフォルトのバイナリ保存先は、macOS/Linux では $HOME/.local/bin、Windows では %LOCALAPPDATA%\Programs\PrintingPress\bin です。

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

2. 確認します：ufo-goat-pp-cli --version
3. インストール先のディレクトリが、このスキルを実行するエージェント／ランタイムの $PATH に含まれていることを確認します。

npx によるインストールに失敗した場合（Node がない、オフラインなど）は、Go を直接インストールしてください（Go 1.26.3 以降が必要です）。

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

インストール後に --version で「command not found」と表示される場合、ランタイムからバイナリのディレクトリを $PATH 経由で参照できていません。確認が成功するまで、スキルのコマンドを実行しないでください。

この CLI を使用する場面

War.gov PURSUE アーカイブから機密解除された UAP ファイルを閲覧、検索、ダウンロードする場合に、この CLI を使用してください。新規公開情報を追跡する研究者、特定の事件を調査するジャーナリスト、政府の UFO データに構造化された方法でアクセスする必要があるエージェントに最適です。

この CLI を使用しない場面

作成、更新、削除、公開、コメント、賛成票の投票、招待、注文、メッセージの送信、予約、購入、またはリモートの状態変更が必要なリクエストでは、この CLI を有効にしないでください。この印刷用 CLI は、調査、エクスポート、同期、分析のための読み取り専用コマンドを提供します。

独自の機能

この API の他のツールでは利用できない機能です。

蓄積されるローカル状態

• sync — 政府による継続的な公開に合わせて、新しいファイルの一括分を自動検出し、取得します

  PURSUE の公開スケジュールを監視するエージェントは、手動で確認しなくても新しいファイルの通知を受け取れます

  ufo-goat-pp-cli sync
  

• new — 前回の同期以降に追加されたファイルを正確に確認できます。継続的な公開に対する「見逃したものを確認する」コマンドです

  アーカイブ全体を再スキャンせずに、新たに機密解除されたファイルを確認する必要がある場合に、エージェントが使用します

  ufo-goat-pp-cli new --since 7d
  

複数機関にまたがるインテリジェンス

• timeline — 4 つすべての機関を対象に、1944～2025 年の事件の時系列を表示します

  研究者は全体像を把握できます。1947 年の FBI の事件を、2024 年の DoW の任務報告と並べて確認できます

  ufo-goat-pp-cli timeline --after 1960 --before 1970
  

• pairs — 動画と PDF の組み合わせを検索し、動画に付随する文書や、その逆を研究者が見つけられるようにします

  41 本の動画には対応する文書があります。このコマンドで関連付けをすぐに確認できます

  ufo-goat-pp-cli pairs --agent
  

• agencies — 各機関の提供内容を、ファイル数、種類、対象期間、収録状況の分析とともに確認できます

  「FBI、NASA、DoW はそれぞれ何を公開したのか」という疑問にすばやく答えられます

  ufo-goat-pp-cli agencies --json --select name,file_count,types
  

• locations — 地図作成や空間分析のために、地理的位置ごとに事件を集計します

  米国西部に 25 件、シリアに 12 件、月に 9 件。集計から空間的なパターンが見えてきます

  ufo-goat-pp-cli locations --json
  

エージェント向けの基盤機能

• download — 2.3 GB のアーカイブのファイルを、再開、検証、進捗追跡に対応してダウンロードします

  アーカイブには PDF だけで 2.3 GB あるため、エージェントには状態を追跡できる信頼性の高い一括ダウンロードが必要です

  ufo-goat-pp-cli download --agency FBI --resume
  

コマンドリファレンス

agencies — PURSUE の公開に貢献した政府機関

• ufo-goat-pp-cli agencies — ファイル数とともに、貢献したすべての機関を一覧表示します

files — FBI、DoD、NASA、国務省が公開した機密解除済み UAP ファイル（PDF、動画、画像）

• ufo-goat-pp-cli files get — 指定したファイルの詳細を取得します
• ufo-goat-pp-cli files list — 機密解除済み UAP ファイルをすべて一覧表示します
• ufo-goat-pp-cli files search — ファイルのタイトル、説明、場所を全文検索します

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

実行したいことは分かっていても、どのコマンドを使えばよいか分からない場合は、CLI に直接尋ねてください。

ufo-goat-pp-cli which "<capability in your own words>"

which は、自然言語による機能の問い合わせを、この CLI の厳選された機能インデックスから最も適したコマンドに対応付けます。終了コード 0 は少なくとも 1 件一致したことを示し、終了コード 2 は信頼できる一致がなかったことを示します。その場合は --help に切り替えるか、より絞り込んだ問い合わせを使用してください。

レシピ

Moon のインシデントをすべて検索する

ufo-goat-pp-cli files list --location Moon --json --select title,agency,incident_date

NASA のファイルから、アポロ計画時代の月面 UAP 観測情報を表示します。

FBI のファイルをすべてダウンロードする

ufo-goat-pp-cli download --agency FBI --resume

56 件の FBI 提供資料を、再開機能付きで一括ダウンロードします。

1960 年代の省庁横断タイムライン

ufo-goat-pp-cli timeline --after 1960 --before 1970 --agent

UFO の目撃が最も多かった時代に、すべての機関で発生したインシデントを確認します。

動画と文書のペアを見つける

ufo-goat-pp-cli pairs --json --select video_title,pdf_title,agency

PDF レポートが付属している動画を確認します。

新しいリリースを追跡する

ufo-goat-pp-cli sync && ufo-goat-pp-cli new

最新のマニフェストを取得し、前回の確認以降に追加された内容を確認します。

認証の設定

認証は不要です。

ufo-goat-pp-cli doctor を実行して設定を確認してください。

エージェントモード

任意のコマンドに --agent を追加します。次のオプションに展開されます：--json --compact --no-input --no-color --yes。

• パイプ可能 — 標準出力に JSON を、標準エラー出力にエラーを出力します。

• フィルター可能 — --select でフィールドの一部だけを残せます。ドット区切りのパスでネストされた構造をたどり、配列では各要素をたどります。大量のデータを返す API でコンテキストを小さく保つのに不可欠です。

  ufo-goat-pp-cli agencies --agent --select id,name,status
  

• プレビュー可能 — --dry-run で、送信せずにリクエストを表示します。

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

• 非対話型 — プロンプトは表示せず、すべての入力をフラグで指定します。

• 読み取り専用 — 作成、更新、削除、公開、コメント、賛成票、招待、注文、送信など、状態を変更するリクエストにはこの CLI を使用しないでください。

レスポンスのエンベロープ

ローカルストアまたは API から読み取るコマンドは、出力を出典情報のエンベロープでラップします。

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

データには .results を解析し、ライブデータかローカルデータかを確認するには .meta.source を参照してください。人間が読みやすい N results (live) の概要は、標準出力が端末の場合にのみ標準エラー出力へ表示されます。パイプやエージェントの利用者には、標準出力に JSON のみが渡されます。

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

あなた（またはエージェント）がこの CLI に気になる点を見つけたら、記録してください。

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

エントリーは ~/.ufo-goat-pp-cli/feedback.jsonl にローカル保存されます。UFO_FEEDBACK_ENDPOINT が設定され、かつ --send が渡されるか、UFO_FEEDBACK_AUTO_SEND=true が設定されている場合を除き、POST されることはありません。デフォルトの動作はローカル保存のみです。

バグ報告ではなく、意外だったことを記録してください。短く、具体的に、1 行で書いてください。そうすることで効果が積み重なっていきます。

出力の配信

すべてのコマンドで --deliver <sink> を使用できます。出力は標準出力に加えて（または標準出力の代わりに）、指定したシンクへ送られます。そのため、エージェントは手動でパイプをつなぐことなく、コマンド結果を振り分けられます。利用できるシンクは 3 つです。

シンク	動作
stdout	デフォルト。標準出力のみに書き込みます
file:<path>	出力を <path> にアトミックに書き込みます（tmp + rename）
webhook:<url>	出力本文を URL に POST します（--compact の場合は application/json または application/x-ndjson）

不明なスキームは、対応している選択肢を示す構造化エラーとともに拒否されます。Webhook の失敗時はゼロ以外の終了コードを返し、URL と HTTP ステータスを標準エラー出力に記録します。

名前付きプロファイル

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

ufo-goat-pp-cli profile save briefing --json
ufo-goat-pp-cli --profile briefing agencies
ufo-goat-pp-cli profile list --json
ufo-goat-pp-cli profile show briefing
ufo-goat-pp-cli profile delete briefing --yes

明示的に指定されたフラグは常にプロファイル値より優先され、プロファイル値はデフォルト値より優先されます。agent-context は、利用可能なすべてのプロファイルを available_profiles に一覧表示するため、情報を調べるエージェントは実行時にプロファイルを検出できます。

終了コード

コード	意味
0	成功
2	使用方法のエラー（引数が誤っています）
3	リソースが見つかりません
5	API エラー（上流の問題）
7	レート制限中（待ってから再試行してください）
10	設定エラー

引数の解析

$ARGUMENTS を解析します：

1. 空、help、または --help → ufo-goat-pp-cli --help の出力を表示します
2. install で始まる → mcp で終わる場合 → MCP のインストール。それ以外の場合 → 上記の前提条件を確認します
3. それ以外 → 直接使用（--agent を付けて CLI コマンドとして実行します）

MCP サーバーのインストール

1. MCP サーバーをインストールします：

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

2. Claude Code に登録します：

   claude mcp add ufo-goat-pp-mcp -- ufo-goat-pp-mcp
   

3. 確認します：claude mcp list

直接使用

1. インストール済みか確認します：which ufo-goat-pp-cli 見つからない場合は、インストールを提案します（このスキルの冒頭にある前提条件を参照してください）。
2. ユーザーのクエリに最適なコマンドを、上記の独自の機能とコマンドリファレンスから選びます。
3. --agent フラグを付けて実行します：

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

4. あいまいな場合は、サブコマンドのヘルプを確認します：ufo-goat-pp-cli <command> --help。