zotero-cli

Search, manage, and query Zotero libraries via the zot CLI with workspace-based RAG.

Updated Jul 5, 2026
One-click install
npx skills add https://github.com/huaibovip/research-marketplace --skill zotero-cli-huaibovip
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: zotero-cli
Source: https://github.com/huaibovip/research-marketplace/tree/main/plugins/zotero-cli/skills/zotero-cli
Command: npx skills add https://github.com/huaibovip/research-marketplace --skill zotero-cli-huaibovip

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Managing academic references, extracting PDF content, and searching large paper collections manually through the Zotero GUI is slow and hard to automate. This Skill lets an agent perform all Zotero operations from the command line, including semantic search over curated paper workspaces. ## Core Features & Use Cases - Library Search & CRUD: Search metadata, read item details, add items by DOI/URL/PDF, update fields, and manage collections, tags, duplicates, and trash. - PDF Extraction & Citations: Extract full text, outlines, sections, tables, and references from PDFs, and export BibTeX/RIS/CSL-JSON or formatted citations (APA, Nature, Vancouver). - Workspace RAG: Build local topic-based workspaces with BM25/semantic/hybrid indexing, then run deep content queries or generate citation-keyed evidence packs with zot ask. - Use Case: While writing a literature review, ask the agent to find papers on a topic, fetch missing PDFs via the desktop bridge, index them into a workspace, and answer questions with citations grounded in the actual paper text. ## Quick Start Ask the agent to search your Zotero library for papers on a topic and export the results as BibTeX.

Frequently Asked Questions about zotero-cli

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I search my Zotero library from the command line?

Run zot --json search "your query" to search metadata across your library. Reads work offline against the local SQLite database with no configuration, and the --json flag returns structured output for programmatic use.

How to export BibTeX citations from Zotero using a CLI?

Use zot export ITEMKEY for BibTeX, or pass --format ris, csl-json, or json for other formats. For formatted citations, zot cite ITEMKEY --style apa generates an APA citation and copies it to the clipboard.

Can zot fetch paywalled PDFs automatically?

Yes, zot find-pdf ITEMKEY triggers Zotero desktop's Find Full Text, reusing its resolvers and institutional proxy sessions. It requires Zotero desktop running with the zot-cli-bridge plugin, installed once via zot bridge install.

How do I handle large PDFs without exceeding token limits?

Run zot --json pdf --outline ITEMKEY first to get numbered section headings, then zot --json pdf --section N ITEMKEY to extract only the section you need. Avoid pulling full text when it exceeds about 20k characters.

Why does zot crash or produce garbled output on Windows with Chinese locale?

Windows CJK locales default stdout to GBK, causing UnicodeEncodeError or decode failures. Recent zot versions auto-fix this; for older versions or subprocess calls, set PYTHONIOENCODING=utf-8 before invoking zot.

What is the difference between zot search and zot workspace query?

zot search does quick metadata lookups across the whole library, while zot workspace query runs deep content search over full-text indexed papers in a curated workspace. Workspaces support BM25, semantic, and hybrid retrieval modes.