Requirements
- Target platform
- OpenClaw
- Install method
- Manual import
- Extraction
- Extract archive
- Prerequisites
- OpenClaw
- Primary doc
- SKILL.md
Manage Zotero reference libraries via the Web API. Search, list, add items by DOI/ISBN/PMID (with duplicate detection), delete/trash items, update metadata and tags, export in BibTeX/RIS/CSL-JSON, batch-add from files, check PDF attachments, cross-reference citations, find missing DOIs via CrossRef, and fetch open-access PDFs. Supports --json output for scripting. Use when the user asks about academic references, citation management, literature libraries, PDFs for papers, bibliography export, or Zotero specifically.
Manage Zotero reference libraries via the Web API. Search, list, add items by DOI/ISBN/PMID (with duplicate detection), delete/trash items, update metadata and tags, export in BibTeX/RIS/CSL-JSON, batch-add from files, check PDF attachments, cross-reference citations, find missing DOIs via CrossRef, and fetch open-access PDFs. Supports --json output for scripting. Use when the user asks about academic references, citation management, literature libraries, PDFs for papers, bibliography export, or Zotero specifically.
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
Interact with Zotero personal or group libraries via the REST API v3.
Requires two environment variables: ZOTERO_API_KEY โ Create at https://www.zotero.org/settings/keys/new ZOTERO_USER_ID โ Found on the same page (numeric, not username) For group libraries, set ZOTERO_GROUP_ID instead of ZOTERO_USER_ID. Optional env var for CrossRef/Unpaywall polite pool (improves DOI lookup success rate): CROSSREF_EMAIL โ Your email (optional; uses fallback if unset) If credentials are missing, tell the user what's needed and link them to the key creation page.
All operations use scripts/zotero.py (Python 3, zero external dependencies). python3 scripts/zotero.py <command> [options]
CommandDescriptionExampleitemsList top-level itemszotero.py items --limit 50searchSearch by queryzotero.py search "cognitive load"getFull item details + attachmentszotero.py get ITEMKEYcollectionsList all collectionszotero.py collectionstagsList all tagszotero.py tagschildrenList attachments/notes for itemzotero.py children ITEMKEYadd-doiAdd item by DOI (dedup enabled)zotero.py add-doi 10.1234/exampleadd-isbnAdd item by ISBN (dedup enabled)zotero.py add-isbn 978-0-123456-78-9add-pmidAdd item by PubMed IDzotero.py add-pmid 12345678deleteMove items to trash (recoverable by default)zotero.py delete KEY1 KEY2 --yesupdateModify item metadata/tagszotero.py update KEY --add-tags "new"exportExport as BibTeX/RIS/CSL-JSONzotero.py export --format bibtexbatch-addAdd multiple items from filezotero.py batch-add dois.txt --type doicheck-pdfsReport which items have/lack PDFszotero.py check-pdfscrossrefMatch citations vs libraryzotero.py crossref bibliography.txtfind-doisFind & add missing DOIs via CrossRefzotero.py find-dois --limit 10fetch-pdfsFetch open-access PDFs for itemszotero.py fetch-pdfs --dry-run
--json โ JSON output instead of human-readable (works with items, search, get)
--limit N โ Max items to return (default 25) --sort FIELD โ Sort by dateModified, title, creator, date --direction asc|desc โ Sort direction --collection KEY โ Filter by or add to collection --type TYPE โ Filter by item type (journalArticle, book, conferencePaper, etc.) --tags "tag1,tag2" โ Add tags when creating items --force โ Skip duplicate detection on add commands
python3 zotero.py add-doi "10.1093/jamia/ocaa037" --tags "review" # Warns if already in library. Use --force to override. Duplicate detection: translates DOI to metadata, searches library by first author, compares DOI fields.
# One identifier per line, # for comments python3 zotero.py batch-add dois.txt --type doi --tags "imported" Skips duplicates. Reports summary: added/skipped/failed.
python3 zotero.py export --format bibtex --output refs.bib python3 zotero.py export --format csljson --collection COLLKEY
python3 zotero.py update ITEMKEY --add-tags "important" --remove-tags "unread" python3 zotero.py update ITEMKEY --title "Corrected Title" --date "2024" python3 zotero.py update ITEMKEY --doi "10.1234/example" python3 zotero.py update ITEMKEY --url "https://example.com/paper" python3 zotero.py update ITEMKEY --add-collection COLLKEY
python3 zotero.py delete KEY1 KEY2 --yes # Trash (recoverable, default) python3 zotero.py delete KEY1 --permanent --yes # Permanent delete
python3 zotero.py crossref my-paper.txt Extracts Author (Year) patterns from text and matches against library.
# Dry run (default) โ show matches without writing anything python3 zotero.py find-dois --limit 20 # Actually write DOIs to Zotero python3 zotero.py find-dois --apply # Filter by collection python3 zotero.py find-dois --collection COLLKEY --apply Scans journalArticle and conferencePaper items missing DOIs, queries CrossRef, and matches by title similarity (>85%), exact year, and first author last name. Dry run by default โ use --apply to write. Only patches the DOI field; never touches other metadata. 1s delay between CrossRef requests (polite pool with mailto).
# Dry run โ show which PDFs are available and from where python3 zotero.py fetch-pdfs --dry-run --limit 10 # Fetch and attach as linked URLs (no storage quota used) python3 zotero.py fetch-pdfs --limit 20 # Also save PDFs locally python3 zotero.py fetch-pdfs --download-dir ./pdfs # Upload to Zotero storage instead of linked URL python3 zotero.py fetch-pdfs --upload --limit 10 # Only try specific sources python3 zotero.py fetch-pdfs --sources unpaywall,semanticscholar Tries three legal OA sources in order: Unpaywall โ Semantic Scholar โ DOI content negotiation. By default creates linked URL attachments (no Zotero storage quota needed). Use --upload for full S3 upload to Zotero storage. Use --download-dir to also save PDFs locally. Sources: unpaywall, semanticscholar, doi (default: all three) Rate limits: 1s between Unpaywall/Semantic Scholar requests, 2s between DOI requests.
python3 zotero.py --json items --limit 100 | jq '.items[].DOI' python3 zotero.py --json get ITEMKEY | jq '.title'
Zero dependencies โ Python 3 stdlib only (urllib, json, argparse) Write operations require an API key with write permissions If Zotero translation server is down (503), DOI lookups fall back to CrossRef Input validation: DOIs must be 10.xxxx/... format. Item keys are 8-char alphanumeric (e.g., VNPN6FHT). ISBNs must be valid checksums. check-pdfs fetches all items; for large libraries (500+), this may be slow fetch-pdfs also processes all items โ use --collection to scope for large libraries Rate limits are generous; batch-add includes 1s delay between items For common errors and troubleshooting, see references/troubleshooting.md
Code helpers, APIs, CLIs, browser automation, testing, and developer operations.
Largest current source with strong distribution and engagement signals.