Zotero CLI エージェント は何をしますか？
cli-anything-zotero は、Zotero デスクトップを操作するためのエージェント向け CLI です。Zotero を再実装するのではなく、Zotero の実際のローカル機能を組み合わせて利用します。
インストール
pip install -e .
エントリポイント
cli-anything-zotero
python -m cli_anything.zotero
重要な制約事項
search items、item export、item citation、item bibliographyを使用するには、Zotero のローカル API が有効になっている必要があります。note addは、Zotero の GUI コンテキストに依存し、アプリ内で同じライブラリが選択されている必要があります。- インポート時の PDF 添付ファイルのサポートは、同じコネクターセッション内で作成されたアイテムに限定されます。既存のアイテムへの任意の添付ファイルのアップロードは対象外です。
- 実験的な SQLite 書き込みコマンドは、ローカル専用、ユーザーライブラリ専用であり、安定していないパワーユーザー向け操作として扱う必要があります。
- ベアキーが複数のライブラリ間で重複している場合は、後続のコマンドの前に
session use-library <id>を設定してください。
コマンドグループ
App
アプリケーションおよび実行時検査コマンドです。
| コマンド | 説明 |
|---|---|
status | status を実行します。 |
version | version を実行します。 |
launch | launch を実行します。 |
enable-local-api | enable-local-api を実行します。 |
ping | ping を実行します。 |
Collection
コレクションの検査および選択コマンドです。
| コマンド | 説明 |
|---|---|
list | list を実行します。 |
find | find を実行します。 |
tree | tree を実行します。 |
get | get を実行します。 |
items | items を実行します。 |
use-selected | use-selected を実行します。 |
create | create を実行します。 |
Item
アイテムの検査およびレンダリングコマンドです。
| コマンド | 説明 |
|---|---|
list | list を実行します。 |
find | find を実行します。 |
get | get を実行します。 |
children | children を実行します。 |
notes | notes を実行します。 |
attachments | attachments を実行します。 |
file | file を実行します。 |
export | export を実行します。 |
citation | citation を実行します。 |
bibliography | bibliography を実行します。 |
context | context を実行します。 |
analyze | analyze を実行します。 |
add-to-collection | add-to-collection を実行します。 |
move-to-collection | move-to-collection を実行します。 |
Search
保存済み検索の検査コマンドです。
| コマンド | 説明 |
|---|---|
list | list を実行します。 |
get | get を実行します。 |
items | items を実行します。 |
Tag
タグ検査コマンドです。
| コマンド | 説明 |
|---|---|
list | list を実行します。 |
items | items を実行します。 |
Style
インストール済み CSL スタイルの検査コマンドです。
| コマンド | 説明 |
|---|---|
list | list を実行します。 |
Import
公式の Zotero インポートおよび書き込みコマンドです。
| コマンド | 説明 |
|---|---|
file | file を実行します。 |
json | json を実行します。 |
Note
子ノートの読み取りと追加を行います。
| コマンド | 説明 |
|---|---|
get | get を実行します。 |
add | add を実行します。 |
Session
セッションおよび REPL コンテキストコマンドです。
| コマンド | 説明 |
|---|---|
status | status を実行します。 |
use-library | use-library を実行します。 |
use-collection | use-collection を実行します。 |
use-item | use-item を実行します。 |
use-selected | use-selected を実行します。 |
clear-library | clear-library を実行します。 |
clear-collection | clear-collection を実行します。 |
clear-item | clear-item を実行します。 |
history | history を実行します。 |
使用例
ランタイムステータス
Zotero のパスとバックエンドの利用可能性を検査します。
cli-anything-zotero app status --json
選択中のコレクションを読み取る
Zotero GUI で選択されているコレクションを永続化します。
cli-anything-zotero collection use-selected --json
引用をレンダリング
Zotero のローカル API を使用して引用をレンダリングします。
cli-anything-zotero item citation <item-key> --style apa --locale en-US --json
子ノートを追加
既存の Zotero アイテムの下に子ノートを作成します。
cli-anything-zotero note add <item-key> --text "主要なポイント" --json
LLM コンテキストを構築
下流のモデル分析用に構造化コンテキストを組み立てます。
cli-anything-zotero item context <item-key> --include-notes --include-links --json
バージョン
0.1.0