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

ESPN — Printing Press CLI

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

このスキルは espn-pp-cli バイナリを操作します。このスキルのコマンドを実行する前に、CLI がインストールされていることを確認する必要があります。 インストールされていない場合は、まず以下の手順でインストールしてください:

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

   npx -y @mvanhorn/printing-press install espn --cli-only
   

2. 確認: espn-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/espn/cmd/espn-pp-cli@latest

インストール後に --version が「command not found」と表示される場合、インストール手順でバイナリが $PATH に配置されていません。確認が成功するまで、スキルコマンドを実行しないでください。

このCLI をいつ使うか

ユーザーが現在のスコア、順位表、今後のスケジュール、ヘッドツーヘッドの記録、またはゲームごとの充実したサマリー (ボックススコア、リーダー、スコアリングプレー、オッズ、勝利確率) を求めている場合に使用してください。また、交叉リーグの発見 (today) やシンクロされたデータのオフライン検索にも適しています。

Stats Perform や Sportradar のような有料フィードを使用している場合、またはユーザーが real-time ウェブソケット更新 (ESPN のエンドポイントはポーリングのみ) が必要な場合は、このスキルは使用しないでください。ベッティングオッズのみの場合、ゲームごとの summary ペイロードにはそれらが含まれていますが、リーグ全体のオッズコマンドはありません。

独特な機能

ローカルシンク + クロスリーグツーリングのためだけに動作するコマンド。

クロスリーグの発見

• today — すべてのメジャースポーツの本日のスコアを 1 つの呼び出しで取得。スポーツを選択する前に「今夜何があるのか」を知る最速の方法。

• trending — 現在の人気度でランク付けされた全リーグの最もフォローされているアスリートとチーム。スポーツを指定せずに「誰がホットなのか」を知るのに適しています。

• dashboard — ~/.config/espn-pp-cli/config.toml から [favorites] を読み込み、1 つの呼び出しでお気に入りのチームのスコアをすべてのリーグで表示します。

• watch <sport> <league> --event <game_id> — 特定のゲームのライブスコア更新 (30 秒ごとにポーリング)。scores または today を使用してゲームを見つけ、watch でリアルタイムで追跡します。

ゲーム状態インテリジェンス

• summary <sport> <league> --event <game_id> — ボックススコア、リーダー、スコアリングプレー、オッズ、勝利確率を含む詳細なゲームサマリー。ゲームごとの最も充実したペイロード。

• boxscore <event_id> — イベント ID のプレーヤーごとのボックススコアのみで、スポーツとリーグは最近のスコアボードキャッシュヒットから推測されます。--sport/--league を渡して推測をスキップします。

• plays <sport> <league> --event <id> — 特定のイベントのプレーバイプレーフィード。オプションの --limit (デフォルト 200)。

• recap <sport> <league> — ボックススコアとリーダーを含むポストゲームリキャップで、リーグの最後に完了したゲーム。

• scoreboard <sport> <league> — 日付フィルタリング、週/グループセレクター、競技メタデータを含むライブスコアボード。

• odds <sport> <league> — スプレッド、オーバー/アンダー、および今夜のスレートのマネーラインで、スコアボードペイロードから派生 (ゲームごとのサマリーコールなし)。

順位表とランキング

• standings <sport> <league> — カンファレンス/ディビジョン順位表。

• rankings <sport> <league> — 現在の AP、Coaches、CFP ポーランキング (NCAAF/NCAAM)。

• streak <sport> <league> — シンク済みデータから計算されたリーグ全体のチームの現在の連勝/連敗。

• rivals <sport> <league> — シンク済みデータからのリーグ内のチーム間のヘッドツーヘッドレコード。

• h2h <team1> <team2> --sport <s> --league <l> — 平均スコアと最近の対戦リストを含む、特定のペアのより詳細なヘッドツーヘッド。

• sos <sport> <league> — スタンディングペイロードから派生したチームごとのスケジュール難度で、降順でソートされます。

人物情報

• leaders <sport> <league> [--category <name>] — オプションのフィルタを備えたカテゴリ全体の統計リーダー。

• compare <athlete1> <athlete2> --sport <s> --league <l> — 2 人のアスリートのサイドバイサイドシーズン統計。曖昧な名前は候補をリストしてコード 2 で終了します。

• injuries <sport> <league> — リーグ全体の現在の傷害レポート (チーム別にグループ化)。

• transactions <sport> <league> — 最近のトレード、署名、ウェーバー。

ローカルストア

• sync — スポーツ+リーグデータセットをローカル SQLite にプルしてオフライン分析を行います。

• search "<query>" — シンク済みイベントおよびニュースの全文検索。

• sql <query> — ローカルデータベースに対して読み取り専用 SQL クエリを実行します。

コマンド リファレンス

ライブアクション:

• espn-pp-cli scores <sport> <league> — 現在のスコア
• espn-pp-cli today — 全メジャースポーツの本日のスコア
• espn-pp-cli scoreboard <sport> <league> — オプションの日付フィルタリング付きスコアボード
• espn-pp-cli watch <sport> <league> --event <game_id> — 1 つのゲームのライブスコアポーリング
• espn-pp-cli standings <sport> <league> — リーグ順位表
• espn-pp-cli trending — リーグ全体の最もフォローされているアスリートとチーム
• espn-pp-cli dashboard — ~/.config/espn-pp-cli/config.toml からのお気に入りスナップショット

チーム詳細:

• espn-pp-cli teams <sport> <league> <team_id> — 1 つのチームのスケジュール (過去および今後)
• espn-pp-cli teams get <sport> <league> <team_id> — チームの記録、リンク、ロゴ
• espn-pp-cli teams list <sport> <league> — リーグ内のすべてのチーム
• espn-pp-cli streak <sport> <league> — シンク済みデータからの現在の連勝/連敗
• espn-pp-cli rivals <sport> <league> — シンク済みデータからのチーム間のヘッドツーヘッドレコード
• espn-pp-cli h2h <team1> <team2> --sport <s> --league <l> — 1 つのチームペアのより詳細 (平均スコア、対戦)
• espn-pp-cli sos <sport> <league> — スケジュール難度 (降順でソート)

ゲーム詳細:

• espn-pp-cli summary <sport> <league> --event <game_id> — 完全なゲームサマリー (ボックススコア、リーダー、スコアリングプレー、オッズ、勝利確率)
• espn-pp-cli boxscore <event_id> — ボックススコアサブツリーのみ (スポーツ/リーグはキャッシュから推測)
• espn-pp-cli plays <sport> <league> --event <id> — プレーバイプレーフィード (オプション --limit、デフォルト 200)
• espn-pp-cli recap <sport> <league> — 最新の完了したゲームリキャップ
• espn-pp-cli odds <sport> <league> — 今夜のスレートのスプレッド、オーバー/アンダー、マネーライン

人物情報:

• espn-pp-cli leaders <sport> <league> [--category <name>] — カテゴリ別の統計リーダー
• espn-pp-cli compare <athlete1> <athlete2> --sport <s> --league <l> — アスリート統計のサイドバイサイド比較
• espn-pp-cli injuries <sport> <league> — 現在の傷害レポート
• espn-pp-cli transactions <sport> <league> — 最近のトレード、署名、ウェーバー

ポーリングとランキング:

• espn-pp-cli rankings <sport> <league> — AP、Coaches、CFP ポール

情報:

• espn-pp-cli news <sport> <league> — 最新ニュース

発見とローカル:

• espn-pp-cli search "<query>" — シンク済みイベントおよびニュースの全文検索
• espn-pp-cli sync — スポーツ+リーグをローカル SQLite にシンク
• espn-pp-cli sql "<query>" — ローカルストアに対して読み取り専用 SQL を実行
• espn-pp-cli load — シンク済みデータのワークロード分布を担当者ごとに表示
• espn-pp-cli orphans / stale — ローカルストアのメンテナンスビュー
• espn-pp-cli doctor — 接続性と構成を検証

スポーツ値: football、basketball、baseball、hockey、soccer。 リーグ値: nfl、nba、mlb、nhl、ncaaf、ncaam、ncaaw、mls、eng.1 (EPL)、wnba。

レシピ

朝のスポーツスキャン

espn-pp-cli today --agent --select events.shortName,events.status
espn-pp-cli scores football nfl --agent --select events.shortName,events.competitions.competitors.team.displayName,events.status.type.detail
espn-pp-cli standings football nfl --agent

1 つの today コールは交叉リーグアクティビティをカバーし、1 つの scores はあなたが気にするリーグ、1 つの standings はコンテキストのため。ネストされた --select パスは、スコアボードペイロードを数十 KB から、実際に重要なフィールドに削減します — エージェントのコンテキストを小さく保つために重要です。

シンク済みデータからの試合前調査

espn-pp-cli sync --sport football --league nfl
espn-pp-cli rivals football nfl --agent         # シンク済みデータからの歴史的レコード
espn-pp-cli streak football nfl --agent         # 現在の連勝/連敗
espn-pp-cli summary football nfl --event <id> --agent   # 完全なゲームペイロード (オッズとボックススコアを含む)

sync を 1 回実行してから、rivals と streak はローカルストアから即座に応答します。summary は特定のゲームの最も充実したペイロード (ボックススコア、リーダー、スコアリングプレー、オッズ、勝利確率)。

シンク後のオフライン検索

espn-pp-cli sync --sport football --league nfl
espn-pp-cli search "Mahomes"                    # ローカルストアで検索

接続性が低い環境での繰り返しの検索や、履歴データのバッチ分析に便利です。

お気に入りダッシュボード

~/.config/espn-pp-cli/config.toml に [favorites] ブロックを追加:

[favorites]
nfl = ["KC", "BAL"]
nba = ["LAL"]

次に:

espn-pp-cli dashboard --agent

1 つのコールは、すべてのお気に入りチームの本夜のマッチアップステータスをリーグごとにグループ化して表示します。リーグごとの取得は並列実行され、部分的な失敗は成功した結果とともに報告されます。

試合前オッズとプレイヤー調査

espn-pp-cli odds basketball nba --agent          # 今夜のスプレッド / トータル / マネーライン
espn-pp-cli leaders basketball nba --category points --agent
espn-pp-cli compare "LeBron James" "Stephen Curry" --sport basketball --league nba --agent
espn-pp-cli boxscore <event_id> --agent          # ゲーム後のプレイヤー統計
espn-pp-cli plays basketball nba --event <id> --limit 50 --agent

odds はスコアボードのゲームごとのラインを読み込みます (ゲームごとのサマリーコールなし)。leaders --category はフィルタリングを 1 つの統計カテゴリに限定します。compare はアスリート ID を名前で解決し、曖昧性の候補をリストして終了します。boxscore は最新のキャッシュヒットからスポーツ+リーグを推測します。推測をスキップするには --sport/--league を渡します。

認証セットアップ

不要です。 ESPN のパブリックエンドポイントは API キーを必要としません。auth コマンドは一貫性のために存在していますが、ノーオペレーションです。

オプション設定:

• ESPN_CONFIG — 設定ファイルパスをオーバーライド
• ESPN_BASE_URL — ベース URL をオーバーライド (プロキシまたはミラー用)
• NO_COLOR — 標準 no-color env var

エージェントモード

任意のコマンドに --agent を追加します。--json --compact --no-input --no-color --yes に展開します。フィールドのチェリーピッキングには --select を使用し、リクエストをプレビューするには --dry-run を、GET キャッシュをバイパスするには --no-cache を使用します。

出力フィルタリング

--select はネストされた応答に降下するためのドット記号パスを受け入れます。配列は要素ごとにトラバースします:

espn-pp-cli <command> --agent --select id,name
espn-pp-cli <command> --agent --select items.id,items.owner.name

これを使用して、大規模なペイロードを実際に必要なフィールドに削減してください — 深くネストされた API 応答に重要です。

レスポンスエンベロープ

データレイヤーコマンドは出力を {"meta": {...}, "results": <data>} でラップします。データは .results を解析し、.meta.source を解析してソースが live またはローカルであるかを知ります。N results (live) サマリーは、標準出力が TTY の場合のみ stderr に出力されます。パイプされた/エージェント消費者は、標準出力で純粋な JSON を見ます。

終了コード

コード	意味
0	成功
2	使用方法エラー
3	見つかりません (チーム、ゲーム、アスリート)
5	API エラー
7	レート制限

インストール

go install github.com/mvanhorn/printing-press-library/library/media-and-entertainment/espn/cmd/espn-pp-cli@latest
espn-pp-cli doctor

MCP サーバー

go install github.com/mvanhorn/printing-press-library/library/media-and-entertainment/espn/cmd/espn-pp-mcp@latest
claude mcp add espn-pp-mcp -- espn-pp-mcp

引数解析

$ARGUMENTS が与えられた場合:

1. 空、help、または --help → espn-pp-cli --help を実行
2. install → CLI; install mcp → MCP
3. その他 → ユーザーの意図からの <sport> <league> を解決 (例: "Lakers" → basketball nba)、which espn-pp-cli をチェック (見つからない場合はインストールを提案)、--agent で実行します。

<!-- pr-218-features -->

エージェント ワークフロー機能

この CLI は cli-printing-press PR #218 からパッチ適用された 3 つの共有エージェントワークフロー機能を公開します。

名前付きプロファイル

フラグのセットを名前で保持し、呼び出し全体で再利用します。

# 現在のデフォルト以外のフラグを名前付きプロファイルとして保存
espn-pp-cli profile save <name>

# プロファイルを使用 — 明示的に設定しないフラグに値をオーバーレイ
espn-pp-cli --profile <name> <command>

# リスト / 検査 / 削除
espn-pp-cli profile list
espn-pp-cli profile show <name>
espn-pp-cli profile delete <name> --yes

フラグの優先順位: explicit flag > env var > profile > default。

--deliver

標準出力以外のシンクへのコマンド出力をルーティングします。エージェントが結果をファイル、ウェブフック、または別のプロセスに渡す必要があり、配管が不要な場合に便利です。

espn-pp-cli <command> --deliver file:/path/to/out.json
espn-pp-cli <command> --deliver webhook:https://hooks.example/in

ファイルシンクは原子的に書き込みます (tmp + rename)。ウェブフックシンクは application/json (または --compact が設定されている場合は application/x-ndjson) をポスト。不明なスキームは、サポートされているセットをリストする構造化拒否を生成します。

フィードバック

エージェント側からこの CLI に関するフィードバックを記録します。デフォルトではローカルのみで、構成なしで安全に呼び出せます。

espn-pp-cli feedback "何があなたを驚かせたり、つまずかせたりしましたか"
espn-pp-cli feedback list         # ローカルエントリを表示
espn-pp-cli feedback clear --yes  # ワイプ

エントリは JSON 行として ~/.espn-pp-cli/feedback.jsonl に追加されます。ESPN_FEEDBACK_ENDPOINT が設定されており、--send が渡されるか ESPN_FEEDBACK_AUTO_SEND=true が設定されている場合、エントリは上流にもポストされます (ノンブロッキング — ローカル書き込みは常に成功)。