<!-- GENERATED FILE — DO NOT EDIT. This file is a verbatim mirror of library/media-and-entertainment/movie-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/". -->

Movie Goat — Printing Press CLI

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

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

1. Printing Press インストーラーを使用してインストール:

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

2. 確認: movie-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/media-and-entertainment/movie-goat/cmd/movie-goat-pp-cli@latest

インストール後に --version が「command not found」と報告される場合、インストール手順がバイナリを $PATH に追加できなかったということです。確認が成功するまで、スキルコマンドを実行しないでください。

このCLI の使用時期

Movie Goat は、ストリーミング提供状況とマルチソース評価を組み合わせが必要な映画ファンの質問に答える必要があるエージェント用に使用します。今夜のおすすめシーン、フランチャイズマラソン計画、評価付きキャリアタイムラインに最適です。興行収入追跡、レビュー感情分析、またはプロットやレビューの LLM スタイルサマリーが必要なワークフローには適していません。

このCLI の使用時期ではない場合

作成、更新、削除、公開、コメント、アップロード、招待、注文、メッセージ送信、予約、購入、またはリモート状態変更が必要なリクエストに対しては、このCLI をアクティブ化しないでください。このプリント CLI は、検査、エクスポート、同期、分析のための読み取り専用コマンドを公開しています。

独自の機能

これらの機能は、このAPI用の他のツールでは利用できません。

映画ファンのお気に入り

• tonight — あなたが使用しているサービスでストリーミング中のトレンドタイトルから今晩見るものを選びます。

  エージェントが TMDb/RT/JustWatch でタブをバウンドするのを置き換える、ストリーミングでフィルターされたショートリストが必要な場合に使用します。

  movie-goat-pp-cli tonight --mood thriller --max-runtime 120 --providers netflix,max --region US --json
  

• ratings — TMDb + IMDb + Rotten Tomatoes + Metacritic の評価を1つのカードで任意のタイトル用に表示します。

  エージェントがタイトルの標準的なマルチソース評価が必要な場合に使用します。OMDB_API_KEY が設定されていない場合、TMDb のみに自動的に切り替わります。

  movie-goat-pp-cli ratings 550 --json
  

• marathon — 視聴順序、合計ランタイム、推奨休憩時間を含むフランチャイズマラソンを計画します。

  イベント視聴を計画する際に使用します。エージェントはスケジュールをグループと共有するために ダンプできます。

  movie-goat-pp-cli marathon "The Avengers" --order release --breaks-every 240 --json
  

• career — 俳優または監督の完全なフィルモグラフィを評価と年代順で探索します。

  エージェントが評価付きの年代順フィルモグラフィが必要な場合に使用します。フラットな IMDb リストをクロスソース評価に置き換えます。

  movie-goat-pp-cli career "Christopher Nolan" --since 2010 --role director --json
  

• versus — 評価、キャスト、ランタイム、ストリーミング配信を含む2つのムービーまたはショーを左右比較します。

  エージェントが2つの最終候補から選ぶ必要がある場合に使用します。1つのコマンドですべての軸でどう異なるかを表示します。

  movie-goat-pp-cli versus 550 27205 --region US --json
  

• collaborators — その人のクレジット内で2件以上登場する人物をカウントとタイトル付きでリストアップします。

  エージェントが映画製作者の人間関係を研究している場合に使用します。定期的な撮影監督/作曲家/俳優を機械的に表示します。

  movie-goat-pp-cli collaborators "Christopher Nolan" --min-count 3 --role crew --json
  

ローカル状態の蓄積

• watchlist list — ローカル SQLite ウォッチリスト。あなたが使用しているサービスでストリーミング可能な行にフラグを立てます。

  毎週使用して、保存されたリストからストリーミング可能なアイテムを表示します。タイトルごとのアドホック JustWatch チェックを不要にします。

  movie-goat-pp-cli watchlist list --available --providers netflix,max --region US --json
  

• queue — ウォッチリストの推奨と類似から得られた次の視聴候補を提案します。

  エージェントが保存された興味から得られた新しいキューが必要な場合に使用します。ローカル状態と API 推奨を組み合わせます。

  movie-goat-pp-cli queue --limit 20 --providers netflix,max --region US --json
  

コマンド リファレンス

discover — リッチなフィルターを使用してムービーと TV ショーを発見

• movie-goat-pp-cli discover movies — ジャンル、年、評価、証明書、キャスト、クルー、ストリーミングプロバイダーなどでムービーを発見
• movie-goat-pp-cli discover tv — ジャンル、年、評価、ネットワーク、ストリーミングプロバイダーで TV ショーを発見

genres — ムービーと TV のジャンルリストを取得

• movie-goat-pp-cli genres movies — ムービージャンルのリストを取得
• movie-goat-pp-cli genres tv — TV ジャンルのリストを取得

movies — ムービーを検索および閲覧

• movie-goat-pp-cli movies get — キャスト、評価、ストリーミング提供状況を含むムービーの詳細情報を取得
• movie-goat-pp-cli movies now-playing — 現在上映中のムービーを取得
• movie-goat-pp-cli movies popular — 現在人気のムービーを取得
• movie-goat-pp-cli movies search — タイトルでムービーを検索
• movie-goat-pp-cli movies top-rated — 最高評価ムービーを取得
• movie-goat-pp-cli movies upcoming — 近日公開予定のムービーを取得

multi — ムービー、TV ショー、人物全体でマルチ検索

• movie-goat-pp-cli multi <query> — 1つのクエリでムービー、TV ショー、人物を検索

people — 人物(俳優、監督、クルー)を検索および閲覧

• movie-goat-pp-cli people get — フィルモグラフィを含む人物の詳細情報を取得
• movie-goat-pp-cli people popular — エンターテイメント業界で人気のある人物を取得
• movie-goat-pp-cli people search — 名前で人物を検索

trending — トレンドのムービー、TV ショー、人物を取得

• movie-goat-pp-cli trending all — トレンドのムービー、TV、人物を取得
• movie-goat-pp-cli trending movies — トレンドのムービーを取得
• movie-goat-pp-cli trending people — トレンドの人物を取得
• movie-goat-pp-cli trending tv — トレンドの TV ショーを取得

tv — TV ショーを検索および閲覧

• movie-goat-pp-cli tv airing-today — 本日放送されるエピソードがある TV ショーを取得
• movie-goat-pp-cli tv get — TV ショーの詳細情報を取得
• movie-goat-pp-cli tv on-the-air — 現在放送中の TV ショーを取得
• movie-goat-pp-cli tv popular — 現在人気のある TV ショーを取得
• movie-goat-pp-cli tv search — タイトルで TV ショーを検索
• movie-goat-pp-cli tv top-rated — 最高評価の TV ショーを取得

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

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

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

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

レシピ

今晩、高評価で、私のサービス上

movie-goat-pp-cli tonight --mood drama --max-runtime 130 --providers netflix,max,prime --region US --agent --select "results.title,results.year,results.rating,results.providers"

エージェントが決断するために必要な高重要度フィールドのみを持つストリーミングでフィルターされたショートリスト。

ウォッチリストスイープ

movie-goat-pp-cli watchlist list --available --providers netflix,max --region US --agent

毎週のチェック: 保存されたタイトルの中で、私が所持しているサービスでストリーミング可能になったもの。

評価付きキャリアの深掘り

movie-goat-pp-cli career "Lynne Ramsay" --role director --agent --select "credits.title,credits.year,credits.rating_imdb,credits.rating_rt"

エージェントが制限された年代順フィルモグラフィと、重要なクロスソース評価列。

2つの最終候補から選択

movie-goat-pp-cli versus 27205 87108 --region US --agent

Inception vs. Tenet の揃った比較カード。評価、ランタイム、キャストのオーバーラップ、プロバイダー。

フランチャイズナイトを計画

movie-goat-pp-cli marathon "Mission: Impossible" --order release --breaks-every 240 --agent

順序付きウォッチリスト、合計ランタイム、休憩の提案。

認証設定

TMDb v3 API キー (無料、https://www.themoviedb.org/settings/api) は必須で、TMDB_API_KEY に入ります — Bearer ヘッダーではなく、クエリパラメータとして使用されます。OMDb キー (無料、http://www.omdbapi.com/apikey.aspx) はオプションで、OMDB_API_KEY に入ります。これがないと、ratings および versus は TMDb のみを表示し、IMDb/RT/Metacritic 列を自動的に除外します。

セットアップを確認するには movie-goat-pp-cli doctor を実行します。

エージェントモード

任意のコマンドに --agent を追加します。次のように展開されます: --json --compact --no-input --no-color --yes.

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

• フィルタリング可能 — --select は フィールドのサブセットを保持します。ドット表記法はネストされた構造を下降します。配列は要素ごとに走査します。冗長な API のコンテキストを小さく保つために重要です:

  movie-goat-pp-cli movies get mock-value --agent --select id,name,status
  

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

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

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

• 読み取り専用 — create、update、delete、publish、comment、upvote、invite、order、send、またはその他の変更リクエストにはこのCLI を使用しないでください

レスポンスエンベロープ

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

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

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

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

このCLI について何かおかしいことに気付いた場合は (またはエージェントが気付いた場合)、記録します:

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

エントリはローカルに ~/.movie-goat-pp-cli/feedback.jsonl に格納されます。MOVIE_GOAT_FEEDBACK_ENDPOINT が設定されている AND --send が渡されている OR MOVIE_GOAT_FEEDBACK_AUTO_SEND=true である場合にのみ POST されます。デフォルトの動作はローカルのみです。

バグ報告ではなく、あなたを 驚かせた ことを書いてください。短く、具体的に、1行: それが複合することの一部です。

出力配信

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

シンク	効果
stdout	デフォルト。stdout にのみ書き込み
file:<path>	<path> に原子的に出力を書き込み (tmp + rename)
webhook:<url>	出力ボディを URL に POST (application/json または --compact の場合 application/x-ndjson)

不明なスキームはサポートされているセットを命名する構造化エラーで拒否されます。Webhook 失敗は 0 以外を返し、URL + HTTP ステータスを stderr にログします。

名前付きプロファイル

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

movie-goat-pp-cli profile save briefing --json
movie-goat-pp-cli --profile briefing movies get mock-value
movie-goat-pp-cli profile list --json
movie-goat-pp-cli profile show briefing
movie-goat-pp-cli profile delete briefing --yes

明示的なフラグは常にプロファイル値を上書きします。プロファイル値はデフォルト値を上書きします。agent-context は available_profiles の下にすべて利用可能なプロファイルをリストアップするため、内部検査エージェントは実行時にそれらを検出します。

終了コード

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

引数解析

$ARGUMENTS を解析:

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

MCP サーバーインストール

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

   go install github.com/mvanhorn/printing-press-library/library/media-and-entertainment/movie-goat/cmd/movie-goat-pp-mcp@latest
   

2. Claude Code に登録:

   claude mcp add -e TMDB_API_KEY=<your-tmdb-key> -e OMDB_API_KEY=<your-omdb-key> movie-goat-pp-mcp -- movie-goat-pp-mcp
   

   OMDB_API_KEY はオプションですが、ratings、versus、career で IMDb、Rotten Tomatoes、Metacritic のエンリッチメントを有効にします。
3. 確認: claude mcp list

直接使用

1. インストール状況を確認: which movie-goat-pp-cli 見つからない場合は、インストールを提供します (このスキルの上部にある前提条件を参照)。
2. ユーザークエリを上記の「独自の機能」およ「コマンドリファレンス」から最適なコマンドにマッチします。
3. --agent フラグで実行:

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

4. あいまいな場合は、サブコマンドヘルプを詳しく調べます: movie-goat-pp-cli <command> --help.