pyzotero
Interact with Zotero reference management libraries using the pyzotero Python client. Retrieve, create, update, and delete items, collections, tags, and attachments via the Zotero Web API v3. Use this skill when working with Zotero libraries programmatically, managing bibliographic references, exporting citations, searching library contents, uploading PDF attachments, or building research automation workflows that integrate with Zotero.
npx skills add LeonChaoX/qinyan-academic-skills --skill pyzotero --agent claude-code
Same command for any agent — swap --agent for codex, cursor, copilot.
Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.
# Pyzotero Pyzotero is a Python wrapper for the [Zotero API v3](https://www.zotero.org/support/dev/web_api/v3/start). Use it to programmatically manage Zotero libraries: read items and collections, create and update references, upload attachments, manage tags, and export citations. ## Authentication Setup **Required credentials** — get from https://www.zotero.org/settings/keys: - **User ID**: shown as "Your userID for use in API calls" - **API Key**: create at https://www.zotero.org/settings/keys/new - **Library ID**: for group libraries, the integer after `/groups/` in the group URL Store credentials in environment variables or a `.env` file: ``` ZOTERO_LIBRARY_ID=your_user_id ZOTERO_API_KEY=your_api_key ZOTERO_LIBRARY_TYPE=user # or "group" ``` See [references/authentication.md](references/authentication.md) for full setup details. ## Installation ```bash uv add pyzotero # or with CLI support: uv add "pyzotero[cli]" ``` ## Quick Start ```python from pyzotero import Zotero zot = Zotero(library_id='123456', library_type='user', api_key='ABC1234XYZ') # Retrieve top-level items (returns 100 by default) items = zot.top(limit=10) for item in items: print(item['data']['title'], item['da
- Authentication Setup
- Installation
- Quick Start
- Core Concepts
- Reference Files
- Common Patterns
- Fetch and modify an item
- Create an item from a template
- Export as BibTeX
- Local mode (read-only, no API key needed)
uv add pyzotero or with CLI support: uv add "pyzotero[cli]"
What does the pyzotero skill do?
Interact with Zotero reference management libraries using the pyzotero Python client. Retrieve, create, update, and delete items, collections, tags, and attachments via the Zotero Web API v3. Use this skill when working with Zotero libraries programmatically, managing bibliographic references, exporting citations, searching library contents, uploading PDF attachments, or building research automation workflows that integrate with Zotero.
How do I install it?
Run `npx skills add LeonChaoX/qinyan-academic-skills --skill pyzotero --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.
Where does this skill come from?
From LeonChaoX/qinyan-academic-skills, a repository with 759 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.
Is a popular skill a good skill?
Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.