pp-marginalrevolution

Marginal Revolution - Printing Press CLI

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

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

1. Printing Press インストーラーでインストールします。デフォルトでは、macOS/Linux の場合は $HOME/.local/bin に、Windows の場合は %LOCALAPPDATA%\Programs\PrintingPress\bin にバイナリがインストールされます。

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

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

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

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

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

この CLI を使用する場面

ブラウザー自動化を使わずに、最新の Marginal Revolution の投稿、カテゴリー、著者、コメント数、引用されている外部リンクを取得する必要がある場合に、この CLI を使用してください。

この CLI を使用しない場面

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

コマンドリファレンス

feed — フィードを管理します

• marginalrevolution-pp-cli feed — 現在公開されている RSS フィードを返します。フィードは XML/RSS 形式で、認証は不要です。

RSS ネイティブコマンド

• marginalrevolution-pp-cli latest --limit 10 --json - 最近の投稿を一覧表示します
• marginalrevolution-pp-cli latest --author Tyler --category Economics - 最近の投稿を絞り込みます
• marginalrevolution-pp-cli search "ai" --agent - 現在のフィードのタイトル／本文／カテゴリーのテキストを検索します
• marginalrevolution-pp-cli read <url|guid|title> - 現在のフィードにある投稿を読みます
• marginalrevolution-pp-cli links --limit 5 - 最近の投稿から外部リンクを抽出します
• marginalrevolution-pp-cli categories - 現在のフィードのカテゴリー件数を表示します
• marginalrevolution-pp-cli authors - 現在のフィードの著者別件数を表示します

対象範囲に関する注意

公開 RSS フィードはコマンドラインクライアントから利用できます。Marginal Revolution の WordPress JSON API と通常のサイト内検索 URL は、実装時に Cloudflare のブラウザーチャレンジを返したため、この CLI の検索対象は意図的に、現在フィードに含まれる投稿に限定されています。

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

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

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

which は、自然言語で指定した機能の問い合わせを、この CLI の厳選された機能インデックスから最適なコマンドに対応付けます。終了コード 0 は少なくとも 1 つ一致したことを示します。終了コード 2 は確信を持てる一致がなかったことを示します。その場合は --help にフォールバックするか、より具体的な問い合わせを使用してください。

認証の設定

認証は不要です。

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

エージェントモード

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

• パイプ可能 — JSON は stdout に、エラーは stderr に出力されます

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

  marginalrevolution-pp-cli feed --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 に気になる点があった場合（エージェントが気づいた場合も含みます）、記録してください。

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

記録は ~/.marginalrevolution-pp-cli/feedback.jsonl にローカル保存されます。MARGINALREVOLUTION_FEEDBACK_ENDPOINT が設定され、かつ --send が指定されているか MARGINALREVOLUTION_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」パターンのように、スケジュールされたエージェントが同じ設定で毎回同じコマンドを呼び出す場合に使用します。

marginalrevolution-pp-cli profile save briefing --json
marginalrevolution-pp-cli --profile briefing feed
marginalrevolution-pp-cli profile list --json
marginalrevolution-pp-cli profile show briefing
marginalrevolution-pp-cli profile delete briefing --yes

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

終了コード

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

引数の解析

$ARGUMENTS を解析します。

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

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

この CLI の公開ライブラリーエントリーまたはビルド済みリリースから MCP バイナリーをインストールし、登録します。

claude mcp add marginalrevolution-pp-mcp -- marginalrevolution-pp-mcp

確認します：claude mcp list

直接使用

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

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

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