zotkit 是一个无需桌面应用的头盔式 Python CLI 和库,用于管理 Zotero 文献库,支持 WebDAV 文件同步和标签约定强制执行。

Stars

18

7 天增长

暂无数据

Fork 数

0

开放 Issue

0

开源协议

MIT

最近更新

2026-07-27

AI 仓库情报摘要
FR-AI / ANALYSIS

为什么值得关注

它独特地提供了在头盔环境下(服务器、CI、SSH)的完整写入能力,包括 WebDAV 附件的上传和下载,并内置安全机制和 LLM 代理兼容性。

适合谁使用

  • 需要自动化管理 Zotero 文献库的研究人员
  • 构建与 Zotero 交互的脚本或 AI 代理的开发者
  • 希望在服务器、SSH 或 CI 中运行 Zotero 任务的用户
  • 需要代码强制标签分类以保持一致性的用户

典型使用场景

  • 通过脚本或 CI 管道自动导入文献并添加标签
  • 无需桌面应用即可通过 WebDAV 上传和下载 PDF 附件
  • 使用 AI 代理清理和重组混乱的 Zotero 文献库
  • 将整个文献库元数据备份为单个 JSON 文件

项目优势

  • 完全头盔操作,无需 Zotero 桌面应用
  • 同时支持 Zotero Storage 和 WebDAV 的附件文件操作
  • 通过可选的 conventions.toml 实现代码强制标签约定,防止不一致的标签
  • 默认安全预览模式,版本检查的写入操作,适合批量安全处理

使用前须知

  • 群组文献库的条目操作未经测试;WebDAV 同步仅限于个人文献库
  • find 命令客户端检索,对于非常大的文献库可能变慢
  • MCP 服务器和服务端搜索等功能仍在路线图中

README 快速开始

zotkit

Headless Zotero library management — no desktop app required.

English | 简体中文

"Headless" simply means zotkit never needs the Zotero app (or any window) open: it is a Python library + CLI that talks straight to the Zotero Web API, so you can search, create, tag, and organize items from any terminal — macOS, Windows, or Linux, your laptop or a remote server. If your attachments sync to a personal WebDAV server, zotkit can upload and download the files themselves by speaking Zotero's WebDAV storage format directly — a capability the Web API itself does not provide. The format is documented in docs/webdav-format.md.

Built for servers, scripts, and LLM agents: every write is dry-run by default, batched, and version-checked, and you can define a tag taxonomy that is enforced in code so an agent (or a tired human) can't pollute your library with inconsistent tags.

Why zotkit

Desktop appOther CLI/MCP toolszotkit
Works headless (server, SSH, CI)✅ read-mostly
Write items/tags/collections⚠️ usually needs the desktop app running
Attachment files (Zotero Storage)⚠️ some✅ upload + download
Attachment files on WebDAV⚠️ download at bestupload + download
Tag conventions enforced in code✅ optional conventions.toml

The zotkit family

Two independent, complementary projects — use either on its own, or both together:

What it is
zotkit (this repo)Headless Python CLI + library. Runs anywhere, needs no Zotero app.
zotkit-readerA Zotero Reader sidebar that embeds a Codex/Claude agent beside the PDF you're reading. Maintained by @ChanceSiyuan.

They share a name and a philosophy, not a codebase: zotkit-reader can call zotkit over MCP for library-wide operations, but neither requires the other to be installed.

Install

Pure Python (3.11+), no platform-specific bits — the same package works on macOS, Windows, and Linux:

pipx install zotkit        # or: uv tool install zotkit / pip install zotkit
uvx zotkit --help

项目描述

Headless Zotero library management: Web API CRUD + direct WebDAV attachment upload/download — no desktop app required

相关仓库与替代方案

根据分类、Topic 和编程语言匹配的相似项目。

0xwilliamortiz
精选
0xwilliamortiz GitHub avatar

openclaude-improved

OpenClaude is an open-source CLI coding agent that runs on any platform and supports a wide range of LLM providers, offering the same tools and workflows as Claude Code.

AI 与机器学习大语言模型
577
programmersd21
精选
programmersd21 GitHub avatar

flow

flow is a minimalist terminal dashboard that displays real-time network throughput with smooth animations, multiple responsive modes, and zero configuration.

开发者工具CLI 与终端
277
lopopolo
精选
lopopolo GitHub avatar

harness-engineering

Harness Engineering is a methodology for improving coding agent outputs by carefully crafting the environment around them—providing curated context, tools, and executable constraints that encode an organization’s nonfunctional requirements and cumulative lessons.

AI 与机器学习AI 智能体
2,390