zotero

openai/plugins · Agent Skill

管理本地Zotero庫以搜尋、匯出參考文獻並插入文件中的引文。

總覽

發布者	openai組織
儲存庫	openai/plugins ↗
技能資料夾	`zotero`
星	5,426
附帶檔案	1
授權	未標示 — 請向作者確認
最近更新	2026年5月3日
連結	技能原始碼 ↗ · 儲存庫 ↗

Mozgi 檢查

我們在技能檔案中發現的內容。詳細資訊需訂閱。

安全性

低風險 · 未發現明顯風險 — 完整報告會顯示細節

相容性

需要額外軟體

相似技能

找到 36 個相似技能

訂閱另含

安裝

技能就是一個含 SKILL.md 的資料夾。選擇你的代理，在專案根目錄的終端機（macOS、Linux 或 Windows 的 Git Bash）執行指令。

把提示貼到 Claude、Codex 或其他助理：它會自行檢查並安裝技能。

Install the “zotero” skill from mozgi.io (https://mozgi.io/skills/zotero/) for me.

1. Download the archive: https://mozgi.io/skills/zotero/download
   If it fails, take the skill folder from the source: https://github.com/openai/plugins/tree/main/plugins/zotero/skills/zotero
2. Read SKILL.md and the other files. Check the skill is safe: no hidden commands, no sending data elsewhere, no scripts doing something other than described. If anything looks suspicious, stop and tell me.
3. Put the “zotero” folder into your agent's skills folder: .claude/skills/ for Claude Code, .agents/skills/ for Codex, .cursor/skills/ for Cursor, .gemini/skills/ for Gemini CLI. Inside the project if we are in one, otherwise in the home folder (~/.claude/skills/ etc.).
4. Make sure <skills folder>/zotero/SKILL.md exists.
5. Briefly tell me what this skill does and offer to try it on my task.

If you cannot do a step yourself, tell me what to click or type.

git clone --depth 1 --branch main https://github.com/openai/plugins.git /tmp/plugins
mkdir -p .claude/skills
cp -r /tmp/plugins/plugins/zotero/skills/zotero .claude/skills/zotero

重新啟動 Claude Code — 技能就會出現在清單中，手動呼叫：/zotero。要套用到所有專案，請放在 ~/.claude/skills。

git clone --depth 1 --branch main https://github.com/openai/plugins.git /tmp/plugins
mkdir -p .agents/skills
cp -r /tmp/plugins/plugins/zotero/skills/zotero .agents/skills/zotero

Codex 會從目前資料夾往上到儲存庫根目錄，在 .agents/skills 中尋找技能；用 /skills 或 $zotero 呼叫。所有專案：~/.agents/skills。

git clone --depth 1 --branch main https://github.com/openai/plugins.git /tmp/plugins
mkdir -p .cursor/skills
cp -r /tmp/plugins/plugins/zotero/skills/zotero .cursor/skills/zotero

Cursor 啟動時會載入技能；在 Agent 聊天輸入「/」呼叫。Cursor 也會讀取 .claude/skills 與 .agents/skills。所有專案：~/.cursor/skills。

git clone --depth 1 --branch main https://github.com/openai/plugins.git /tmp/plugins
mkdir -p .gemini/skills
cp -r /tmp/plugins/plugins/zotero/skills/zotero .gemini/skills/zotero

任務符合時，Gemini CLI 會提議啟用技能，由你確認。所有專案：~/.gemini/skills。

技能檔案

1 個檔案下載 ZIP

安裝前請先檢視 SKILL.md 與相關檔案。點擊檔案即可預覽。

SKILL.md 內容

作者原文 · 唯讀

Zotero

Use this skill to operate a user's local Zotero Desktop library from Codex.

Core helper:

python3 <plugin-root>/skills/zotero/scripts/zotero.py <command>

Resolve <plugin-root> by going two directories up from this SKILL.md file.

The helper is stdlib-only and follows the repo convention of running plugin Python helpers with python3 / #!/usr/bin/env python3; it does not require Codex-specific runtime discovery.

Fast starts

Check readiness in one command:

python3 <plugin-root>/skills/zotero/scripts/zotero.py status --json

Enable the local API and restart Zotero if needed:

python3 <plugin-root>/skills/zotero/scripts/zotero.py enable --restart

Search and export citation data:

python3 <plugin-root>/skills/zotero/scripts/zotero.py search "transformer" --json
python3 <plugin-root>/skills/zotero/scripts/zotero.py export-bibtex --out references.bib

Insert a citation from Zotero into a draft and keep references.bib in sync:

python3 <plugin-root>/skills/zotero/scripts/zotero.py cite --query "Attention Is All You Need" --tex paper.tex --bib references.bib --marker '<cite>'

Workflow

1. Start with status --json. Do not rediscover prefs, ports, or profile paths manually unless the helper fails.

2. If local_api_enabled_pref is false, run enable --restart when the user asked you to operate Zotero. This updates Zotero's local preference and restarts Zotero so port 23119 comes up.

3. Use read-only local API commands for normal work:

inventory for item/collection/tag summaries.
search <query> for papers/items.
export-bibtex or sync-bib for .bib files.
cite for inserting a citation into a draft.

4. Only retrieve attachment file URLs or full text when the user asks for PDFs, attachment paths, or full-text content.

5. Treat Zotero library writes as explicit write actions. Before import-bibtex, import-ris, or connector save commands, confirm the exact record/source and destination unless the user's prompt already explicitly asked to add/import it.

Common commands

# Readiness and route map
python3 <plugin-root>/skills/zotero/scripts/zotero.py status --json
python3 <plugin-root>/skills/zotero/scripts/zotero.py probe --json

# Library inventory
python3 <plugin-root>/skills/zotero/scripts/zotero.py inventory
python3 <plugin-root>/skills/zotero/scripts/zotero.py collections
python3 <plugin-root>/skills/zotero/scripts/zotero.py tags

# Search and export
python3 <plugin-root>/skills/zotero/scripts/zotero.py search "BERT"
python3 <plugin-root>/skills/zotero/scripts/zotero.py export-bibtex --out references.bib
python3 <plugin-root>/skills/zotero/scripts/zotero.py export-bibtex --item-key PXW99EKT
python3 <plugin-root>/skills/zotero/scripts/zotero.py citations --style apa --json

# Draft editing
python3 <plugin-root>/skills/zotero/scripts/zotero.py cite --item-key PXW99EKT --tex paper.tex --bib references.bib --marker '<cite>'
python3 <plugin-root>/skills/zotero/scripts/zotero.py cite --query "BERT" --markdown notes.md --bib references.bib --marker '<cite>'

# Attachments and full text; use only on request
python3 <plugin-root>/skills/zotero/scripts/zotero.py children PXW99EKT --json
python3 <plugin-root>/skills/zotero/scripts/zotero.py fulltext 2JAZS9U8 --out attention-fulltext.txt
python3 <plugin-root>/skills/zotero/scripts/zotero.py file-url 2JAZS9U8

# Writes to Zotero; confirm first unless explicitly requested
python3 <plugin-root>/skills/zotero/scripts/zotero.py selected-target --json
python3 <plugin-root>/skills/zotero/scripts/zotero.py import-bibtex --file new-reference.bib --yes
python3 <plugin-root>/skills/zotero/scripts/zotero.py import-ris --file new-reference.ris --yes

Output standards

For inventory/search, return title, creators, year, Zotero item key, and BibTeX key when available.
Explain the two-key distinction when relevant: Zotero item keys like PXW99EKT are not the same as exported BibTeX keys like vaswani_attention_2023.
For .bib export, return the absolute output path and entry count.
For draft citation insertion, report the edited file, inserted citation key, and updated .bib path.
For blockers, name the exact gate: Zotero app missing, local API disabled, port closed, connector unavailable, no matching item, or write not confirmed.

Route details

Read references/local-api-routes.md only when you need endpoint details beyond the helper commands.

常見問題

zotero 技能有什麼用途？

管理本地Zotero庫以搜尋、匯出參考文獻並插入文件中的引文。

如何安裝 zotero？

打開本頁的「安裝」區塊並選擇你的代理 — Claude Code、Codex、Cursor 或 Gemini CLI：那裡有把技能資料夾複製到正確位置的現成指令。也可以複製「透過助理」分頁中的提示，讓助理自行檢查並安裝技能。

zotero 適用哪些 AI 模型？

技能是純 Markdown 指示（Agent Skills 格式），因此 zotero 適用任何讀取 SKILL.md 的代理：Claude Code、Codex、Cursor、Gemini CLI、GitHub Copilot、OpenCode 等。只有在任務符合技能描述時，模型才會載入指示。

zotero 是免費的嗎？

此技能由 openai 公開發布。技能本身免費 — 你只需向 AI 供應商支付實際使用的 token 費用。儲存庫未標示授權 — 商業使用前請向作者確認條款。

安裝技能安全嗎？

技能是代理會遵循的指示，安裝前請閱讀 SKILL.md 及相關檔案。技能資料夾中的腳本只有在代理執行時才會運行 — 留意它的動作，不要授予多餘權限。

技能和 MCP 伺服器或外掛有何不同？

MCP 伺服器或外掛為模型提供新工具 — 會執行並回傳結果的程式碼。技能提供的是知識與流程：如何處理任務、要遵循哪些步驟、好的成果長什麼樣子。它不需要伺服器或 API 金鑰。

總覽