SuperAPI AI 工具集

zotero

写作与研究

查看项目

更新于 10-16 00:01

技能介绍

用途:通过 Zotero 本地服务器(localhost:23119)和 REST API(api.zotero.org)操作文献库,完成批量导入、检索与库管理。

主要能力:本地侧提供启动检测 /connector/ping、按 DOI 批量导入(doi.org 取 BibTeX,失败回退 CrossRef)、BibTeX 文件导入、集合列表、条目列表与搜索;REST 侧支持集合创建/更新/删除、条目创建(每请求最多 50 条)/更新/删除、标签管理与批量删除、保存搜索、附件上传及群组库操作。

前提条件:本地 API 需 Zotero 运行并启用「Allow other applications on this computer to communicate with Zotero」;REST 需设置环境变量 ZOTERO_API_KEY 与 ZOTERO_USER_ID。连接检查:curl -s http://localhost:23119/connector/ping;curl -s -H "Zotero-API-Key: $ZOTERO_API_KEY" "https://api.zotero.org/keys/current"。

使用方式:命令形如 /zotero import <DOI1> <DOI2>、/zotero import --file <doi_list.txt>、/zotero import --collection "集合名"、/zotero bibtex --bibtex <file>、/zotero collections、/zotero list、/zotero search "关键词";脚本调用 bash ~/.claude/skills/zotero/scripts/zotero_import.sh --dois "..." [--collection "..."]。导入脚本流程为确认 Zotero 运行、确定目标集合、逐 DOI 取 BibTeX、POST 至 /connector/import?session=<unique_id>、显示结果摘要。REST 更新/删除需带 If-Unmodified-Since-Version 头,缺失返回 428;批量上限 50 条;限流按 Backoff 与 429 + Retry-After 处理;可用 Zotero-Write-Token 防重复提交。

限制:本地 /api/... 仅支持 GET 只读,/connector/... 支持 POST 读写;导入的 session 参数每次须唯一否则 409;含 shell 特殊字符的 BibTeX 宜用 --data-binary @file.bib 发送;导入目标为 Zotero UI 当前选中的集合。群组库仅需将 /users/<userID> 替换为 /groups/<groupID>。

其它细节(价格、更多平台与效果)暂未提供。