用途:pyzotero 是 Zotero API v3 的 Python 客户端,用于程序化管理 Zotero 文献库,包括读取条目与分类、创建和更新参考文献、上传附件、管理标签、导出引用。
主要能力:支持远程私有库的读写,需从 Zotero 设置页获取 User ID、API Key,群组库还需 Library ID;凭据可存入环境变量或 .env,如 ZOTERO_LIBRARY_ID、ZOTERO_API_KEY、ZOTERO_LIBRARY_TYPE(user 或 group)。一个 Zotero 实例绑定单个用户库或群组库,条目数据位于 item['data']。默认返回 100 条,可用 zot.everything(zot.items()) 获取全部。返回类型因方法而异:update_item() 返回布尔成功值,create_items() 返回逐条创建状态,需检查 failed、successful、success、unchanged 映射并保留输入索引到 key 的映射,不能仅凭真值字典认定全部创建成功。
安装与用法:uv add "pyzotero==1.15.2";加 CLI 用 uv add "pyzotero[cli]==1.15.2";加 MCP 用 uv add "pyzotero[mcp]==1.15.2"。基本用法为 Zotero(library_id=..., library_type=..., api_key=...) 后调用 top()、items(q=...)、item()、update_item()、create_items()、item_template() 等;导出 BibTeX 可用 zot.top(format='bibtex', limit=50)。本地读取无需 API Key:Zotero(library_id='0', library_type='user', local=True)。CLI 与 MCP 服务器可搜索运行中的 Zotero 桌面应用(含已索引 PDF 文本),需 Zotero 7+ 并启用本地 API;Zotero 10+ 支持用单独本地 API Key 写入,MCP 写入需 --enable-writes,永久删除还需 --enable-deletes。
限制:Python 本地写入不能使用 item_template()。资料中涉及私有库或运行 Zotero 的示例为说明性内容,只读公开探测与隔离 SDK 契约检查不能证明认证写入成功。其余细节暂未提供。