cli-anything-zotero について
cli-anything-zoteroは、Zoteroデスクトップのローカル機能を使って操作する、エージェント向けコマンドラインツールです。文献の検索や引用処理、モデル分析用の構造化コンテキスト作成に利用できます。
主な機能
- 01コレクション、アイテム、タグ、保存済み検索の確認
- 02アイテムのエクスポートと引用・参考文献の生成
- 03アイテムノートの読み取りと追加
- 04ファイルやJSONのZoteroへのインポート
- 05アイテムの構造化コンテキストの作成
- 06ライブラリやアイテムのセッションコンテキスト管理
活用シーン
- 01Zoteroライブラリ内の文献の検索と確認
- 02指定スタイルで引用や参考文献を生成
- 03既存アイテムに子ノートを追加
- 04後続のモデル分析用にアイテムのコンテキストを準備
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/インストール後、Claude Code で/cli-anything-zoteroを入力して読み込まれたか確認します。
詳細
cli-anything-zotero
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 "Key takeaway" --json
LLM コンテキストを構築する
下流のモデル分析用に構造化されたコンテキストを組み立てます。
cli-anything-zotero item context <item-key> --include-notes --include-links --json
バージョン
0.1.0
コメント
Markdown 対応