Zotero Med-Impact v0.4.17: Citation Metrics, Journal Quartiles, JCR/Scopus and SCImago CSV Support f

farukytkn

Hi everyone,

I would like to share **Zotero Med-Impact v0.4.17**, a Zotero 8+ add-on for enriching medical and biomedical literature records with citation counts, journal metrics, and quartile labels.

GitHub release:
https://github.com/digitalartificialint-cmd/Zotero-Med-Impact/releases/tag/zoteromedimpact-v0.4.17

Direct XPI download:
https://github.com/digitalartificialint-cmd/Zotero-Med-Impact/releases/download/zoteromedimpact-v0.4.17/zotero-med-impact-0.4.17.xpi

## What it does

Zotero Med-Impact can add bibliometric and journal-level metadata to selected Zotero items, including:

- DOI-based citation counts
- OpenAlex and Crossref metadata lookup
- Local SCImago/CSV-based quartile matching
- Optional Clarivate WoS/JCR API support
- Optional Elsevier Scopus API and InstToken support
- Zotero tags such as:
- `Citations: ...`
- `Quartile: Q1`
- `Metric Source: Local CSV`
- `JCR Impact Factor: ...`
- `Scopus CiteScore: ...`
- Custom item list columns:
- Quartile
- JCR IF
- JCR Q
- CiteScore
- Scopus Q
- SJR
- Impact / Metric
- Metric Source

## Main improvements since v0.3.14

Compared with **v0.3.14**, v0.4.17 has been reworked for Zotero 8+ and includes several important improvements:

- Improved Zotero 8 compatibility.
- A more stable item right-click context menu.
- Fixed duplicated context menu entries.
- Two right-click actions are now available:
- `Fetch Journal Metrics`
- `Apply Quartile`
- Better separation between full metric fetching and quick quartile application.
- Added Tools menu actions for API and CSV management.
- Added optional Clarivate WoS/JCR API support.
- Added optional Elsevier Scopus API support.
- Added optional Elsevier InstToken support for institutional Scopus access.
- Added API settings status and clear-settings commands.
- Added custom Zotero item-tree columns for metrics and quartile fields.
- Improved local CSV fallback behavior.
- Added a manual SCImago update workflow.
- Added Turkish and English UI labels.
- Updated packaging and release structure for the current Zotero 8 add-on workflow.

## Manual SCImago / CSV workflow

The add-on does **not** automatically download SCImago data.

Instead, it provides a manual workflow:

1. Open `Tools > Update SCImago Quartile`.
2. This opens the SCImago export page:
https://www.scimagojr.com/journalrank.php?out=xls
3. Download the file manually.
4. In Zotero, use `Tools > Select Quartile CSV File`.
5. Select the downloaded SCImago/CSV file.
6. Then use either:
- `Apply Quartile`
- `Fetch Journal Metrics`

The local CSV file should include an ISSN column and a quartile column. Supported column names include examples such as `issn`, `e-issn`, `best quartile`, and `quartile`.

## API sources

Clarivate WoS/JCR:
https://developer.clarivate.com/

Elsevier Scopus:
https://dev.elsevier.com/

OpenAlex:
https://developers.openalex.org/

Crossref REST API:
https://www.crossref.org/documentation/retrieve-metadata/rest-api/

API access depends on each provider’s licensing, subscription, and usage policies.

## Installation

1. Download `zotero-med-impact-0.4.17.xpi` from the release page.
2. Open Zotero 8.
3. Go to `Tools > Add-ons`.
4. Use the gear menu and choose `Install Add-on From File...`.
5. Select the XPI file.
6. Restart Zotero if prompted.

## Notes

- This add-on targets Zotero 8+.
- API keys and the local CSV path are stored locally in Zotero preferences.
- The project is not affiliated with Zotero, Clarivate, Elsevier, OpenAlex, Crossref, or SCImago.
- Feedback, bug reports, and feature requests are welcome via GitHub Issues:
https://github.com/digitalartificialint-cmd/Zotero-Med-Impact/issues