Open Skills Logo
Open Skillsopenskills.cc
技能pyzotero
P

pyzotero

使用 pyzotero 的 Python 客户端与 Zotero 引用管理库进行交互。通过 Zotero Web API v3，检索、创建、更新并删除条目、集合、标签以及附件。在以编程方式使用 Zotero 库时运用此技能：管理书目信息引用、导出引文、搜索库内内容、上传 PDF 附件，或构建与 Zotero 集成的研究自动化工作流。

pyzotero - Zotero 文献管理 Python 自动化工具

技能概述

pyzotero 是一个 Python 客户端，通过 Zotero Web API v3 程序化管理 Zotero 参考文献库，支持文献检索、创建、更新、删除以及集合、标签和附件管理。

适用场景

  1. 批量文献管理 - 当你需要自动化处理大量文献条目时，pyzotero 可以批量检索、更新或导出参考文献，适合研究者整理文献库或准备文献综述。

  2. 研究工作流集成 - 将 Zotero 集成到你的 Python 数据分析或学术写作流程中，例如从 Zotero 提取文献数据进行分析，或自动将新研究的引用信息添加到文献库。

  3. 引用导出与格式转换 - 自动将 Zotero 文献导出为 BibTeX、CSL-JSON 等格式，用于 LaTeX 文档排版或生成参考文献列表，支持自定义筛选条件。

核心功能

  1. 完整的 Zotero API 支持 - 通过 pyzotero 可以读取、创建、更新和删除文献条目，管理集合和标签，上传 PDF 附件，并支持全文内容索引和检索，覆盖 Zotero Web API v3 的全部功能。

  2. 灵活的认证与访问模式 - 提供 Web API 认证模式（需要 API Key）和本地只读模式（无需认证），支持个人库和群组库，适合不同权限需求和开发环境。

  3. 多种输出格式与扩展 - 除了核心 Python 库，还提供 CLI 命令行工具和 MCP 服务器支持，便于在 Zotero 7 本地环境中进行全文搜索和集成 LLM 客户端。

常见问题

pyzotero 需要什么前置条件？

使用 pyzotero 需要 Python 3.10 或更高版本，并通过 uv add pyzotero 或 pip install pyzotero 安装库。完整功能还需要从 Zotero 设置页面 获取 API Key 和 Library ID，并设置环境变量 ZOTERO_API_KEY、ZOTERO_LIBRARY_ID 和 ZOTERO_LIBRARY_TYPE（user 或 group）。

本地模式和 Web API 模式有什么区别？

Web API 模式需要 API Key，支持完整的读写操作，适合管理个人或群组的在线 Zotero 库。本地模式（local=True）是只读的，不需要 API Key，适用于读取本地 Zotero 数据库。如果你使用 Zotero 7，还可以选择 CLI 或 MCP 服务器模式，它们支持本地全文搜索但不依赖 Web API。

如何用 pyzotero 导出 BibTeX 格式？

使用 pyzotero 导出 BibTeX 很简单：先调用 zot.add_parameters(format='bibtex') 设置输出格式，然后执行 zot.top(limit=50) 或其他查询方法，返回的 bibtex 对象是一个 bibtexparser 的 BibDatabase 对象，可以通过 bibtex.entries 访问具体的 BibTeX 条目进行进一步处理或写入文件。

    pyzotero - Zotero 文献管理 Python 自动化 API 工具 - Open Skills