Plugins / Organising & tags

ZotRead

by cannolis · github.com/cannolis/ZotRead

Ranks unread papers by relevance to your own papers or a research idea, using an OpenAI-compatible LLM such as DeepSeek or a local Ollama.

ZotRead has a Zotero Plugins grade of B (use with care) because it keeps its own tables in Zotero's database, and 2 more findings. It works with Zotero 7–9, not the current Zotero 10. Last checked 15 Nov 2026.

View source
Downloads a .xpi file (0.2 MB). In Zotero, open Tools → Plugins and install it from the file.
In useAn estimate of how many copies of Zotero have it: Zotero downloads each new version once for every copy that has the plugin, so we count the downloads of its most-downloaded recent release. Rounded. Plugins that update from outside GitHub count low.
47
DownloadsAll-time downloads of its release files from GitHub, counting every update. Installs from elsewhere aren't counted.
403
Latest releaseDownloads of version 0.1.9, its latest release, since it came out on 10 May 2026. A new release starts from zero; Downloads counts every release.
35
ReleasesVersions published on GitHub. Everyone who has the plugin downloads each one again, which adds up in Downloads.
11
AgeTime since its GitHub repository was created, on 24 Apr 2026. The plugin can be younger than its repository.
7 months
StarsPeople who starred the repository on GitHub: a rough measure of interest.
3
ContributorsPeople who have committed code to this plugin. Bots don't count, nor do the authors of a template or project it was copied from.
1
LicenceThe licence the code is published under, as GitHub reports it.
AGPL-3.0
B
Zotero Plugins gradeUse with care
because it keeps its own tables in Zotero's database, and 2 more findings
Applies to v0.1.9, released 10 May 2026Code checked · tested installed in Zotero 9.0.6 on 27 Sep 2026
Doesn't work with the current Zotero (10)Works with Zotero 7, 8, 9.
What we found in the codeSets the gradeThe worst finding in these three areas sets the grade.
Code transparencyReadable code; not yet checked against the published sourceThe developer uploaded the release file from the cannolis account. We haven't yet checked whether this file matches the public source code.UnknownWe couldn't check this yet.
Updates
Updates come from this project's GitHub repositoryThe update address is broken (nothing is there), so Zotero can't update it
Where your data goesOnly contacts services we could identify4 addresses in 2 groups.LowLow concern: normal for plugins that do this job. Listed so you know.
AI services (2)
api.deepseek.comopenrouter.ainamed in its codeThe address is in its code, but we didn't trace a request to it. It may be a link or unused.
Scholarly services (2)
arxiv.orgnamed in its codeThe address is in its code, but we didn't trace a request to it. It may be a link or unused.export.arxiv.org
Where we found it
api.deepseek.comprefs.js · line 2
pref("extensions.zotero.zotread.llm.baseURL", "https://api.deepseek.com");
export.arxiv.orgcontent/scripts/zotread.js · line 1529
const url = `http://export.arxiv.org/api/query?id_list=${encodeURIComponent(cleanId)}`;
Powerful capabilitiesKeeps its own tables in Zotero's database, and 5 moreMediumMedium concern: worth reading before you install. One medium finding makes the grade B.
Medium concern (3)
Keeps its own tables in Zotero's databaseA zotero:// link (a web page can open one) can make it install add-ons without asking you (from zotero-plugin-toolkit)A zotero:// link can make it run code if you approve a prompt (from zotero-plugin-toolkit)
Low concern (3)
Stores API keys or passwordsWorks with files on your computerSends lookups unencrypted (http://) to export.arxiv.org
Where we found it
Keeps its own tables in Zotero's databasecontent/scripts/zotread.js · line 50

Tables: zotread_anchor, zotread_idea, zotread_override, zotread_similarity, zotread_status and 1 more

await Zotero.DB.queryAsync(
A zotero:// link (a web page can open one) can make it install add-o…content/scripts/zotread.js · line 2323

zotero://plugin. zotero-plugin-toolkit removed this link in version 6.0.0; this plugin is built with an older version

Services.io.getProtocolHandler("zotero").wrappedJSObject._extensions["zotero://plugin"] = pluginBridgeExtension;
A zotero:// link can make it run code if you approve a promptcontent/scripts/zotread.js · line 2279

zotero://ztoolkit-debug

Services.io.getProtocolHandler("zotero").wrappedJSObject._extensions["zotero://ztoolkit-debug"] = debugBridgeExtension;
Before you installShown, not gradedFacts to help you decide. They don't change the grade.
Works withZotero 7, 8, 9 · not 10Doesn't work with the current Zotero (10)MediumMedium concern: worth reading before you install. One medium finding makes the grade B.
Zotero 7 ✓ worksZotero 8 ✓ worksZotero 9 ✓ worksZotero 10 ✗ doesn't workZotero 11 beta not tested yet: Zotero hasn't opened Zotero 11 testing
What you'll needAn API keyDetected automatically from its code
No further detail for this area yet.
MaintenanceSlowing down · last release 10 May 20261 contributor
No further detail for this area yet.
LanguagesDocumentation in EnglishInterface: English and Chinese
No further detail for this area yet.
We report what we found in the code. Open any area for the evidence.How we gradeReport a problem

What it does

Written by AI from the README

Ranks unread papers by relevance to your own papers or a research idea, using an OpenAI-compatible LLM such as DeepSeek or a local Ollama. Adds a sortable Relevance column, a sidebar rationale and an auto-maintained top-papers collection.

A large pile of unread papers makes it hard to decide what to read next. This ranks the queue against your own work and explains each score.

What you'll need

Detected automatically
  • An API keyNeeds a key you get from the service (DeepSeek, OpenAI and OpenRouter). What needs it: An API key for the LLM provider (default DeepSeek); it can be a local Ollama endpoint instead.
  • Or: a model on your own computerIt can use a local model such as Ollama
  • Zotero 7, 8, 9Not working with Zotero 10

Where your data goes

We found: only contacts services we could identify. 4 addresses in 2 groups.

AI services (2)
api.deepseek.comopenrouter.ainamed in its code
Scholarly services (2)
arxiv.orgnamed in its codeexport.arxiv.org
Evidence · file and line
api.deepseek.comprefs.js · line 2
pref("extensions.zotero.zotread.llm.baseURL", "https://api.deepseek.com");
export.arxiv.orgcontent/scripts/zotread.js · line 1529
const url = `http://export.arxiv.org/api/query?id_list=${encodeURIComponent(cleanId)}`;

Forks and copies

No forks listed.

The developer's response

The developer hasn't responded. Developers can reply here, and their reply sits next to our findings.I'm the developer

Ratings and reviews

What people who use it say. This is separate from the grade, which is what the code does, and never changes it.

No ratings yet.

Write a review
Your rating of ZotRead v0.1.9

Your review is public, under the name you give, and published with the directory's data under CC BY 4.0. Links are removed. We never store your IP address: a scrambled code made from it is kept for 30 days to catch fake reviews. Every review is checked before it's published; how fake ones are spotted isn't published, so it can't be gamed.

Install ZotRead
BUse with care
Before you install: It keeps its own tables in Zotero's database, and 2 more findings.Read the finding
Compare with similar plugins