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 の Local API を有効にする必要があります。
• note add は実行中の Zotero GUI コンテキストに依存し、アプリで同じライブラリが選択されている必要があります。
• インポート時の PDF 添付に対応するのは、同じコネクターセッションで作成されたアイテムに限られます。任意の既存アイテムへの添付ファイルのアップロードには、まだ対応していません。
• 実験的な SQLite 書き込みコマンドはローカルのみ、ユーザーライブラリのみで使用できます。また、安定性が保証されない上級ユーザー向けの操作として扱ってください。
• 複数のライブラリで同じキーが使われている場合は、後続のコマンドを実行する前に session use-library <id> を設定してください。

コマンドグループ

アプリ

アプリケーションとランタイムの確認コマンドです。

コマンド	説明
status	status を実行します。
version	version を実行します。
launch	launch を実行します。
enable-local-api	enable-local-api を実行します。
ping	ping を実行します。

コレクション

コレクションの確認と選択を行うコマンドです。

コマンド	説明
list	list を実行します。
find	find を実行します。
tree	tree を実行します。
get	get を実行します。
items	items を実行します。
use-selected	use-selected を実行します。
create	create を実行します。

アイテム

アイテムの確認と表示を行うコマンドです。

コマンド	説明
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 を実行します。

検索

保存済み検索の確認コマンドです。

コマンド	説明
list	list を実行します。
get	get を実行します。
items	items を実行します。

タグ

タグの確認コマンドです。

コマンド	説明
list	list を実行します。
items	items を実行します。

スタイル

インストール済みの CSL スタイルを確認するコマンドです。

コマンド	説明
list	list を実行します。

インポート

Zotero の公式インポートおよび書き込みコマンドです。

コマンド	説明
file	file を実行します。
json	json を実行します。

ノート

子ノートの読み取りと追加を行います。

コマンド	説明
get	get を実行します。
add	add を実行します。

セッション

セッションと 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 の Local 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

---

学術研究スキルの統合

Zotero harness は、27 の学術研究スキルを統合しています。skills コマンドグループを使用します。

cli-anything-zotero skills list              # List all skills
cli-anything-zotero skills list -c writing   # Writing skills only
cli-anything-zotero skills pipeline original_article  # Recommended workflow
cli-anything-zotero skills journal "Nature"  # Journal figure guide

スキルのカテゴリ

カテゴリ	スキル	説明
検索	lit-review, systematic-review, deep-search	文献の探索
研究	ideation, brainstorming, hypothesis, deep-research	研究の設計
執筆	write-paper, manuscript, citation, outline, revision	論文の執筆
査読	full-review, peer-review, seven-pass, verify-citations, audit-data	査読
可視化	slides, schematics, poster, nature-fig	図表とプレゼンテーション
分析	eda, statistics, critical-thinking	データ分析
パイプライン	full-pipeline, research-to-paper	エンドツーエンドのワークフロー

タスクパイプライン

タスク	手順
literature_review	systematic-review → critical-thinking → write-paper → seven-pass
original_article	hypothesis → statistics → manuscript → schematics → slides → full-review
meta_analysis	deep-search → deep-research → statistics → write-paper → peer-review
thesis	full-pipeline → seven-pass → slides → poster