paperzilla

Paperzilla

Paperzilla のプロジェクト、レコメンデーション、正規論文についてエージェントとチャットしたいときに、このスキルを使います。

質問できること

• 「プロジェクト X の最新のレコメンデーションを教えて。」
• 「レコメンデーション Y を開いて、なぜ重要なのか説明して。」
• 「正規論文 Z を markdown として取得して要約して。」
• 「この論文が自分の研究にどう関係するか教えて。」
• 「プロジェクト X のフィードを見せて。」
• 「レコメンデーションにフィードバックを残して。」
• 「この論文、レコメンデーション、またはフィードを JSON としてエクスポートして。」

これは Paperzilla の中核となるスキルです。エージェントに Paperzilla のデータへ直接アクセスさせますが、ワークフローや外部への配信連携を強制するものではありません。

アクセス方法

公式の pz CLI を使用します。このスキルは 0.7.1 を対象としており、公式リリースのソースとバイナリに対して確認済みです。コマンド例ではプレースホルダーの ID を使用しています。実際には、自分のアカウントから返されたレコードに置き換えてください。CLI の動作は、認証済みの Paperzilla アカウントではなく、ローカルのモックサーバーに対してテストされました。

まず pz --version を実行し、次にプロジェクトを一覧表示して、プロジェクトを選択し、そのフィードを閲覧または検索し、選択したレコメンデーションを確認します。要約やエクスポートを行う際は、プロジェクトのレコメンデーションと、その基になっている正規論文を分けて扱ってください。

インストール

macOS

brew install paperzilla-ai/tap/pz

Homebrew 6 以降がこの formula を信頼できないものとして拒否する場合、公式ガイドでは brew trust --formula paperzilla-ai/tap/pz を使ってからインストールを再試行します。信頼するのはその formula だけにしてください。インストールとアップグレードのコマンドはドキュメント上で確認したものであり、このレビュー中に実行されたものではありません。

Windows (Scoop)

scoop bucket add paperzilla-ai https://github.com/paperzilla-ai/scoop-bucket
scoop install pz

Linux

公式の Linux インストールガイドを使用してください:

• https://docs.paperzilla.ai/guides/cli-getting-started

ソースからビルド (Go 1.23+)

ソースからのビルドについては CLI リポジトリを参照してください:

• https://github.com/paperzilla-ai/pz

アップデート

CLI が最新かどうかを確認し、インストール方法に固有のアップグレード手順を取得します:

pz update

検出が曖昧な場合は、明示的に上書きしてください:

pz update --install-method homebrew
pz update --install-method scoop
pz update --install-method release
pz update --install-method source

サポートされる値は auto、homebrew、scoop、release、source です。

認証

pz login

ログインはアカウントのメールアドレスにワンタイムコードを送信し、セッションをローカルに保存します。JSON エクスポートを実行する前に、対話形式で完了させてください。認証情報が存在しないか期限切れの場合、stdout にログインプロンプトが表示されることがあります。CLI はアカウントのアクセス権を確認し、トークンを自動的に更新します。アクセスやアップグレードのエラーは、空のフィードとして扱わず、報告してください。

バージョン固有の相違点: オンラインガイドには匿名での正規論文アクセスが記載されていますが、0.7.1 のバイナリでは pz paper であってもログインと CLI アクセスチェックが必要です。その後の正規論文の HTTP リクエストは公開ルートを使用します。このリリースで匿名の CLI ワークフローを約束しないでください。

CLI リファレンス

現在のプロファイルで pz を使用している場合、これらが中核となるコマンドです。

プロジェクトを一覧表示

pz project list
pz project list --json

1 つのプロジェクトを表示

pz project <project-id>
pz project <project-id> --json

一覧の JSON は id、name、mode、visibility を含む配列です。 単一プロジェクトの JSON には、キーワード、監視対象ソース、カテゴリも含まれます。

プロジェクトフィードを閲覧

pz feed <project-id>

便利なフラグ:

• --must-read
• --since YYYY-MM-DD
• --limit N
• --offset N (スキップするゼロベースの結果数)
• --json
• --atom

例:

pz feed <project-id> --must-read --since 2026-03-01 --limit 5
pz feed <project-id> --limit 20 --offset 20 --json
pz feed <project-id> --json
pz feed <project-id> --atom

--since は、論文の公開日ではなく、レコメンデーションが準備できた時点でフィルタリングします。 閲覧の JSON には items、total、limit、offset が含まれます。1 つのコマンドは 1 ページを取得するだけで、フィード全体を自動的にエクスポートするものではありません。同じフィルターを維持し、返された offset から受け取った items の数だけ進め、空のページになったとき、または返された total に達したときに停止してください。ページング中にライブフィードが変化した場合は、レコメンデーション ID で重複を排除してください。

フィードの出力には、既存のレコメンデーションフィードバックマーカーが含まれることがあります:

• [↑] アップボート
• [↓] ダウンボート
• [★] スター

プロジェクトフィード全体を検索する

pz feed search --project-id <project-id> --query "latent retrieval" --json
pz feed search --project-id <project-id> --query "retrieval" --feedback-filter starred --must-read --limit 20 --offset 20 --json

検索はプロジェクトフィード全体にわたって結果をランク付けします。3～200 文字にトリミングしたクエリと、100 までの正の --limit を使用してください。--offset は非負でなければなりません。フィードバックフィルターは all、unrated、liked、disliked、starred、not-relevant、low-quality です。これらのハイフン付きフィルターは、以下に示すアンダースコア付きの低評価理由とは異なります。検索は --since を受け付けません。

検索 JSON には items、limit、offset、has_more、query が含まれ、正確な総数は含まれません。has_more が true の間だけ次のオフセットをリクエストし、クエリとフィルターは変更しないでください。無限にループするのではなく、停止して一貫性のない空のページを報告してください。2 番目の例は後続ページを示しています。

正規の論文を読む

pz paper <paper-id>
pz paper <paper-id> --json
pz paper <paper-id> --markdown
pz paper <paper-id> --project <project-id>

いずれかのプロジェクトからのレコメンデーションを開く

pz rec <project-paper-id>
pz rec <project-paper-id> --json
pz rec <project-paper-id> --markdown

レコメンデーションのフィードバックを残す

pz feedback <project-paper-id> upvote
pz feedback <project-paper-id> star
pz feedback <project-paper-id> downvote --reason not_relevant
pz feedback clear <project-paper-id>

フィードバックはアカウントデータを変更します。ユーザーがその変更をリクエストしたときに使用してください。低評価理由は not_relevant または low_quality で、--reason は低評価にのみ適用されます。--json を追加するとフィードバックオブジェクトを取得できます。クリアすると {"project_paper_ref": "...", "cleared": true} を返します。clear はレコメンデーション ID の前にあるサブコマンドです。

論文とレコメンデーションの ID を区別する

正規の paper-id は論文を識別し、project-paper-id はプロジェクト内のそのレコメンデーションを識別します。どちらも返されたレコードから取得し、結果をエクスポートする際はプロジェクトの関連付けを保持してください。同じ論文が複数のプロジェクトに現れる場合でも、rec およびフィードバック操作にはレコメンデーション ID を使用してください。フィード JSON では、items[].id/items[].short_id はレコメンデーション識別子であり、items[].paper.id/items[].paper.short_id は正規の論文識別子です。DOI や正規の論文 ID からレコメンデーション ID を推測しないでください。公式 CLI ドキュメントを参照してください。

Markdown がまだ準備中である場合は、その状態を報告し、実際に返されたメタデータまたは要約のみを要約してください。再試行メッセージは全文の証拠ではありません。

出力と自動化

• ログイン完了後の機械的なパースには --json を優先してください。paper と rec は --json と --markdown の併用を拒否します。
• pz paper --markdown は、Markdown がすでに準備されている場合にのみ Markdown を返します。
• pz rec --markdown およびプロジェクトスコープの pz paper --project ... --markdown は、Markdown 生成をキューに入れることができます。保留中のメッセージは正常に終了する場合があります。stdout を全文として扱う前に内容を確認してください。即時の再試行を繰り返さず、保留状態を報告してください。
• --atom はフィードリーダー用の個人フィード URL を返し、フィードトークンを作成できます。その URL を保持する誰もがフィードを読むことができます。そのトークンをログ、公開レポート、リポジトリから遠ざけてください。Atom XML やページ JSON は返さず、閲覧フィルターは生成された URL に適用されません。
• 関連性スコアはプロジェクトのマッチングを表すものであり、科学的妥当性や効果の推定値を表すものではありません。要約がメタデータ、要約、実際の Markdown のいずれを使用したかを明示してください。PDF URL が欠けていることは、ソースのランディングページが存在しないことを意味しません。

設定

export PZ_API_URL="https://paperzilla.ai"

デフォルトはすでに Paperzilla を指しています。信頼できるサービスまたはローカルのテストサーバーの場合にのみ変更してください。認証済みリクエストはそこにセッション資格情報を送信します。PZ_TOKENS_PATH はオプションでセッションファイルを選択します。デフォルトでは、CLI は ~/.paperzilla/tokens.json を使用します。そのファイルを研究データとしてエクスポートしないでください。

リクエストルート、レスポンス形式、ページネーション、およびドキュメントとソースの相違点については、検証済みの CLI コントラクトを参照してください。

参照

• ドキュメント: https://docs.paperzilla.ai/guides/cli
• クイックスタート: https://docs.paperzilla.ai/guides/cli-getting-started
• リポジトリ: https://github.com/paperzilla-ai/pz