pyzotero 是 Zotero API v3 的 Python 客户端封装，用于以编程方式管理单个 Zotero 文献库（用户库或群组库），可读取条目与集合、创建和更新参考文献、上传附件、管理标签以及导出引文。
用途与主要能力：检索顶层条目、按关键词搜索、获取全部条目；对条目和集合进行增删改查；管理标签；处理文件与附件；导出 BibTeX、CSL-JSON 与参考文献；支持全文内容索引与检索、保存的搜索、分页遍历以及命令行界面。
认证与安装：凭据从 Zotero 设置页获取，包括用户 ID、API Key，群组库需使用群组 URL 中 /groups/ 后的整数作为库 ID。可用环境变量 ZOTERO_LIBRARY_ID、ZOTERO_API_KEY、ZOTERO_LIBRARY_TYPE（user 或 group）保存。安装命令：uv add pyzotero，或含 CLI 支持：uv add "pyzotero[cli]"。
基本用法：实例绑定单一库，from pyzotero import Zotero 创建客户端后，方法操作该库；条目数据位于 item['data']，如 item['data']['title']、item['data']['creators']。默认返回 100 条，可用 zot.everything(zot.items()) 获取全部。写入方法成功返回 True，失败抛出 ZoteroError。支持本地模式（只读、无需 API Key）。
适用场景：批量整理与更新文献条目、自动化导出引文、按标签或集合组织资料、附件上传与全文检索等学术工作流。
限制：一个实例只绑定一个库；本地模式为只读；具体字段与接口行为需参考其 references 目录下的文档。资料未提供收费、平台或性能信息。