pp-autotempest

AutoTempest — Printing Press CLI

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

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

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

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

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

npx によるインストールに失敗した場合（Node がない、オフラインなど）は、Go を直接インストールしてください（Go 1.26.6 以降が必要です）。インストール先は $GOPATH/bin（既定値は $HOME/go/bin）なので、代わりにそのディレクトリを $PATH に追加してください。

go install github.com/mvanhorn/printing-press-library/library/commerce/autotempest/cmd/autotempest-pp-cli@latest

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

AutoTempest は、主要な中古車マーケットプレイスをすでにひとつの検索に統合していますが、利用できるのはブラウザーだけです。この CLI は同じ統合検索をプレーン HTTP 経由で実行し、出品情報をローカルの SQLite ストアに保存して、複数のソースに掲載された同一 VIN を重複排除し、価格の下落を経時的に追跡します。drops、dedupe、deal、spread などのコマンドを使うと、単発の閲覧を、購入希望者やエージェント向けの検索可能で蓄積されていく自動車検索データに変えられます。

この CLI を使用する場面

ターミナルまたはエージェントから、すべての AutoTempest ソースにわたって中古車の出品情報を検索し、ローカルに保存して、ウェブサイトでは答えられない質問に回答するには、この CLI を使用してください。価格が下がった車、どのソースが同じ VIN を最安値で掲載しているか、比較可能な車と比べて価格が妥当かどうかを確認できます。エージェントが定期的にポーリングする検索や、車両データを JSON として後続のワークフローに渡す用途に最適です。

使用しない場面

次の用途にはこの CLI を使用しないでください。

• 車の購入、入札、融資、販売者への連絡には使用しないでください。読み取り専用の自動車検索です。
• 新車のメーカー希望小売価格やディーラーの請求価格の調査には使用しないでください。既存の中古車の出品情報のみを表示します。
• VIN 履歴や事故レポートの確認には使用しないでください。Carfax のような記録ではなく、出品情報を報告します。

独自の機能

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

蓄積されるローカル状態

• drops — 以前の検索または監視の実行後に価格が下がった出品情報を、値下がり幅の大きい順に表示します。

  エージェントや購入希望者が、新着情報ではなく価格の経時的な変動を知りたい場合に使用します。

  autotempest-pp-cli drops "civic-fl" --since 7d --min-drop 500 --agent
  

• watch — フィルターを指定して名前付きの検索を登録し、run で再実行できるようにします。これにより、drops と diff が比較に使用するスナップショットを作成します。

  エージェントが定期的にポーリングする検索を設定する場合に使用します。単発のクエリには search を使用してください。

  autotempest-pp-cli watch run --agent
  

ソース横断の情報

• dedupe — 複数のマーケットプレイスに掲載された同一の車両の VIN をひとつの行にまとめ、すべてのソースと価格を最安値順に表示します。

  同じ車が eBay、Cars.com、ディーラーのフィードに掲載されており、その VIN の車をどのソースで最安値で買えるか知りたい場合に使用します。

  autotempest-pp-cli dedupe --select vin,min_price,sources.source,sources.price --agent
  

• deal — ローカルストアにある比較可能な車（同じモデル、年式、走行距離帯）の中央値との差に基づいて、出品情報を価格順にランク付けします。

  「この価格は比較可能な車と比べて本当にお得か」という疑問に、主観ではなく数値で答える場合に使用します。

  autotempest-pp-cli deal "Camry" --select title,price,deal_score --agent
  

• spread — モデルごとにマーケットプレイス別の最低価格、中央値、最高価格を報告し、どのソースの価格が安いか高いかを確認できます。

  特定のモデルをどのマーケットプレイスで探すか決める場合に使用します。

  autotempest-pp-cli spread "F-150" --agent
  

• auctions — 現在の入札額と入札数を含む eBay オークションの出品情報に絞り込み、入札額順に並べ替えます。

  固定価格の在庫ではなく、オークションの出品を探す場合に使用します。

  autotempest-pp-cli auctions --select title,current_bid,bids,url --agent
  

コマンドリファレンス

makes — AutoTempest が認識している車両メーカーを一覧表示します（スラッグ＋表示名）。

• autotempest-pp-cli makes — メーカーを一覧表示します。返されたスラッグ（例：'honda'）を、find の --make 値として使用します。

models — 指定したメーカーのモデルを一覧表示します（スラッグ＋表示名＋年式の範囲）。

• autotempest-pp-cli models <make> — 指定したメーカーのモデルを一覧表示します。メーカーのスラッグ（例：'honda'）を渡します。返されたモデルのスラッグを、find の --model として使用します。

sources — AutoTempest の検索ソースとその種類を一覧表示します。

• autotempest-pp-cli sources — ソースは 2 種類あります。inline ソース（te、hem、cs、cv、cm、eb、ot）は、解析済みの車両ごとの掲載情報を返します。link ソース（fbm = Facebook Marketplace、st = SearchTempest / Craigslist）は、スクレイピングがブロックされるかログインが必要なサイトのため、比較リンクのみを返します。find はデフォルトで 7 つの inline ソースを使用します。comparison_links 配列に比較 URL も含めるには、--sites fbm,st を渡します。

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

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

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

which は自然言語による機能の問い合わせを、この CLI の厳選された機能インデックスから最適なコマンドに対応付けます。終了コード 0 は少なくとも 1 つ一致したことを示します。終了コード 2 は確かな一致がなかったことを示すため、--help を使うか、より範囲を絞った問い合わせをしてください。

レシピ

近隣で予算内のクリーンタイトル付き AWD 車を探す

autotempest-pp-cli find "subaru outback" --zip 33701 --radius 150 --max-price 28000 --title clean --drive awd --json --select title,price_cents,mileage,location,sitecode

--select を使って、深くネストされた複数ソースのライブ結果から、重要なフィールドに絞り込みます。

特定の VIN で最も安い販売元を探す

autotempest-pp-cli dedupe --select vin,min_price,sources.source,sources.price --json

各実車を 1 回だけ表示し、掲載されているすべてのマーケットプレイスと価格を示します。

今週値下がりした車を調べる

autotempest-pp-cli drops "my-search" --since 7d --min-drop 500 --json

地域ごとの価格スナップショットを比較して、売却意欲の高い販売者を見つけます。

この価格は妥当か

autotempest-pp-cli deal "tacoma" --select title,price,deal_score --json

各掲載情報の価格を、ストア内の類似車両の中央値と比較して評価します。

認証の設定

認証は必要ありません。

autotempest-pp-cli doctor を実行して、セットアップを確認してください。

エージェントモード

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

• パイプ対応 — 標準出力に JSON、標準エラー出力にエラーを出力します

• フィルター可能 — --select でフィールドを絞り込めます。ドット区切りのパスはネストした構造をたどり、配列は各要素を走査します。冗長な API でコンテキストを小さく保つうえで重要です。

  autotempest-pp-cli makes --agent --select id,name,status
  

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

• オフラインでも使いやすい — find/sync コマンドは、利用可能な場合にローカルの SQLite ストアを使用できます

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

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

レスポンスエンベロープ

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

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

データには .results を解析し、ライブデータかローカルデータかを確認するには .meta.source を参照してください。人が読みやすい N results (live) という概要は、標準出力がターミナルで、かつ機械可読形式のフラグ（--json、--csv、--compact、--quiet、--plain、--select）が設定されていない場合に限り、標準エラー出力に表示されます。パイプやエージェント経由での利用、および明示的に形式を指定した実行では、標準出力に JSON のみが出力されます。

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

あなた（またはエージェント）がこの CLI に違和感を覚えたら、記録してください。

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

記録はローカルの ~/.local/share/autotempest-pp-cli/feedback.jsonl に保存されます。AUTOTEMPEST_FEEDBACK_ENDPOINT が設定されており、さらに --send が渡されるか AUTOTEMPEST_FEEDBACK_AUTO_SEND=true が設定されない限り、POST されることはありません。デフォルトの動作はローカル保存のみです。

バグ報告ではなく、意外に感じたことを書いてください。簡潔で具体的な 1 行にします。積み重ねるべきなのは、そこです。

出力の配信

すべてのコマンドで--deliver <sink>を指定できます。出力は、標準出力に加えて（または標準出力の代わりに）指定したシンクに送られるため、エージェントはコマンドの結果を手動でパイプ処理せずに振り分けられます。次の3つのシンクがサポートされています。

シンク	効果
stdout	デフォルト。標準出力にのみ書き込みます
file:<path>	出力を<path>にアトミックに書き込みます（一時ファイルを作成してリネーム）
webhook:<url>	出力本文をURLにPOSTします（--compactの場合はapplication/jsonまたはapplication/x-ndjson）

不明なスキームは、サポート対象の一覧を示す構造化エラーとともに拒否されます。Webhookの失敗時はゼロ以外の値を返し、URLとHTTPステータスを標準エラーに記録します。

名前付きプロファイル

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

autotempest-pp-cli profile save briefing --json
autotempest-pp-cli --profile briefing makes
autotempest-pp-cli profile list --json
autotempest-pp-cli profile show briefing
autotempest-pp-cli profile delete briefing --yes

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

終了コード

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

引数の解析

$ARGUMENTSを解析します。

1. 空、help、または--help → autotempest-pp-cli --helpの出力を表示します
2. installで始まる場合 → mcpで終わる場合はMCPのインストール、それ以外は上記の前提条件を参照してください
3. それ以外 → 直接使用（--agentを指定してCLIコマンドとして実行）

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

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

   go install github.com/mvanhorn/printing-press-library/library/commerce/autotempest/cmd/autotempest-pp-mcp@latest
   

2. Claude Codeに登録します。

   claude mcp add autotempest-pp-mcp -- autotempest-pp-mcp
   

3. 確認します：claude mcp list

直接使用

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

   autotempest-pp-cli <command> [subcommand] [args] --agent
   

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