A Zotero plugin that suggests which collections a paper belongs to.
Right-click a paper Ranked, confidence-scored collections |
One-time setup OpenAI, Anthropic, Gemini, or any compatible endpoint |
My Zotero library grew faster than I could file. Each new PDF meant a slow scroll through Collections to decide where it belongs, and half the time I just dumped it in the inbox and forgot. PaperRouter is the shortcut: right-click a paper, get a ranked shortlist of where it should go, one click to commit. It learns from what you reject so the next pass is smarter.
Right-click an item in Zotero, get a ranked list of collections with a confidence score next to each, pick the ones that fit. PaperRouter also remembers what you reject: blacklisted collections get penalised in future suggestions.
Works on Zotero 7, 8, and 9.
- Two ranking modes: embedding cosine similarity, or LLM zero-shot classification.
- Per-collection confidence score shown in the dialog.
- Feedback-aware: rejected collections are blacklisted and down-ranked next time.
- Hierarchy-aware: doesn't suggest a child collection when the parent is already a strong match.
- Keyword filter inside the dialog.
- Configurable cap (default 4 collections per item) and a confidence-threshold slider.
- Background embedding refresh on startup so the dialog opens fast.
- UI in English, 简体中文, 繁體中文, with auto-detect.
Two algorithms; you can use either or both:
- Embedding cosine similarity. Calls an embedding API, scores collections by vector angle, applies IDF weighting and a depth/specificity penalty.
- LLM zero-shot. Sends all collection names to an LLM in one prompt and parses the ranked output with confidence scores.
- Zotero 7.x – 9.x
- An API key for at least one provider:
- LLM: OpenAI, Anthropic (Claude), Gemini, OpenRouter, Cohere, or any OpenAI-compatible endpoint.
- Embedding: OpenAI, Cohere, or any OpenAI-compatible endpoint.
Both sides are independent. You can configure embedding only, LLM only, or both.
- Grab
paperrouter-*.xpifrom Releases, or usedist/paperrouter-0.2.0.xpifrom this repo. - Zotero → Tools → Add-ons → ⚙️ → Install Add-on From File…
- Pick the
.xpi, restart Zotero.
npm ci
npm test
./scripts/build-xpi.shOpen Edit → Settings → PaperRouter and configure at least one side:
- Embedding — pick a provider, paste an API key, pick or type a model, click Test.
- LLM — same flow.
Each provider's API key and model are saved independently, so switching providers won't overwrite anything you've already set.
- Right-click any item → Send to Collection…
- Or click the PaperRouter icon in the Zotero toolbar.
Inside the dialog:
- Pre-checked rows are the collections this item already belongs to (shown in bold).
- Drag the threshold slider to hide low-confidence suggestions.
- Click Retry to re-rank after blacklisting some, or OK to confirm.
What's next, roughly in order of likelihood:
- Auto-mode: when you add a new item to Zotero, route it automatically without opening the dialog (opt-in).
- Batch mode: run the router across N existing items at once, not just one at a time.
- Per-collection exclusions: mark a Collection as "never suggest" without blacklisting case-by-case.
No timeline promises. Track via Issues.