Module zotero_web

Zotero Web API v3 client — for all write operations.

Why not write to SQLite directly?

Zotero syncs its database to the cloud. Writing to the SQLite file directly would cause sync conflicts and data corruption. All writes MUST go through the official Web API.

API Reference

Base URL: https://api.zotero.org Auth: Zotero-API-Key: {key} header Content-Type: application/json API version: 3 (via Zotero-API-Version: 3 header)

Rate limits

Zotero doesn’t document strict rate limits but recommends <1 req/sec for heavy operations. Our MCP usage pattern (human-triggered, one operation at a time) is well within bounds.

Structs

ZoteroWebClient

Blocking client for the Zotero Web API v3.