pp-arxiv

arXiv — Printing Press CLI

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

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

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

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

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

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

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

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

この CLI を使用しない場合

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

独自の機能

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

研究の検索

• query — 文書化されたクエリ式と、エージェント向けの出力制御を使って arXiv を検索します。
• query — 提出日順と上限付きの結果件数を指定して、最新の AI／研究論文をカテゴリ別に取得します。
• query — arXiv ID またはバージョン付き arXiv ID を指定して、該当する論文を取得します。

コマンドリファレンス

query — クエリを管理します

• arxiv-pp-cli query --search-query 'cat:cs.AI' --max-results 5 — arXiv の論文を検索するか、カテゴリ別に最近の論文を取得します。
• arxiv-pp-cli query --id-list 1706.03762 --max-results 1 — arXiv ID またはバージョン付き arXiv ID を指定して、該当する論文を取得します。

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

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

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

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

認証の設定

認証は不要です。

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

エージェントモード

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

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

• フィルター可能 — --select でフィールドを絞り込めます。ドット区切りのパスはネストした構造をたどり、配列には要素ごとに適用されます。出力の多い API でコンテキストを小さく保つうえで重要です。

  arxiv-pp-cli query --search-query 'cat:cs.AI' --max-results 5 --agent --select entries.id,entries.title
  

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

• ライブ優先 — arXiv の検索はライブ API に対して最も有用です。汎用の同期／ローカルストアコマンドは Printing Press のひな形から含まれていますが、arXiv の /api/query では呼び出し側が検索パラメーターまたは ID パラメーターを指定する必要があるため、この CLI はライブクエリ優先として扱ってください。

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

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

レスポンスエンベロープ

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

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

データの解析には .results を使い、ライブデータかローカルデータかを確認するには .meta.source を使います。人間が読みやすい N results (live) という概要は、stdout がターミナルの場合に限り stderr に出力されます。パイプやエージェントの利用者には、stdout に純粋な JSON が出力されます。

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

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

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

エントリーはローカルの ~/.arxiv-pp-cli/feedback.jsonl に保存されます。ARXIV_FEEDBACK_ENDPOINT が設定され、かつ --send が指定されているか ARXIV_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」パターンです。

arxiv-pp-cli profile save briefing --json
arxiv-pp-cli --profile briefing query --search-query 'cat:cs.AI' --max-results 5
arxiv-pp-cli profile list --json
arxiv-pp-cli profile show briefing
arxiv-pp-cli profile delete briefing --yes

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

終了コード

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

引数の解析

$ARGUMENTS を解析します。

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

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

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

claude mcp add arxiv-pp-mcp -- arxiv-pp-mcp

確認するには、claude mcp list を実行します。

直接使用

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

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

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