SuperAPI AI 工具集

zotero-skills

通用与其它

查看项目

更新于 10-16 09:44

技能介绍

用途:对 Zotero 文献库执行完整的增删改查,包括检索条目、添加与更新元数据、管理标签与分类归属、创建子笔记、处理 PDF 附件及删除条目。触发说法如「add paper to Zotero」「search Zotero」「update this collection」「tag these items」「find duplicates」以及文献、引用、参考文献管理等表述。

主要能力与规则:采用双 API 架构。读取一律使用本地 API(http://localhost:23119/api,请求头 Zotero-Allowed-Request: true),速度快、无需密钥,但仅在 Zotero 桌面端运行时可用;写入一律使用 Web API(https://api.zotero.org,请求头 Zotero-API-Key: <key>),通过 pyzotero 完成。MCP 写入工具会失败:zotero_create_note / zotero_batch_update_tags 命中本地 API 并返回 400/501,应改用共享客户端中的 pyzotero。API 密钥不得出现在提交、笔记或库文件中,应使用环境变量或 config.json(加入 gitignore)。所有操作应导入共享客户端 from zotero_client import get_client, ZoteroDualClient,不要手工构造 API 请求,共享客户端负责双 API 路由、限流退避与凭据加载。

工作流:先探测,用共享客户端的 check_local_api() 确认 Zotero 桌面端在运行,否则自动回退到 Web API;再读取状态(zotero_search_items / zotero_get_collections MCP 工具或本地 API GET);然后按需执行创建、更新或删除;最后通过本地 API 或 zot.item(key) 回读验证结果。

输出与限制:技能是交互式的,没有机器可读结果文件;每次写入后需向用户说明操作类型(CREATE / UPDATE / DELETE)、受影响条目 key,以及是否可逆(如回收站与永久删除)。本地 API 需在 Zotero 设置 → 高级中启用「允许本机其他应用与 Zotero 通信」。Web API 限流约每密钥 100 请求/10 秒,safe_api_call() 会自动处理 429 退避。已测试 pyzotero >= 1.5 与较新的 MCP zotero 服务器。库清理审计不在本技能范围,应先使用 zotero-library-curator 规划再回到本技能应用。随附 scripts/zotero_client.py 共享客户端与 scripts/add_literature.py 批量导入模板可供参考。具体命令与端点细节见资料所列参考文档。