- Zotero API Skill
- Zotero のローカル HTTP サーバー（
- localhost:23119
- ）および REST API（
- api.zotero.org
- ）経由で文献管理操作を行う。
- 前提条件
- ローカル API（Zotero 起動中のみ）
- Zotero が起動中で、以下の設定が有効であること：
- Zotero > 環境設定 > 詳細 > 「Allow other applications on this computer to communicate with Zotero」にチェック
- 接続確認:
- curl
- -s
- http://localhost:23119/connector/ping
- REST API（クラウド操作）
- 環境変数が設定されていること:
- ZOTERO_API_KEY
-
- API キー（
- https://www.zotero.org/settings/keys
- で作成）
- ZOTERO_USER_ID
- ユーザー ID
接続確認:
curl
-s
-H
"Zotero-API-Key:
$ZOTERO_API_KEY
"
"https://api.zotero.org/keys/current"
コマンド
1. DOI 一括インポート (
/zotero import
)
/zotero import
... /zotero import --file /zotero import --collection "コレクション名" インポートスクリプト: bash ~/.claude/skills/zotero/scripts/zotero_import.sh --dois "10.1038/xxx,10.2196/yyy" [ --collection "名前" ] 処理フロー: Zotero 起動確認（ /connector/ping ） 対象コレクション特定（指定なければ現在選択中を使用） 各 DOI → doi.org から BibTeX 取得（失敗時 CrossRef フォールバック） /connector/import?session= に POST 結果サマリー表示 2. 手動 BibTeX インポート ( /zotero bibtex ) DOI のない文献用。BibTeX ファイルを直接インポート: bash ~/.claude/skills/zotero/scripts/zotero_import.sh --bibtex /path/to/file.bib DOI 不明時は CrossRef API で検索: curl -s "https://api.crossref.org/works?query.bibliographic=著者名+キーワード&rows=5" 3. コレクション一覧 ( /zotero collections ) curl -s http://localhost:23119/api/users/0/collections | python3 -c " import json, sys for c in json.load(sys.stdin): d = c['data'] print(f \" {d['key']} {d['name']} \" )" 4. アイテム一覧 ( /zotero list ) /zotero list # 現在選択中コレクション /zotero list --collection "名前" # 指定コレクション 5. アイテム検索 ( /zotero search ) /zotero search "AI psychosis" REST API 操作 コレクション作成 curl -s -X POST \ -H "Zotero-API-Key: $ZOTERO_API_KEY " \ -H "Content-Type: application/json" \ "https://api.zotero.org/users/ $ZOTERO_USER_ID /collections" \ -d '[{"name": "コレクション名"}]' コレクション更新 curl -s -X PUT \ -H "Zotero-API-Key: $ZOTERO_API_KEY " \ -H "Content-Type: application/json" \ -H "If-Unmodified-Since-Version: $VERSION " \ "https://api.zotero.org/users/ $ZOTERO_USER_ID /collections/COLLECTION_KEY" \ -d '{"name": "新しい名前"}' アイテム作成（最大50件/リクエスト） curl -s -X POST \ -H "Zotero-API-Key: $ZOTERO_API_KEY " \ -H "Content-Type: application/json" \ "https://api.zotero.org/users/ $ZOTERO_USER_ID /items" \ -d '[{ "itemType": "journalArticle", "title": "タイトル", "creators": [{"creatorType": "author", "firstName": "名", "lastName": "姓"}], "collections": ["COLLECTION_KEY"], "tags": [{"tag": "タグ名"}] }]' アイテム部分更新（PATCH） curl -s -X PATCH \ -H "Zotero-API-Key: $ZOTERO_API_KEY " \ -H "Content-Type: application/json" \ -H "If-Unmodified-Since-Version: $VERSION " \ "https://api.zotero.org/users/ $ZOTERO_USER_ID /items/ITEM_KEY" \ -d '{"tags": [{"tag": "new-tag"}]}' アイテム削除 curl -s -X DELETE \ -H "Zotero-API-Key: $ZOTERO_API_KEY " \ -H "If-Unmodified-Since-Version: $VERSION " \ "https://api.zotero.org/users/ $ZOTERO_USER_ID /items/ITEM_KEY" タグ一括削除 curl -s -X DELETE \ -H "Zotero-API-Key: $ZOTERO_API_KEY " \ -H "If-Unmodified-Since-Version: $VERSION " \ "https://api.zotero.org/users/ $ZOTERO_USER_ID /tags?tag=tag1+||+tag2" グループライブラリ すべてのエンドポイントは /users/ を /groups/ に置き換えるだけ。
所属グループ一覧
curl -s -H "Zotero-API-Key: $ZOTERO_API_KEY " \ "https://api.zotero.org/users/ $ZOTERO_USER_ID /groups" 検索（REST API）
キーワード検索
curl -s -H "Zotero-API-Key: $ZOTERO_API_KEY " \ "https://api.zotero.org/users/ $ZOTERO_USER_ID /items?q=keyword&qmode=titleCreatorYear"
タグフィルタ（AND: 複数 tag、OR: || 区切り、NOT: - 接頭辞）
curl
-s
-H
"Zotero-API-Key:
$ZOTERO_API_KEY
"
\
"https://api.zotero.org/users/
$ZOTERO_USER_ID
/items?tag=AI&tag=review"
API 概要
ローカル API
エンドポイント
メソッド
用途
/connector/ping
GET/POST
起動確認
/connector/import?session=ID
POST
BibTeX/RIS インポート
/connector/getSelectedCollection
POST
選択中コレクション
/api/users/0/collections
GET
コレクション一覧
/api/users/0/collections/:key/items
GET
アイテム一覧
/api/users/0/items
GET
全アイテム
REST API (api.zotero.org)
エンドポイント
メソッド
用途
/users/