zotero-cli は何をしますか?
エージェントファーストのRust製Zotero CLIです。Claude Codeなどのエージェントがライブラリ検索、PDF証拠抽出、セマンティックワークスペースの構築、安全なWeb API書き込みを行うためのスキルがバンドルされています。
主な機能
- ライブラリ検索: キーワードやタグ、コレクションに基づいてZoteroライブラリを高速に検索します。
- PDF証拠抽出: PDFからハイライトや注釈を抽出し、引用可能な証拠として利用できるようにします。
- セマンティックワークスペース: 関連文献をテーマやプロジェクトごとに整理し、セマンティックな関係性を構築します。
- Web API書き込み: 新しいアイテムの追加や既存アイテムの更新など、Zotero Web APIへの安全な書き込み操作をサポートします。
対応プラットフォーム
- Claude Code
- Cursor
- Codex
- その他のAIエージェント環境
クイックスタート
zotero-cliをインストールします(Rustのビルド環境が必要な場合があります)。- Zotero APIキーを環境変数
ZOTERO_API_KEYに設定します。 - エージェント設定にこのスキルを追加します。
使用例
# ライブラリの検索
zotero-cli search "機械学習" --limit 10
# PDFからの証拠抽出
zotero-cli extract --pdf /path/to/document.pdf
# セマンティックワークスペースの構築
zotero-cli workspace create --name "プロジェクトX"
# 新しいアイテムの追加
zotero-cli add --title "論文タイトル" --type journalArticle
設定
| 環境変数 | 説明 |
|---|---|
ZOTERO_API_KEY | Zotero Web APIへのアクセスに必要なAPIキー |
ZOTERO_USER_ID | ZoteroユーザーID(任意) |
注意事項
- APIキーは安全に管理し、公開リポジトリに含めないでください。
- 書き込み操作はバックグラウンドで確認が行われる場合があります。
ライセンス
MIT