zotero-paper-import

name	zotero-paper-import
description	Download PDFs from Zotero by citation key, cut references, and prepare for Swanki.

When the user asks to import papers from Zotero, follow this workflow:

Input

The user provides one or more citation keys as arguments, e.g.:

• /zotero-paper-import montanolopezPhysiologicalLimitationsOpportunities2022
• /zotero-paper-import key1 key2 key3

Procedure

Step 1: Run the import script

/Users/michaelvolk/miniconda3/bin/python scripts/zotero_paper_import.py <key1> [key2 ...]

This single command handles everything per key:

1. Connects to Zotero and downloads PDFs into ../Swanki_Data/{key}/
2. Detects reference pages via PyPDF2 text extraction
3. Cuts references with swanki-cut, creates _clean.pdf via pdfunite
4. Writes the .sh runner script

Use --download-only to skip the cleaning step if needed.

Step 2: Handle failures

If references are NOT auto-detected for a paper (script reports "No references heading detected, keeping all pages"), manually inspect the PDF and re-run the cut using /clean-pdf {key}.

Step 3: Report summary

After all keys are processed, report:

• Which keys were successfully imported
• Pages kept vs removed per paper
• Any papers where references were not detected