Zotero文献管理

技能简介

该技能通过Zotero REST API v3连接个人或群组文献库，支持从DOI/ISBN/PMID自动添加条目、批量导入、元数据与标签更新、多格式导出（BibTeX/RIS/CSL-JSON）、PDF附件检查、开放获取PDF获取等功能。所有操作通过零依赖的Python脚本完成，适合需要自动化处理学术文献的用户。

业务背景

研究人员与知识工作者可借助该工具实现文献库的自动化管理，无需手动维护零散资料。支持通过标准标识符批量导入文献、自动查重防冗余、多格式导出参考文献，并能识别缺失PDF附件的条目，大幅提升学术资料整理与引用的规范性效率。

落地案例：研发团队撰写技术白皮书时，可将收集的DOI列表批量导入Zotero库，系统自动检测重复条目并补全元数据；随后按项目分类筛选文献，一键导出BibTeX格式引用文件插入LaTeX文档；完稿前运行PDF检查，定位缺少全文的条目，通过开放获取功能尝试补全附件，确保参考文献完整可追溯。

能做什么

• 按关键词搜索文献条目，查看完整详情与附件列表
• 通过DOI/ISBN/PMID添加条目，自动检测重复
• 批量从文件导入多个标识符
• 更新条目元数据、标签、所属分类
• 导出指定格式参考文献，支持按分类筛选
• 检查哪些条目缺少PDF附件
• 通过CrossRef匹配文本中的引用并补全缺失DOI
• 获取开放获取PDF链接

使用说明

1. 环境配置

需设置以下环境变量：

ZOTERO_API_KEY   # 在 https://www.zotero.org/settings/keys/new 创建
ZOTERO_USER_ID   # 同一页面显示的数字ID（非用户名）

使用群组库时，将ZOTERO_USER_ID替换为ZOTERO_GROUP_ID。可选设置CROSSREF_EMAIL以提升DOI查询成功率。

2. 安装与运行

无需额外依赖，直接使用内置脚本：

python3 scripts/zotero.py <command> [options]

3. 常用命令示例

# 添加单篇文献
python3 zotero.py add-doi "10.1093/jamia/ocaa037" --tags "review"

# 批量导入
python3 zotero.py batch-add dois.txt --type doi --tags "imported"

# 导出BibTeX
python3 zotero.py export --format bibtex --output refs.bib

# 更新标签
python3 zotero.py update ITEMKEY --add-tags "important" --remove-tags "unread"

# JSON输出供脚本调用
python3 zotero.py search "cognitive load" --json

全局标志--json可将结果转为机器可读格式。

输入与输出

见下方输入与输出表格。

风险提示

• 删除操作默认移至回收站，加--permanent会永久清除且不可恢复
• API密钥泄露可能导致文献库被他人访问或修改
• 批量添加前建议先用--dry-run预览，避免重复条目
• CrossRef/Unpaywall查询受服务可用性影响，可能返回空结果

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/terwox/zotero/SKILL.md
来源类型：GitHub仓库