jcr-if-extract
Skill4 starsChanged 3 months agoMITView on GitHub
Extract Journal Impact Factor (IF) data from Clarivate JCR for a list of journals, build a multi-year IF database, plot long-run IF trends, and generate a single-file HTML report with year-over-year movers. Use this skill whenever the user wants JCR Impact Factors, "this year's IF", "new JCR came out", "올해 IF 나왔다", "JCR IF 추출/정리", journal impact factor tables, IF trend plots, or to add a newly released JCR year to an existing IF analysis. The fetch step needs a short-lived session token (X-1P-INC-SID) the user copies from their browser on an institution network; this skill explains exactly how to grab it. Also trigger for "compare IF across years", "which journals' IF jumped/dropped", or "rank journals by impact factor".
- Installs packages
In this repository12 other files it gives its agents.
- CLAUDE.mdCLAUDE.md
- qr-codeSkill
- snu-etl-video-downloaderSkill
- snu-tennis-reserveSkill
- whisper-transcribeSkill
- paper-figure-pptxSkill
- paper-readingSkill
- pptx-formatterSkill
- pptx-to-pdfSkill
- pre-proofSkill
- scientific-paper-coachSkill
- structure-visualizerSkill
The file
We split this skill into the rules it gives an agent
1 rule. About 0 are common, 0 are distinctive, and 1 is very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈0
Distinctive · estimate
This author's own choices. Worth a look.
1
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Very specific: line 107
All scripts take --journals and --db paths if you keep files somewhere other than the cwd.
≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
JCR Impact Factor Extractor
Fetch Journal Impact Factors from Clarivate JCR for a curated journal list, accumulate them into a year-keyed database, and turn that into a trend plot and an HTML report. JCR has no public API, so the fetch reuses the website's own internal endpoint with a session token the user supplies.
When to use
- User says a new JCR / IF came out and wants it pulled or added to their analysis
- User wants an IF table for a set of journals, an IF trend plot, or an IF report
- User wants year-over-year IF comparison (which journals jumped or dropped)
The pipeline
target_journals.json ──> fetch_jcr_if.py <SID> --year YYYY ──> jcr_if_YYYY.json (detailed)
└──> jcr_if_database.json (append)
jcr_if_database.json ──> plot_if_trend.py ──────────────────> if_trend.png
jcr_if_YYYY.json + db ─> build_report.py --year YYYY ───────> jcr_YYYY_report.htmlThree steps, run in order. Step 1 needs the token; steps 2-3 are offline.
Step 0 — first-run setup (do once)
- Dependencies:
requests,matplotlib(e.g.pip install requests matplotlib). - Journal list: copy
assets/target_journals.example.jsonto a working filetarget_journals.jsonand edit it to the journals the user cares about. Each entry is:
The{"abbr": "Nat. Catal.", "full": "Nature Catalysis", "issn": "2520-1158", "jcr_abbr": "NAT CATAL"}jcr_abbrfield must be the exact abbreviated name JCR uses (all caps, e.g.ANGEW CHEM INT EDIT,P NATL ACAD SCI USA). If unsure, search the journal on jcr.clarivate.com and read the abbreviated title off the journal profile. A wrongjcr_abbrjust shows up as "NOT FOUND" in the fetch summary — fix it and re-run.
Step 1 — get the session token (X-1P-INC-SID)
This is the only manual part, and the easy place to go wrong. The token authorizes one browser session on jcr.clarivate.com and expires fairly quickly, so grab it right before fetching.
- On an institution network (your library subscription), open https://jcr.clarivate.com and make sure you're logged in / have access.
- Open dev tools (F12) → Network tab. Set the filter to Fetch/XHR.
- In the filter box type
search-result, then do a journal search / apply a category filter on the page so a request fires. - Click the request whose name is
search-result— confirm it is:- host (
:authority) =jcr.clarivate.com(NOTsnowplow-...clarivate.net) - method =
POST(NOTGET) - path =
/api/jcr3/bwjournal/v1/search-result
- host (
- In Headers → Request Headers, find
x-1p-inc-sidand copy its value.
Common traps (all produce 401 Unauthorized):
- Copying from a snowplow / analytics request (
*.clarivate.net, method GET) — wrong host, no token there. - Copying
correlation-idinstead ofx-1p-inc-sid— different header, not a session token. - A stale token from a previous session — just re-copy a fresh one.
Then fetch:
python scripts/fetch_jcr_if.py "<SID>" --year 2025The token is passed as an argument only and is never written to disk. Re-run with a different
--year to backfill historical years into the same database.
Step 2 — plot the trend
python scripts/plot_if_trend.py --out if_trend.pngReads the year range straight from the database, so it never needs editing when a new year is
added. Journals whose IF moved by --threshold (default 10) over the covered span are
highlighted and labelled; everything else is light gray context.
Step 3 — build the HTML report
python scripts/build_report.py --year 2025 --plot if_trend.pngProduces a portable single-file jcr_2025_report.html: headline numbers, top year-over-year
gainers/losers vs the previous year, the embedded trend plot, and per-category IF tables.
Pass --author "Name" to add a byline.
Notes for whoever runs this
- The JIF lives in a field named
jif2019in the JCR response — that is just Clarivate's internal field name and holds the headline IF for whateverjcrYearyou requested. Don't "fix" it to match the year. - Never hard-code the latest year. The whole point of reading years from the data is that these scripts don't rot each June when a new JCR drops. If you add logic, keep it data-driven.
- A journal showing up under "NOT FOUND" almost always means its
jcr_abbris slightly off, not that JCR lacks the data. - All scripts take
--journalsand--dbpaths if you keep files somewhere other than the cwd.
Files
jcr-if-extract/
├── SKILL.md
├── scripts/
│ ├── fetch_jcr_if.py # fetch one JCR year -> detailed JSON + append to database
│ ├── plot_if_trend.py # long-run trend plot (dynamic year range)
│ └── build_report.py # single-file HTML report with YoY movers
└── assets/
└── target_journals.example.json # 72-journal starter list (catalysis/energy/materials/comp)Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

