用途：pyzotero 是 Zotero API v3 的 Python 封装，用于以编程方式管理 Zotero 文献库，包括读取条目与集合、创建和更新参考文献、上传附件、管理标签以及导出引用。资料称当前上游版本为 pyzotero 1.13.0（PyPI，2026 年 5 月），文档位于 pyzotero.readthedocs.io。
认证：需从 Zotero 密钥页面获取 User ID 与 API Key；群组库还需库 ID。凭据可放入环境变量或 .env，例如 ZOTERO_LIBRARY_ID、ZOTERO_API_KEY、ZOTERO_LIBRARY_TYPE（user 或 group）。
安装：提供三种方式，uv add pyzotero（Web API 客户端）、uv add "pyzotero[cli]"（含本地 CLI，Zotero 7）、uv add "pyzotero[mcp]"（含面向 LLM 客户端的 MCP 服务器，Zotero 7）。
用法：用 Zotero 类绑定单个用户或群组库，比如读取顶层条目（默认 100 条）、按关键词搜索、用 everything() 取全部结果。条目数据位于 item['data']，字段如 title、creators。写操作成功返回 True，失败抛出 ZoteroError。常见模式包括取出条目后修改 title 再 update_item、用 item_template('journalArticle') 创建条目、通过 add_parameters(format='bibtex') 导出 BibTeX，以及使用 local=True 的只读本地模式。
适用场景：科研文献管理与自动化，如批量整理条目、检索、更新元数据、导出引用，以及通过 CLI 或 MCP 对接本地 Zotero 7（含全文 PDF 搜索）。CLI 与 MCP 需 Zotero 7 并启用本地 API。
限制：一个 Zotero 实例只绑定一个库；默认返回条数有限（pyzotero 为 100，API 为 25）；本地模式为只读且无需 API Key；CLI 与 MCP 依赖 Zotero 7 本地 API。资料未提供价格、平台支持范围与效果数据。